Z102: ANCHOR_MISSING¶

Severity: Error

Penalty: 0.0 points | Category: general
Remediation & Opt-In

Auto-Fixable: No | Opt-In: No

Rationale¶

This rule is emitted when an inline link targets a fragment identifier (#anchor-name), but the destination document contains no heading slug or explicit anchor ID matching that fragment.

Fragment links pointing to missing anchors navigate to the page top but fail to jump to the intended topic section, degrading reading experience.

How to Fix¶

Inspect the flagged location in the Markdown file and update the content or configuration:

Failing Pattern (Triggers Z102)

docs/example.md

<!-- BAD: Anchor fragment #security-gate does not exist on target page -->
See the [Security Gate Options](../how-to/configure-privacy-gate.md#security-gate).

Passing Pattern (Resolves Z102)

docs/example.md

<!-- GOOD: Target page contains explicit anchor attribute -->
## Security Options {#security-gate}

Configure privacy gate settings below...

Configuration¶

.zenzic.toml

# .zenzic.toml
validate_same_page_anchors = true

Reference¶

See the Finding Codes Index for finding code details.