Can't we just convert all man pages to a modern format like HTML, and never look back?
Granted, it may not be the ideal format for documentation, but I'd argue neither is HTML - too much cruft for reading in a terminal and not very ergonomic to type out. I'd argue markdown or something like that would be a better fit, it's got support for the formatting and linking needed, most developers are familiar enough with it, you don't actually need to parse or render it to be able to read it, etc.
> Many aspects of the basic syntax of the mdoc language are based on the roff(7) language
So, I wouldn't say that mdoc is the modern format here ...
https://manpages.debian.org/bookworm/manpages-dev/syslog.3.e...
Bit I don't think html would be a good source format.
man --html=firefox man