Pandoc is a fairly popular package that can convert between md and man page formats (many other formats also).
Perl's POD is also a pretty natural starting point that generates md and man pages from a reasonable source format.
That's not what I was asking, actually. I meant rendering markdown directly on a terminal, not going through troff.
But this is not so bad as a temporary measure - instead of having man render the troff and pipe it into pager, pandoc will render the markdown into troff, pipe it to man (I guess), then to pager. Shouldn't be terribly difficult to set up.
Ah, okay. There's mdless: https://github.com/ttscoff/mdless
Also, for Windows, Microsoft made something similar: https://docs.microsoft.com/en-us/powershell/module/microsoft...
Re:History of Unix Manpages (2011)
by microtherion on Thursday May 28, 2020 @07:50PM
(#23344541)
I used POD for several years to write my manpages. Recently i bit the bullet and started writing in mdoc. Still not sure this was the right choice: It's a terrible formatting language, but it is a bit richer in what formatting it can express.
Re:History of Unix Manpages (2011)
by dredmorbius on Friday May 29, 2020 @01:59AM
(#23346696)
mktotext ()
{
pandoc --standalone --from markdown --to html -o - $1 | /usr/bin/w3m -dump -T text/html | ${PAGER:-less}
}
Tune to preferred utilities. Invoking a console browser directly on the HTML rather than dumping ASCII is another option.
Anyway, you should probably ask the author/maintainer of groff about these matters: James Clark, whose homepage is http://www.jclark.com/