Github automatically generates hash tags for every title that you add to your README file. If you us these hashtags in your README they will not work on the NPM site.
Example of the a broken link structure is https://npmjs.org/package/hashring . Scroll a bit down for TOC that links to different API documentations.
Depends on chjj/marked#89 to be resolved