Vault Link Check: sort your broken links into near-misses and planned notes

Disclaimer

Is this plugin open source? Yes
Is this plugin completely free? Yes
Is this plugin vibe-coded beyond the author’s ability to comprehend how it works? /No
Community Directory: Vault Link Check: obsidian://show-plugin?id=vault-link-check


I built a plugin that scans your vault for broken internal links, and tells them apart. A broken [[wikilink]] isn’t just one kind of problem:

Near-misses. The link is broken but a real note is a close match: a rename, a small typo, different spacing, or a frontmatter alias. Each row suggests the note it probably meant, so fixing it is quick.

Planned notes. Links that point at nothing yet. These get treated as dropped ideas rather than errors. Any you linked from more than one note are flagged “recurring” (a decent signal it’s worth writing), and you can copy the whole set out as a Markdown checklist to seed a backlog.

It runs on Obsidian’s own link index, so aliases, heading refs, block refs, and path-qualified links all classify correctly. No network calls, and no telemetry… It works fully offline.

How it’s different from existing plugins. Dangling Links and Find Orphaned Files give you a flat “which links are broken” list. And if you’ve seen Vault Inspector, that’s a broad vault linter that checks attachments, duplicates, frontmatter, tags, file sizes, and more. Vault Link Check is much simpler in scope and does one thing instead: for each broken link it suggests the note you probably meant, and it separates real typos from ideas you haven’t written yet, with a “recurring” flag and a copy-out backlog. The value is knowing what to do about each broken link, not just that it’s broken.

Settings

Install

  • Available in Community plugins now: Settings → Community plugins → Browse → search “Vault Link Check”.
  • Don’t want to install a plugin? There’s a web version: https://forum.obsidian.md/t/vault-link-check-find-broken-links-likely-renames-and-forgotten-planned-notes/117363 that runs the same classifier in your browser (also fully local, nothing uploaded).

Source and full README: https://github.com/Tomayachi/obsidian-vault-link-checker

Happy to hear feedback or feature ideas.