[Question] Generate fixed anchors from title

[deanwong]

Is it possible to generate fixed anchors even if the title (h2) changed?
I mean generate unique_head via "annotation" or hidden HTML attribute.

[jakeminusone]

Hi @deanwong

You can generate fixed anchors by using the following notation in your markdown source files:

Before:
<h2 id='my-fixed-anchor'>Old Title</h2>

After:
<h2 id='my-fixed-anchor'>New Title</h2>

The title will be updated in your static html site, but the anchor will remain fixed. My team is regularly using this notation to create a standard pattern for anchors in each section of our docs. This also allows headings with the same title to be linked by different anchors. For example:

<h3 id='query-instructions'>Instructions</h3>
<h3 id='setup-instructions'>Instructions</h3>

@abourget, I believe you had the same question posted to the old Slate API Docs community page:
https://spectrum.chat/slate/general/override-the-default-auto-generated-anchors-for-links~38d5a952-739b-49b4-9845-723b68cf261c

[deanwong]

@jakeminusone thank you, do you mean put the raw html into md file?

[jakeminusone]

Exactly. Using raw html for headings instead of the standard markdown syntax gives you control over the heading anchors. When compiled by Slate, the anchor can be fixed when the title is updated.

[deanwong]

@jakeminusone works like a charm, thanksss