AsciiDoc is a markup language that allows the creation of text documents for writing notes, documentation, articles, books, E-books, slideshows, web pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page using an assortment of open-source tools as the format specification was designed to produce the ubiquitous DocBookXML as its primary output..
Ranked in these QuestionsQuestion Ranking
Pro Technical Documentation
The DocBook format which Asciidoctor can convert to was originally developed with the creation of computer books in mind and thus has a rich array of formatting options which are powerful enough to manage the formatting of lengthy technical books.
Pro Supported by GitHub
GitHub supports AsciiDoc syntax in repositories, wikis and gists (powered by Asciidoctor).
Pro Standardized format
The formatting of Asciidoc is standardized so there is only one 'flavor' unlike in Markdown. The definitive user guide is here: http://asciidoctor.org/docs/asciidoc-writers-guide/
Simple, easy-to-read style similar to Markdown. Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Pro It's structured
Cleanly transforms to DocBook and HTML5.
Pro Supports semantic markup
Pro Shorter, more concise than Markdown
Con Not as popular/widely used as Markdown
The Asciidoc format is not as popular/widely used as Markdown. Notwithstanding the foregoing, Asciidoc is used for some of the following projects:
- O'Reilly and Maker Press
- NFJS, the magazine
- other examples: http://asciidoctor.org/docs/what-is-asciidoc/#who-s-using-asciidoc
Con Limited output options
Asciidoctor can only convert directly to HTML or DocBook. However, you can always use another converter such as pandoc to convert from one of the output formats to another format.