My favorite text based markup language is asciidoc [1] because I think it has the best looking source text syntax [2]. The goal is to make it completely readabl

My favorite text based markup language is asciidoc [1] because I think it has the best looking source text syntax [2]. The goal is to make it completely readable in plaintext and not super markup-y. If someone were to "less README.asciidoc" they should not even notice that it's markup--it's just a nicely formatted text file. That said, it's really only made for documentation and is based on the Docbook XML toolchain which makes it an absolute bear to use. And like all of these text-y markup languages, it has corner cases that don't work well. [1] http://asciidoc.org/ http://asciidoc.org/ [2] http://asciidoc.org/index.txt http://asciidoc.org/index.txt