This is unrelated to Polymer.
On polymer-project.org we add anchor links to all headings. It's done client-side and the page has control whether or not it displays them using add_permalinks
variable.
See:
- https://github.com/Polymer/docs/blob/master/_config.yml#L31
- https://github.com/Polymer/docs/tree/master/docs/elements/index.md
- https://github.com/Polymer/docs/tree/master/js/app.js#L18
It's also worth noting the Kramdown markdown engine has support for inline attributes on block elements. So you can do something like this:
# Heading
{:is="x-link"}
I might switch things over now that I know that works. Good idea :)