> (...) intimidated by the relatively arcane file format & folder structure Notice that there's also mdoc [0], which is a saner format, specifical for manpage

> (...) intimidated by the relatively arcane file format & folder structure Notice that there's also mdoc [0], which is a saner format, specifical for manpages. I'm not sure that writing manpages in markdown would be a good idea (or make too much of a difference for the author). A fundamental point of man pages is their very strict format, which is enforced by the markup. A good way to produce manpages is not to write them, but produce them automatically from your code. One of the best tools for that is GNU's help2man [1], where you only have to write the "--help" and "--version" options on your program, and help2man creates a manpage from that. [0] https://man.openbsd.org/mdoc.7 https://man.openbsd.org/mdoc.7 [1] https://www.gnu.org/software/help2man/ https://www.gnu.org/software/help2man/