I've started using asciidoc[0] and find it much more friendly because it is both better specified and flexible.

[0]: https://asciidoc.org/