A lot of projects use `pypandoc` or something similar to convert Markdown to RST for PyPI. https://pypi.python.org/pypi/supervisor-stdout https://pypi.io/project/supervisor-stdout/