Update Docs Formatting

@nickjs I noticed some of the formatting in the docs was screwed up.

- I fixed this with the middle commit 39bd9d1.
- In the process of doing this I noticed that running `cake test` resulted in a new batman.node version. I'm not sure why this is. Here is the commit 87dcad4.
- Finally, I rendered the docs into batman.html in the master branch here a339499. Any insight into why the links became so much simpler?

Once more thing, when I ran `cake build:site` the only thing that was updated in `gh-pages` was the `batman.node` file with the same changes as above. Shouldn't it have included the new html?

Now that I've written this PR I'm convinced I'm doing something wrong? argh.