Tweaking markdown to be GH compliant

Also adding in minor rake task.

GH uses `#`s instead of `=`s for headers: https://help.github.com/articles/markdown-basics.  Making sure there is a space between header markdown and text.