Link Check

Validate wiki-links and find orphaned notes.

What It Checks

Workflow

1. •

   Scan for all wiki-links

   • •Find [[...]] patterns in all .md files
   • •Extract link targets
2. •

   Validate each link

   • •Check if target file exists
   • •Check for ambiguous matches
   • •Track which files link to what
3. •

   Find orphaned notes

   • •Files that no other file links to
   • •Exclude expected orphans (CLAUDE.md, templates, etc.)
4. •

   Generate report

   • •Broken links with source files
   • •Orphaned notes list
   • •Link statistics

Search Patterns

# Find all wiki-links
Grep pattern="\[\[[^\]]+\]\]" path="{vault}" glob="*.md"

# Find links to specific note
Grep pattern="\[\[Note Name\]\]" path="{vault}" glob="*.md"

Output Format

## Link Check Report

### Summary
- Total links: {count}
- Broken links: {count}
- Orphaned notes: {count}

### Broken Links
| Source File | Broken Link |
|-------------|-------------|
| {file} | [[{target}]] |

### Orphaned Notes
Files with no incoming links:
- {file}
- {file}

### Recommendations
- {actionable suggestion}

Parameters

• •$ARGUMENTS (optional):
  • •No args: Full vault scan
  • •{folder}: Scan specific folder only
  • •--orphans-only: Only check for orphaned notes
  • •--broken-only: Only check for broken links

Example

User: /link-check

Response: "## Link Check Report

Summary

• •Total links: 1,247
• •Broken links: 8
• •Orphaned notes: 23

Broken Links

Orphaned Notes

Files with no incoming links:

• •Inbox/Quick thought 2024-03-15.md
• •Resources/Snippets/bash-aliases.md
• •Archive/Old Project/notes.md (20 more in Archive/)

Recommendations

1. •Create Design System.md or update link in Website.md
2. •Review Inbox/ items for processing or deletion
3. •Orphans in Archive/ may be intentional - consider excluding from future checks"