How do I convert Natspec into something that a human can easily read?
Eg: HTML, Markdown, .PDF
This appears to generate HTML documentation directly from your natspec'd code:
As per the User Documentation on the Natspec page, the output is just a JSON blob.
You could feed this JSON output into a conversion tool, e.g.:
I have released a plugin for Hardhat which generates a Vue static site from NatSpec comments: https://github.com/ItsNickBarry/hardhat-docgen