Update the README.md file to work better with github.

And a few other minor markdown nitpicks.