On: ReStructuredText vs. Markdown for documentation

[zzleeper]

(Shameless plug) If you want to extend markdown, consider this: http://scorreia.com/software/panflute/

It's a Python package that allows you to extend markdown through pandoc filters. It allows you to easily manipulate the AST created by Pandoc to add any number of features.

For instance, I wrote my dissertation in Markdown , and used this to include algorithms, CSV tables, include directives, etc.