Pypa/readme is what Warehouse uses to render rst and markdown long_descriptions to safe HTML.
https://github.com/pypa/readme_renderer

There are a number of org-mode implementations; even for a few for Vim and Sublime.
https://en.m.wikipedia.org/wiki/Org-mode#Integration

``conda install pandoc`` is the quickest way to install pandoc, AFAIU. The last time I installed pandoc with os packages it pulled in a bunch of Haskell packages.

Python-only is the status quo for pypa/readme.


On Wednesday, May 9, 2018, Thomas Kluyver <thomas@kluyver.me.uk> wrote:
On Wed, May 9, 2018, at 7:22 PM, Diane Trout wrote:
Does the warehouse actually read the readme file directly? or does it preferentially look at long_description metadata?

I think it only looks at the long_description metadata; as far as I know README is just another file in the archive.

If you do want to convert it, though, please make sure it can fail gracefully if pandoc isn't there, because it would be frustrating to have problems installing a package from source just because it couldn't convert the README format.