Self-links should be displayed next to H1, H2 etc. in articles

[jakub-g]

• clickable links next to each anchor
• automatic update of hash in the URL as we scroll

This has been long in my mind and long discussed but never got implemented so far...

When you go to some MD file on Github, next to each header (H1, H2) you can see a #-link to this part of the page when you hover over it

[1] https://github.com/ariatemplates/ariatemplates#getting-started

It's an important feature for sharing links, bookmarking etc.

We already have #-id's for each H1, H2 etc and even links to them in the container on the right hand side [2] , but IMO we should also implement inline links in the GH way [1] or the node way [3]

[2] http://ariatemplates.com/usermanual/latest/page_engine#page-providers
[3] http://nodejs.org/api/modules.html#modules_module_exports

[jakub-g]

Apart from that, while the user scrolls, the hash in the URL could be updated using pushState to the currently visible part

[flongo]

I would just set the hash for a better browser compatibility

[jakub-g]

Setting the hash has a drawback of navigating to the ID specified by hash, and this can not be prevented (unless doing some hacky things like, obtaining current browser scroll, setting hash, restoring scroll). Who reads usermanual on IE8? :)

[flongo]

yes, you are right