AsciiDoc is a human-readable document format, semantically equivalent to DocBookXML, but using plain-text mark-up conventions. AsciiDoc documents can be created using any text editor and read “as-is”, or rendered to HTML or any other format supported by a DocBook tool-chain, i.e. PDF, TeX, Unixmanpages, e-books, slide presentations, etc.
AsciiDoc was created in 2002 by Stuart Rackham who published tools (‘asciidoc’ and ‘a2x’), written in the Python programming language to convert plain-text, ‘human readable’ files to commonly used published document formats.
A Ruby implementation called ‘Asciidoctor’, released in 2013, is in use by GitHub and also provides a gateway to Asciidoc use in the Java ecosystem.
The following shows text using AsciiDoc mark-up, and a rendering similar to that produced by an AsciiDoc processor:
Asciidoc source text
= My Article
http://wikipedia.org[Wikipedia] is an
on-line encyclopaedia, available in
English and many other languages.
You can install 'package-name' using
the +gem+ command:
gem install package-name
Metals commonly used include:
Wikipedia is an on-line encyclopaedia, available in English and many other languages.
You can install package-name using the gem command: