If you're thinking of man readers, do consider the mandoc (previously mdocml) project. By treating the page semantically (rather like a macro language), it can

If you're thinking of man readers, do consider the mandoc (previously mdocml) project. By treating the page semantically (rather like a macro language), it can achieve better results (pretty HTML output, even markdown output!). https://mandoc.bsd.lv/man/mandoc.1.html https://mandoc.bsd.lv/man/mandoc.1.html