Clean up README to follow RST syntax better

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