When comparing AsciiDoc vs LaTeX, the Slant community recommends AsciiDoc for most people. In the question“What are the best markup languages?” AsciiDoc is ranked 4th while LaTeX is ranked 6th. The most important reason people chose AsciiDoc is:
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/).
Specs
Ranked in these QuestionsQuestion Ranking
Pros
Pro Standardized format
The formatting of Asciidoc is standardized so there is only one 'flavor' unlike in Markdown. The definitive user guide is here.
Pro Human-readable
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.
Pro Supported by GitHub and GitLab
Both GitHub and GitLab support AsciiDoc syntax in repositories, wikis and Gists/Snippets (powered by the Asciidoctor Ruby gem).
Pro It's structured
Cleanly transforms to DocBook and HTML5.
Pro Supports semantic markup
Pro Native support for colored output
AsciiDoc has offered the ability to define both the color of any text output as well as its background, almost since its inception. It accepts several standard chromatic notations for them, too, including hexadecimal and decimal RGB values, decimal HSL and named CSS.
Pro Embedded metadata
The AsciiDoc standard defines a number of metadata values which can be defined inside a document primarily for contextual purposes that aren't rendered in its standard output such as author, date, license, document title and version, etc. These can be especially useful when searching through a large number of files/documents or documenting the evolution of one as part of a larger codebase.
Pro Shorter, more concise than Markdown
Pro Good tool support
There are plugins to support editing AsciiDoc for many editors/IDEs.
Pro Lets you focus on the content
LaTeX handles the design so you can focus on the content
Pro High-quality typesetting by default
There's a reason that scholarly journals often require the use of LaTeX for articles printed in their pages, and it's because the quality of the output is that good. Universities often require, or at least encourage, the use of LaTeX for graduate theses and dissertations for this same reason.
Pro Free open source software
Licensed under the LaTeX Project Public License
Pro Editor-independent
You can edit LaTeX sources in any text editor.
Pro Cross-platform
Works on every major OS and gives exactly the same quality output everywhere you go. LaTeX on macOS, Windows, Linux, BSD, and even Mac OS 9 has exactly the same output for a given set of sources.
Pro Effortless math input
The whole reason that TeX -- and, by extension, LaTeX -- exists is to give people an easy way (well, for some value of "easy") to produce high-quality documents with properly laid out mathematical expressions and text in them. As long as you know the language (or have a reference sheet handy), you can include mathematical expressions in your document with little to no extra effort needed on your part.
Cons
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
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.
Con Steep learning curve
LaTeX is not what you'd consider easy to use, and while there's plenty of documentation out there, much of it is rather opaque unless you're a seasoned TeXnician.
Con Single-threaded design
LaTeX is single-threaded by design, since it must necessarily work sequentially to produce each page as it is laid out by the typesetting engine. This makes it dependent on the power of just one individual core in your multi-core computer setup and so migrating to a machine with more cores won't necessarily make your LaTeX documents build faster.
Con Not a what-you-see-is-what-you-get editor
LaTeX uses the paradigm what-you-see-is-what-you-mean instead.