Z102: ANCHOR_MISSING

Severity: error Penalty: 5.0 points Category: structural Auto-fixable: 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:

Bad (Triggers Z102)¶

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

Good (Resolves Z102)¶

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

Configure privacy gate settings below...

Configuration¶

# .zenzic.toml
validate_same_page_anchors = true

Reference¶

See the Finding Codes Index for finding code details.