A bunch of improvements

* Change `markdown` to `comment_markdown`, because it's not a general purpose
  helper;
* Change `CommentHTML` to `MarkdownToHTMLComment` (reveals intent better)
* Escape strings properly and consistently

/cc: @exalted