Markdown and small english fixes to README.md

This should be self explanatory. There are still some things left from sphinx ReStructuredText syntax (and not Markdown). As I don't know if the documentation will get into readthedocs in the end, I didn't fix the RST double dots.