creating manual pages like it is 2025

Hi,


Lintian warns: no manaul page for /usr/bin/foo.
So a good reason to create /usr/share/man/man1/foo.1.gz

However, I would like to avoid create manually nroff files.

My guess is there are markdown files that pandoc converts
into nroff.

Where to find such prior art?


Regards
Geert Stappers