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.