RST + typo fixes on README.rst

Hi there,

I've fixed a few typos in the README and a few errors I found out while deploying this at work.

I also took the liberty to update marking so it is hopefully more readable.