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.
Enjoy.
https://www.quadhelion.engineering/guides/AsciiDocCheatSheet.html
darkmatternoodlecow@programming.devEnglish5·8 months ago