[0mp]

FreeBSD has recently switched from DocBook to AsciiDoc for its documentation: https://docs.freebsd.org/en/books/fdp-primer/asciidoctor-pri...

Markdown was also an option but it was missing too many features for a documentation set of this size.

[Tomte]

That's actually a likely switch, since AsciiDoc was specifically designed to optimally support Docbook features. So that switch should be painless.