Eu uso o Asciidoc desde que o descobri e o uso muito para ser meu arquivo de texto README. É legível em texto e pode gerar todos os tipos de outros formatos, como páginas de manual, pdf, html, etc.
Ultimamente, tenho visto mais e mais projetos de software livre usando remarcações. É liso até onde eu sei, mas ainda parece muito mais limitado que o Asciidoc. Até o github parece suportar .md melhor que o asciidoc. Estou esquecendo de algo? Existe uma razão para tantas pessoas estarem usando .md?
Eu acho que a portabilidade do asciidoc e um arquivo de texto para vinculá-los todos o tornam muito mais poderoso.
Se alguém tiver alguma ideia ou puder me dizer por que a remarcação (MD) é tão incrível, comprarei uma cerveja virtual para você.
documentation
markdown
asciidoc
csgeek
fonte
fonte
Respostas:
O markdown tem alguma massa crítica e a gramática é menor que a do Asciidoc.
O Markdown tem a desvantagem de que, se você deseja algo mais complicado, está sem sorte ou em uma sintaxe específica da implementação que pode não se encaixar bem, enquanto o Asciidoc pode aumentar.
Há um post do G + por Dan Allen comparando-os e preferindo o Asciidoc .
fonte
Markdown é uma tendência. Não há razão para mudar para a remarcação se você 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.
fonte