The author is missing the difference with markdown, which seems to be the main blocker here. But Asciidoc is more like markdown + extras. It's (optionally) back

The author is missing the difference with markdown, which seems to be the main blocker here. But Asciidoc is more like markdown + extras. It's (optionally) backward compatible with markdown, so unless you use those extra features, it's unlikely that an average person will distinguish the difference. So you can continue to write markdown as usual, only add extra stuff when you learn it. The minor difference is things like how you embed images, and so on. _For me_, the main feature of the Asciidoc is the syntax for tables. Tables are important for good documentation, but with markdown it's really hard to write with tables, it makes a document a total mess and ruins the whole idea.