RST/Sphinx solves that problem in that there is a single canonical dialect, and ... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		MyOutfitIsVague 5 months ago \| parent \| context \| favorite \| on: Man pages are great, man readers are the problem 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 4 months ago [–]

Another big plus in my book is that rST has a much more well defined model for extensions than Markdown.

westurner 4 months 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?

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact