3 ms·
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 poi
by tyingq 6y ago
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.
- microtherion 6y agoI 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.
- einpoklum 6y agoThat'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.
- tyingq 6y agoAh, okay. There's mdless: https://github.com/ttscoff/mdless https://github.com/ttscoff/mdless Also, for Windows, Microsoft made something similar: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/show-markdown https://docs.microsoft.com/en-us/powershell/module/microsoft...