From: Alex Chaffee Date: 2011-08-08T07:03:53+09:00 Subject: Re: Help out with the next version of ruby-lang.org This sounds great. I've been using Markdown as a source file format for all my static content [1] and it's been a joy, especially in combination with Showoff for slides and Erector for web pages. But Markdown isn't perfect. There are several gaps and ambiguities in the language, and often you have to insert raw HTML, which sucks. At the suggestion of some colleagues at an open source teaching company [2] I've been looking into using AsciiDoc instead. Before you get too far into your porting process you should probably evaluate it as an alternative to Markdown. In addition to the richer and saner syntax, one thing AsciiDoc has over Markdown is that there seem to be more professional publishing companies that use it (e.g. O'Reilly) so there's a good tool chain for converting AsciiDoc into DocBook, PDF, etc. To be clear, this isn't a full-throated endorsement, but I'm strongly considering making the leap and I'd love to hear your opinions and experiences, and share mine.  - Alex [1] my teaching projects, mostly in markdown    https://github.com/alexch/ruby_notes    https://github.com/alexch/workshop    https://github.com/ultrasaurus/test-first-teaching [2] Marakana does corporate training and makes all their materials available open source in a variety of formats; they mostly use AsciiDoc for source files. http://marakana.com -- Alex Chaffee - alex@stinky.com - http://alexch.github.com Stalk me: http://friendfeed.com/alexch | http://twitter.com/alexch | http://alexch.tumblr.com