REPOMATIC-LINT-ANCHORS(1) REPOMATIC-LINT-ANCHORS(1)

repomatic lint-anchors - Check same-page doc links against the built site

repomatic lint-anchors [OPTIONS]

Check every same-page link resolves to an anchor the build produced.

A literal (#fragment) link is copied into the HTML untouched, so a fragment naming a slug that was never generated ships as a link that looks fine and lands nowhere. Sphinx cannot catch it, having nothing to resolve, and a Markdown link checker has to guess the slug rather than read it, which is a different answer often enough to be useless.

Only fragments written in the Markdown sources are checked, so a theme's own footnote backrefs and header permalinks are never mistaken for something an author asked for.

Run it against a site that has just been built: an out-of-date build directory answers for the pages it was made from.

Root of the documentation sources to read links from.
Root of the rendered site to resolve those links against.
Show this message and exit.

Root of the documentation sources to read links from.
Root of the rendered site to resolve those links against.
Show this message and exit.

0
Success.
1
A runtime error, or an aborted prompt (Ctrl-C, a declined confirmation).
2
A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

Defaults, straight after a Sphinx build

repomatic lint\-anchors

A tree built elsewhere

repomatic lint\-anchors \-\-docs\-dir ./docs \-\-build\-dir /tmp/site

Kevin Deldycke

2026-09-14 7.15.1.dev0