lit.rb

#!/usr/bin/env ruby

=begin lit
# Introducing Lit

Lit allows developers to embed Markdown in their comments, and extracts
it for them to produce human friendly documentation.
=end

require 'rubygems'
require 'rdiscount'

=begin lit
Lit comments begin with =begin lit
=end
BEGIN_LIT = /=begin lit/

=begin lit
and end with \=end
=end
END_LIT   = /=end/

SKIP = /=(begin|end)/
          
path = ARGV[0]
src = File.open(path)
doc = []
while src.gets
  if ($_ =~ BEGIN_LIT) .. ($_ =~ END_LIT)
    doc << $_ unless $_ =~ SKIP
  end
end
mkd = RDiscount.new(doc * "\n")
puts mkd.to_html