Eu tenho usado o Asciidoc desde que o descobri e o uso muito para ser meu arquivo de texto LEIAME. É legível em texto e pode produzir todos os tipos de outros formatos, como man pages, pdf, html, etc.
Ultimamente tenho visto mais e mais projetos FLOSS usando markdown. É liso, tanto quanto eu posso dizer, mas ainda se sente muito mais limitado do que Asciidoc. Até o github parece apoiar o .md melhor que o asciidoc. Estou esquecendo de algo? Existe uma razão para tantas pessoas usarem o .md?
Eu acho que a portabilidade do asciidoc e um arquivo de texto para vinculá-los a torna muito mais poderosa.
Se alguém tiver algum insight, ou puder dizer por que o markdown (MD) é tão incrível, vou comprar uma cerveja virtual para você.
O Markdown tem a desvantagem de que, se você quiser algo mais complicado, está sem sorte ou na sintaxe específica da implementação, que pode não se encaixar bem, enquanto o Asciidoc pode aumentar de escala.
Há um post de g + de Dan Allen comparando-os e preferindo o Asciidoc .
O Markdown é uma TENDÊNCIA. Não há razão para mudar para a marcação se estiver satisfeito e confortável com o asciidoc. O Markdown é fragmentado e bastante limitado em comparação com outras linguagens de marcação, como asciidoc, txt2tags ou reStructuredText.