fix links to id/url based json api docs

It seems like inserting a tags with an id attribute is the way to go in markdown. I tried configuring redcarpet with @with_toc_data@, but it would name all the H* tags sequentially, breaking existing links once you add more h tags.