Clean up documentation

Make the sections render with some updated markdown

Turns out you need a space before headings, so you need a space
at the beginning of each of the `api_docs` files.  Ultimately
we should modify the rake task to do this for us, but that's
for another day/time.