Skip to content

Z107: CIRCULAR_ANCHOR

  • Severity: Error


    Penalty: 0.0 points | Category: general

  • Remediation & Opt-In


    Auto-Fixable: No | Opt-In: No


Rationale

This rule is emitted when an anchor link's visible text label slugifies to the exact same string as its own fragment identifier, creating a redundant self-referential jump link that points to its current position.


How to Fix

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

  • Failing Pattern (Triggers Z107)


    docs/example.md
    <!-- BAD: Link text label matches fragment slug -->
    [#installation](#installation)
    
  • Passing Pattern (Resolves Z107)


    docs/example.md
    <!-- GOOD: Descriptive text label explaining the jump destination -->
    [Jump to Installation Guide](#installation)
    

Configuration

.zenzic.toml
# Can be ignored for didactic tutorial pages via directory_policies
[governance.directory_policies]
"docs/tutorials/examples/z1xx-links/**" = ["Z107"]

Reference

See the Finding Codes Index for finding code details.