Clean up README to follow reStructeredText syntax better

* Clean up code blocks to follow reStructeredText syntax properly
* Fix any missing inline code formatting
* Fix inline links that remained in Markdown syntax