News for hackers. Stuff that matters.
Re:History of Unix Manpages (2011) by tyingq on Thursday May 28, 2020 @07:01PM (#23344063)
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.

Re:History of Unix Manpages (2011) by einpoklum on Friday May 29, 2020 @05:12AM (#23347893)
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.

Re:History of Unix Manpages (2011) by tyingq on Friday May 29, 2020 @07:58AM (#23348906)
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.