Markup Pros and Cons

Markdown

+ Simplicity, popularity, good w/ tech docs: simple escape ‘\’, backticks for `code`
+ Widely used:
- Too simple, no tables, no spec
- Many implementations, all slightly different
- Many filename extensions: .md, .mdwn, .markdown

Origin: John Gruber, Perl script, Daring Fireball
Users: Reddit, StackOverflow, GitHub, …

Textile

+ Quite rich: tables w/ th, superscipt, subscript, quotes, etc.
+ Great HTML integration
- Line break decision, NO!!
- No spec
- Long filename extension! .textile, txtl?

Origin: PHP code, TextPattern
Users: Redmine
Associated with: Ruby, RedCloth

RestructuredText

+ Tables, more aspects
+ Part of DocUtils
+ Has full spec
- A bit cumbersome?
- Silly capitalization of name: reST!?

Origin: DocUtils
Users: Python docs, Sphinx

AsciiDoc

+ Richest: suitable for techincal book authoring, e.g. Git’s User Manual
- Obscure

MediaWiki

+ Most widely used
- Really god-awful

Creole

+ Many good decisions
- Odd support for code blocks: {{{fname}}}!?

Trac

+ Good & broad markup
- Only Trac uses it

DokuWiki

+ Good markup
- Only DW uses it

© 2014 FastnLight, LLC