Internals
A short tour of the core, with the relevant code embedded directly. Every fenced block below is a docref snippet: its body is materialized from the source and kept current by docref refresh, so this page cannot quietly drift from the implementation it describes. This is also the tool dogfooding itself: the snippets here are real references that docref check resolves in CI.
The four states every reference is in, and how a run collapses to a CI exit code.
Whitespace-stripped content hashing and how stored hash prefixes are compared.
Which file extensions resolve structurally and what each grammar exposes.
Enforcing the ref grammar without guessing, and finding the project root.
Recognizing begin/end markers and reporting unmatched or duplicate names.
Telling the alias colon from the sha colon so the two never collide.
The unit-testable logic behind the VSCode extension's status bar and anchors.