Improve README

[adamchainz]

1. Fix some reStructuredText syntax
2. Add syntax highlighting to code blocks.
3. Make example code follow Black style, with double quotes, and simple indentation.
4. Tweak some language, e.g. remove "simply" which can be read as dismissive "it's so simple".

I think these changes make the README a little more readable.