[andix]

Markdown may be less precise from a technical perspective. But it is easier to use for most people and just good enough.

AsciiDoctor is a great framework for writing documentation and manuals. And there is also markdown support, so you can reuse/embed your existing documenentation.