AsciiDoc

“complex markup constructs, like conditionals and transcludes, that cross blades with natural language”

“solves a lot of problems Markdown created, but it's got its own problems”

“Very neat when you have a block diagram you want to reuse for lots of different configurations.”

“Asciidoc is a nice middle ground between the full suit of tools you get in Orgmode and bare Markdown.”

“converts every bit as badly as DITA”

“AsciiDoc has more serious design problems than reStructuredText. And without doubt it's uglier.”

“Definitely a step up from RST but it does have syntax weirdnesses”

“It's one of the neat features of the AsciiDoc language.”

“But Asciidoc has unneccessary complexity and ambiguity, and the results are often surprising.”

“I've been a very vocal advocate of Asciidoc as replacement for thick granular XML-based CCS specifications”

“sweet spot of features and readability for me. Really wish it had more tooling.”

“Alternatives like Asciidoc make much more sense IMHO.”

“reStructuredText & AsciiDoc are so, so much better than Markdown”

“It supports the richness of Docbook XML but has fewer quirks than rST in my eyes.”

“it's harder to find something else than asciidoctor to render it”

“any other better-defined languages with a cheat sheet like [1]”

“It's quite noisy. I'd prefer if it supported indentation.”

“My experience is that Asciidoc very quickly gets into advanced syntax.”

“It starts simple but can be used to do whole books if needed.”

“There are other solutions which are as easy to read/write (if not more) and which are defined much better”

“Write actual books in it. Not really more complex than Markdown”

“it's formally defined and comes with a Technology Compatiblity Kit (TCK)”

“it has the same features as all the other Markdown flavors combined”

“it's well-documented and offers a strong, technically structured syntax”

“are a part of reStructuredText & AsciiDoc for instance”

“when you fall off the happy path, AsciiDoc is awful”

“AsciiDoc and RST/Sphinx are definitely more powerful for structured documentation with cross-references, includes, and admonitions.”

“are much better suited to build software documentation with cross-references”

“AsciiDoc(tor) has a nice support for tables. It also supports more complex features like merged cells, span cols”

“Both ASCIIdoc and reStructured text are older and better”

“ASCIIDoc which is a better format, has a standard, and is literally used by the git documentation itself”

“you get a tremendous amount more styling and functionality”

“It simply doesn't offer nearly enough potential advantages to be worth the hassle.”

“AsciiDoc gives you what you need as a base to automate typesetting basically everthing”

“Most of the formats came out satisfactory, but there were some gotchas.”

“feeling like a markdown-ish alternative that's just a bit different for no clear reason”

“AsciiDoc is much better than Markdown for docs intended for humans that are more than short”

“I found myself struggling to control the output.”

“AsciiDoc just provides so much out of the box”

“I'd recommend AsciiDoc[0] over any Markup flavor for a greenfield project _today_.”