More README tweaks to improve RST compatibility

Based on excellent suggestions at https://gist.github.com/dupuy/1855764