When comparing Hyper-Text Markup Language (HTML) vs Asciidoctor, the Slant community recommends Hyper-Text Markup Language (HTML) for most people. In the question“What are the best markup languages?” Hyper-Text Markup Language (HTML) is ranked 3rd while Asciidoctor is ranked 8th.
Ranked in these QuestionsQuestion Ranking
Pro Most universal and widely used markup language
Pro Styling via CSS
Styling through CSS is declarative and powerful, but somewhat inadequate for print without expensive tools like Prince.
Pro Natively understood by browsers
Natively understood by browsers, you can author and view HTML on virtually every computer without any additional software.
HTML is fairly simple for both humans and machines. It can be repetitive and burdensome to type, but less so than most other XML or SGML-derived formats.
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/
Pro Supported by GitHub
GitHub supports AsciiDoc syntax in repositories, wikis and gists (powered by Asciidoctor).
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 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.
Tags can hide actual content.
Con Relies on Ruby Gem
Requires installation of the asciidoctor Ruby gem.
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.