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
Merge pull request #180 from jeffbyrnes/master

Clean up README to follow reStructeredText syntax better