Fix small problems with README

It was using rst in mardkown files. It should properly generate in pypi, and very tiny changes in doc.