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).

Reference

Extension

Recommended extension on GitHub is .asciidoc, .adoc or simply .asc.

Tips

Use Icons

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

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