Clean up README formatting

Other markdown to html/pdf/text/etc. converters (e.g. pandoc) have stricter rules
than github style markdown. Cleaning up some of the spacing in the file fixed
some issues.