Data workflow guides

Find a stale anchor and a retired reference before publishing

·

A heading rename can break a link even when the document and the destination page still exist. Compare the source fragment to the generated heading IDs and check which reference definition supplies each destination.

Markdown Link Rot Checker

Check both occurrences of the Start here heading

Select Load example and Check Markdown links. Expand Heading anchors. The first Start here heading has ID start-here and the second has start-here-1. The link on line 5 targets the second heading successfully.

The percent-encoded link to Café route on the same line also matches. The old-stop fragment on line 6 has no matching heading. Replace that fragment with a listed ID if the link should point to an existing section.

GitHub Docs — Section links and custom anchorsCommonMark 0.31.2 — Reference definitions and links

Trace the two Map links to their first definition

Both Map links use the HTTP destination defined on line 10. The duplicate on line 11 supplies a different destination, but the first definition is used. The report also shows the repeated destination.

With Flag HTTP and scheme-relative URLs enabled, both Map entries get an HTTP finding. The missing guide reference on line 6 stays unresolved. Remove the duplicate definition and add the intended destination for the retired reference before comparing another report.

CommonMark 0.31.2 — Reference definitions and links

Separate source findings from destination availability

Download markdown-links.json. Use the line and column values to locate an entry in the source. The relative trail image is recorded as a destination. The fenced Markdown example stays outside the report.

External and relative destinations are declarations found in the saved source. Their availability remains unknown. Heading IDs are calculated from parsed Markdown headings, so custom HTML anchors or renderer-specific changes need review in the published document.

GitHub Docs — Section links and custom anchors

Common questions

Can I audit both CommonMark and GitHub Flavored Markdown?

Yes. Change Markdown dialect before checking. GFM also recognizes supported bare web addresses and email autolinks.

Can I omit image destinations?

Clear Include image destinations to focus on text links. The parser still reads the surrounding Markdown.

Why is a repeated destination listed separately?

Multiple links can legitimately point to the same target. The repeated-destination list records reuse and leaves findings for explicit issues such as unresolved references or a missing fragment.

Sources

Put it into practice.

Related guides