Fix some migration issues on markdown links.

https://www.pivotaltracker.com/story/show/60397412

- Add editorial remarks
- Replace whole markdown to prevent overeager
  replacements (e.g. replacing email addresses
  with mailto links in link text)