Convert README from markdown to reStructuredText

For having the same README file on both github and PyPI, as PyPI only
supports reStructuredText for package' long_description.
Skip first 3 title lines for package's long_description

Looks better on PyPI page
Add missing $'s to README