Fix comments from pull request.

- Added blank line in README.md and add "vim" syntax highlighting so
  that the example options show up highlighted.

- Removed unnecessary comment from syntax/hamlet.vim and fixed some code
  formatting.