Markdown formatting changes

Improving Markdown rendering on Github.

I noticed that the bulleted lists weren't indenting correctly. Fixing that led to some other (relatively minor) formatting changes.

Overall result: Slightly better documentation rendering and user experience.
Merge pull request #64 from vmbrasseur/readme-formatting

Markdown formatting changes in README.md