4 ms·
"AsciiDoc is a human-readable document format, semantically equivalent to DocBook XML, but using plain-text markup conventions." And Asciidoctor is a toolchain
by emmanueloga_ 8y ago
"AsciiDoc is a human-readable document format, semantically equivalent to DocBook XML, but using plain-text markup conventions."
And Asciidoctor is a toolchain for working with AsciiDoc.
One thing to have in mind is that AsciiDoc syntax is incredibly complex [1]: it maps to the already complicated-on-its-own-right DocBook standard [2]. It has a lot of bells and whistles that one may want to use on a real print book, but maybe not for general documentation.
I feel like if you are not writing something that you actually intend to print, Asciidoc (and DocBook) are overkill.
1: http://asciidoc.org/userguide.html http://asciidoc.org/userguide.html
2: https://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-v5.1-os.html https://docs.oasis-open.org/docbook/docbook/v5.1/os/docbook-...