mogztter

The AsciiDoc Working Group has been formed to write a complete and comprehensive specification: https://asciidoc-wg.eclipse.org/

If you are interested in an AsciiDoc processor in Haskell, you can read: https://www.tweag.io/blog/2021-06-15-asciidoc-haskell-pandoc...

We had Guillem Marpons at the last AsciiDoc WG meeting and he was willing to work toward a spec-compliant implementation and help us with the spec.

You can click the "Edit this page" button and submit an improvement.

Having said that, the fact remains that you don't have a standard syntax to add an id on a section title (without using HTML directly).

Jekyll might does the right thing but Jekyll is not Markdown. Does it work elsewhere? If not then your document is not really portable.

You only need to use backtic and plus when you want to disable text substitutions (a concept that does not exist in Markdown).

Most of the time, using backtic is enough: `text`.

Thanks for sharing this blog post. Svgbob is doing a pretty good job at converting those diagrams:

https://demo.kroki.io/svgbob/svg/eNrFlEtvgkAQx-_9FBNPGqJiHxc...

That's true but Kroki is not limited to GraphViz. We support more than a dozen diagram libraries: https://kroki.io/#support

It's planned! I'm the lead developer of Asciidoctor.js so it's definitely one of my goal to make Kroki available as an Asciidoctor extension :)