I think org-mode is better than markdown, and both are better than asciidoc for manpages, Readme and other documentation I'll read on Vi or in a terminal. For

I think org-mode is better than markdown, and both are better than asciidoc for manpages, Readme and other documentation I'll read on Vi or in a terminal. For the 'real' documentation, asciidoc (with include, I think not every implementation make the work) is generally the best. Because of includes especially, that the salient point makes asciidoc better than Latex (that I prefer generally for everything else).