Cleaner markdown formatting

[b-ryan]

This makes the markdown files easier to read from the terminal, IDEs, vim, etc. There's no actual change to any content. I fixed one or two typos along the way too.