Oh, please let this project be successful. The worst thing about writing a man page is the troff syntax that mandoc uses. On *BSD, there’s now a custom renderer for only the mandoc syntax, rather than a full troff implementation (such as groff), which is a lot smaller and faster. That helps with the rendering path, but not the authoring bit.
To give a concrete example, this is a man page that I’ve written, without any rendering. It is not human readable, for any reasonable definition of ‘human’. I would love to have something that would either render Markdown pages natively in man, or would translate Markdown to mdoc so humans never have to write mdoc again.
Amen. When I was a younger man, I thought troff was cool because I could make cool looking documentation while retaining some interesting (to me) properties:
Much time passed…
markdown, IMHO, is a legit contender to replace *roff in the context of man pages (which I still refer to all the time)
So yes. Chapeau. I hope to see more of this kind of work.
See ddevault’s scdoc.