-
Notifications
You must be signed in to change notification settings - Fork 0
Vault Maintenance
Scan your vault for structural issues and fix them in bulk. Most detection is local analysis — no AI required for orphans, broken links, empty notes, or duplicates.
Full vault: Ctrl/Cmd + P → Run Maintenance
Single folder: Right-click a folder → Scan this folder for maintenance
Results are sorted by severity: Critical → Warning → Info.
| Type | Description |
|---|---|
| Broken Links |
[[wikilinks]] pointing to non-existent notes. Heading and block fragment aware. |
| Empty Notes | Notes with no content. Shows how many other notes link to them (backlink impact). |
| Type | Description |
|---|---|
| Orphan Notes | Notes not linked from anywhere. Canvas-aware (notes used in canvas files aren't orphans). |
| Duplicates | Similar notes detected via TF-IDF cosine similarity. Includes side-by-side comparison. |
| Duplicate Tags | Duplicate tags detected via string normalization + cross-language embedding similarity. |
| Type | Description |
|---|---|
| Untagged Notes | Notes without any tags in frontmatter. |
| Missing Tags | AI-suggested tags for notes that could use them. (Requires AI) |
Narrow down results in large vaults:
- Severity chips — toggle entire severity levels on/off (Critical / Warning / Info)
- Type chips — toggle individual issue types (Empty, Orphans, Broken Links, etc.)
- Text search — real-time path-based filtering (type a folder name or note title)
Each issue has contextual action buttons:
| Action | Available for | What it does |
|---|---|---|
| Open | All issues | Open the note in the editor |
| Archive | Empty, Orphan | Move to the archive folder (configurable in Settings) |
| Delete | Empty, Orphan | Delete permanently (with undo support) |
| Apply Tags | Missing Tags, Untagged | Write suggested tags to frontmatter |
| Remove Link | Broken Links | Convert [[broken link]] to plain text |
| Fix Link | Broken Links | Replace with the correct link target |
| Link | Orphan | Add links from related notes to this orphan |
| Open Side by Side | Duplicates | Compare two notes in a split view |
| Merge | Duplicate Tags | Merge variant tags into the canonical form |
| Dismiss | All issues | Strikethrough the item (recoverable with Undo button) |
| Note dropdown | Duplicate Tags, Duplicates | Browse affected notes and open any one |
- Check the Select All checkbox at the top of a section (or check individual items)
- Click a batch action button: Archive, Delete, Dismiss, Apply Tags, etc.
All batch actions support the same undo mechanism as individual actions.
Select multiple untagged or missing-tag notes and click Organize to batch-organize them with AI. A preview modal opens where you can review and edit all tag/link suggestions before applying.
Every action is recoverable:
| Action | How to undo |
|---|---|
| Dismiss | Click the inline Undo button (appears immediately) |
| Delete | Go to Activity Log → click Restore (full content backup) |
| Archive | Go to Activity Log → click Restore (moves note back to original location) |
| Apply Tags | Go to Activity Log → click Restore |
| Remove/Fix Link | Go to Activity Log → click Restore |
Click Re-scan to run the maintenance scan again. This is useful after fixing some issues — the remaining results update to reflect the current vault state.
When you re-scan, the organize result cache is cleared so any subsequent AI calls get fresh results.
Enable in Settings → Maintenance → Auto Maintenance to run scans on a timer.
- Default interval: 60 minutes
- Runs in the background
- Only notifies you when issues are found
Configure in Settings → Maintenance:
- Exclude Folders — skip specific folders from scans
- Exclude Tags — skip notes with specific tags
Maintenance scans only Markdown (.md) notes. Excalidraw and Canvas files are automatically excluded.
- Organize Tags — dedicated tag deduplication with more detail
- Activity Log — view history and restore previous states
Vaultend Wiki
Features
Reference