Support anchor links in mint broken-links

[bomberstudios]

Update: this now works by running mint broken-links --check-anchors, so I'm closing the discussion.

---

It would be awesome (and quite useful) if mint broken-links supported checking for broken anchor links.

Here's an example, based on our own experience:

• We have a page (let's call it /features) with a few subsections, defined as h2 titles
• Mintlify helpfully gives them an anchor ID, so we can link to /features#feature-one and /features#feature-two from other pages
• At some point, one of the features listed on that page has so much content that we decide to promote it to its own page (i.e: /features#feature-three now lives in features/feature-three)
• Now, all links that pointed to /features#feature-three point to the wrong thing, but running mint broken-links shows no broken links

If the CLI could look into the page contents, and realize that there's no #feature-three anchor ID on the destination page, it could show a warning.

Thanks in advance! 🙌🏼

[velavokr]

+1, especially given that most crawler link checkers do not support fragment anchors in Mintlify, so it seems there's no good way to check them now.

[Iheanacho-ai]

Strong +1 This is a big pain for our organization because we have large reference docs that need to anchor link to each section

[Blargian]

I believe this is now supported: https://www.mintlify.com/docs/installation#find-broken-links

Looks like there is a mint broken-links --check-anchors for checking anchors

[bomberstudios]

OMG IT WORKS

(Wondering why they didn't update this thread, though. Are they checking these discussions?)

[Blargian]

I don't think they check :D