数年过去了，今天经过多次尝试和询问，我终于成功让 nvchecker 的文档以富文件的形式展示在 PyPI 上了！

正确地打包上传命令是这样的：

rm -rf dist && python setup.py sdist && twine check dist/* && twine upload -s dist/*

如果 twine check 不通过，那么修正后重新执行。如果文档包含错误，PyPI 会以纯文本形式展示。

• 听说要设置 long_description_content_type。好像 Markdown 才要设置的，rst 不用。
• 听说不支持 # 开头的链接。实际上现在已经支持了。
• 听说要用 twine，那就用吧。

原来我之前的文档一直没有正确地渲染，是因为有一个标题的「-」少了两个……

关于 PyPI 的资料是挺多的，但是细节不够详细，陈旧信息很多，唉。