General markdown tweaks

[tyler36]

Overview

This PR fixes some common markdown "problems"

• Top-level heading
• Indentation

[tyler36]

Note: the table of contents was auto-generated via the Markdown All in One VSCode extension. The <!-- omit in toc --> help the extension determine what to include.

This extension also auto-update the TOC in real time and is awesome if you use VSCode and markdown.

[rfay]

What TOC?

[tyler36]

Sorry, wrong thread. :(