Asciidoc

Links

Reference

• Powerman's Asciidoc Cheat sheet
• Hyperpolyglot - Markdown, reStructuredText, AsciiDoc, Mediawiki, Org-mode

Review

• Why You Shouldn’t Use “Markdown” for Documentation

This author advocates instead AsciiDoc (using Asciidoctor), or reStructuredText (using Sphinx).

Tips

Use Icons

By default, asciidoc does not use icons. To enable them:

asciidoc -a icons -a iconsdir=/etc/asciidoc/images/icons file.txt