I personally prefer Asciidoc(tor). The syntax for the basic stuff (headings, source code, links) is at least as easy as for markdown, but it also allows more ad

I personally prefer Asciidoc(tor). The syntax for the basic stuff (headings, source code, links) is at least as easy as for markdown, but it also allows more advanced cases (tables, splitting into files, text substitutions, etc.) without resorting to writing html or using external tools. Asciidoctor also directly supports the markdown style for headings, block quotes, etc. I see markdown more for writing a quick note or something that will not exceed a few pages.