News for hackers. Stuff that matters.
Re:History of Unix Manpages (2011) by einpoklum on Thursday May 28, 2020 @06:39PM (#23343800)
Do we have a terminal "renderer" for Markdown? That doesn't make too many assumptions? The could be a start. Or perhaps a utility which renders Markdown as troff.

Anyway, you should probably ask the author/maintainer of groff about these matters: James Clark, whose homepage is http://www.jclark.com/

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.
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.