Is there a document spec out there that is more feature-full than Markdown, but isn't Latex?
Is it even possible to create such a spec and not end up re-creating Latex?
Is it even possible to create such a spec and not end up re-creating Latex?
reStructuredText has strong official support for extensions, including regular syntaxes in the language for using extension points consistently. That power alone makes it suitable for a lot of domain-specific documents, which is why IMNSHO a lot of the better software documentation is in reStructuredText rather than Markdown.
[1] Don't forget that for Markdown the only "official" spec for that name is a blog post and a Perl script. CommonMark is very well specified now, but is A) surprisingly quite recent despite the proliferation of Markdown usage, and B) technically a forked specification and "not official" and not allowed to use the name "Markdown" by the original author/developer.
But when I'm including code in a doc I much rather prefer rsT, because I can specify the code type so the syntax highlighter doesn't have to guess about the language.
This is the one I used for years, I believe:
https://www.vim.org/scripts/script.php?script_id=973
Looks like several people recommend this script: