Investigate use of hatch-fancy-pypi-readme plugin for PyPI README

[matthewfeickert]

trafficstars

You're totally right! I had a memory of removing the badges too, but I think Jim preferred them in there.

We use the same mechanism though — one can add hidden markers to the README.rst / README.md, and treat them as boundaries of text chunks that are used to build the final README.

Originally posted by @agoose77 in https://github.com/scikit-hep/pyhf/pull/2095#discussion_r1081334675

c.f. https://github.com/hynek/hatch-fancy-pypi-readme#readme