4 ms·
Markdown and reStructuredText are very limited, and the latter is awkward and unfriendly. Use AsciiDoc. It scales up to entire books. It's extendable by design
by eeZah7Ux 7y ago
Markdown and reStructuredText are very limited, and the latter is awkward and unfriendly.
Use AsciiDoc. It scales up to entire books. It's extendable by design.
It supports embedding diagrams, maths & so on.
- kevin_thibedeau 7y agoReST has essentially a 1:1 mapping to DocBook. You can export its internal DOM as an XML file and XSLT it straight into DocBook. I wouldn't exactly call it limited. It is also the only plaintext markup with a standardized extension mechanism when it doesn't do what you need.