I was a big Markdown fan. I think what finally broke me out was list formatting of mixed types, differences in formats across my repo servers, TOC generation software I was using broke, and no good editors suitable for my tastes for asciidoc that are available on BSD or Alpine Linux.
However, I found out that gedit natively supports adoc and even colors the admonitions. Excellent!
All the guides seem to be too skimpy, not robust enough, or out of order. I like to create as I read.
Comes with the adoc used to generate the guide and a PDF version.
Recommends editors with native asiidoc support.
Gives a comprehensive header "template".
Enables experimental features, admonition icons, and code highlighting.
Shows the best read/write table syntax missing from the official guide.
Corrects two errors in the official guide.
Did you know Asciidoc has a counter increment function?
Although it gives a warning saying not to use if possible, I found it works well for simple tasks.