3 ms·

RST/Sphinx solves that problem in that there is a single canonical dialect, and it's already effectively used in many very large projects, including the Linux k

RST/Sphinx solves that problem in that there is a single canonical dialect, and it's already effectively used in many very large projects, including the Linux kernel and (obviously) the Python programming language.

arnsholt 2y ago
Another big plus in my book is that rST has a much more well defined model for extensions than Markdown.
- westurner 2y ago
  MyST Markdown has syntax for docutils roles and directives. Does the sphinx-build groff manpage builder also build from markdown, which sphinx also supports?