[mikeholler]

I think this is a bikeshedding criticism more than something that requires serious concern. Asciidoctor simply supports more out-of-the-box and officially than reStructuredText. Preferring reStructuredText to Asciidoctor this way is like comparing Python to Ruby for syntax alone. Function is just as important.

In Asciidoctor, I can:

* Use GraphViz (and other diagram) docs to describe architectural components.

* Actually test my example code, using named, delineating comments in my test suite and including the code between those comments as an example in my file.

* Support for WARNING, NOTE, etc. callout "admonitions"

* Auto-numbered list blocks with "."

Some of these may be possible with reStructuredText, and can definitely be supported with third party plugins, but all of this is first-party and amazing.

Note: IntelliJ's Asciidoctor plugin is incredible and it live renders mathematical equations AND graphing support in addition to everything else.

[cyberbanjo]

Sounds like org-mode. All hail Emacsen.