Markdown Heading Link Repair

Fix broken GitHub heading links

Repair a GitHub README table of contents after changing headings

GitHub generates a fragment for each Markdown heading. The fragment can change when you rename a heading, add punctuation or add another heading with the same text. Existing table-of-contents links keep their old destinations until you edit them.

Other renderers choose different identifiers. The tool uses the usual GitHub heading fragment rules. A static site theme, another Markdown renderer or a custom extension may use a different rule.

Read the worked example