Markdown is easy to use for most things, except wide tables, as rows cannot be broken across lines.
Asciidoc allows table rows to be split across lines, for example: https://github.com/apache/commons-parent/blob/master/COMPONENTS.adoc?plain=1 Compare that with the previous MD version: https://github.com/apache/commons-parent/blob/997a7bd3e045ad1651ec4ac9788a66dc3f1b751e/COMPONENTS.md?plain=1 AFAICT it should be easy enough to enable asciidoc. Sebb