sinatra/sinatra — pull request #595 by burningTyger (2012-12-15 14:24:01+00:00)
Title: Readme rdoc to markup conversion

*Note: This is not a final PR*

I have converted the README.rdoc to Markdown via rdoc:

require 'rdoc'
require 'rdoc/markup'

h = RDoc::Markup::ToMarkdown.new
file = File.read "README.rdoc"
out = h.convert(file)

File.open(README.md, 'w') { |file| file.write(out) }

So this is a rather simple conversion path but it has a couple of issues:

* easy so solve: Links are output as `{DSL}[http://en.wikipedia.org/wiki/Domain-specific_language]`
* definitions don't exist in Markdown
* tables don't exist in Markdown

The links can easy be fixed by hand (filed a bug report at rdoc), the latter two need to be resolved with an alternative style. Any ideas?