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

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.