PyPI description does not support Markdown

[davehunt]

The package description on PyPI doesn't look good. This is because we're using Markdown, and PyPI does not support this. If we switch to ReStructuredText the formatting would be preserved between GitHub and PyPI.

[whimboo]

Hm, I was playing directly around with it on the Github wiki by selecting reStructuredText as edit mode. But when I select Preview it still renders with unresolved references? Is there anything we will have to obey when we do that change?

Here my example:

Mozdownload_ is a Python package_ which handles downloading of Mozilla applications.

.. _Mozdownload: https://github.com/mozilla/mozdownload
.. _Python package: http://pypi.python.org/pypi/mozdownload

[davehunt]

I'm not sure about the GitHub wiki, but that's not what this issue is about. See pytest-html README as an example rst file that works well in PyPI beyond that, I would have to search for the answers to any formatting questions myself.