When I submit my package to the Python Package Index (https://pypi.python.org/pypi) my README file, which is written with valid reStructuredText and saved as README.rst, is
EDIT: You can use the following to find errors in your RST that will show up on PyPI:
twine check
You'll need twine version 1.12.0 or higher. If you don't have it you can install or update it using:
pip install --upgrade twine
Source
Deprecated answer:
python setup.py check --restructuredtext
Source