Plugin: Consistent Attachments

Share & showcase
1

Plugin: Consistent Attachments

Disclaimer

  • The Plugin is OpenSource
  • The Plugin is completly free
  • During development Cursor is heavily used to get this done quickly. The code is reviewed and tested manually without use of AI

Hi everyone! I just released Consistent Attachments, a plugin that automatically moves your attachments when you move a note to a different folder.

The problem

You move a note to a new folder. Obsidian updates the links — but the actual image and PDF files stay behind. Over time your vault accumulates attachment files scattered across folders that no longer have anything to do with the notes that reference them. Reorganising becomes painful, and exporting or sharing a single note means hunting down every linked file manually.

Existing tools either require you to abandon wiki-links/smart links entirely, or force a full vault restructuring upfront. This plugin does neither.

What it does

When you move a note to a new folder, Consistent Attachments automatically moves the note’s exclusively-owned attachments to the correct location and updates all links across your vault. That’s it. No link format changes, no vault reorganisation required, no side effects.

Features:

  • Auto-moves attachments on note move (toggle on/off at any time)
  • Configurable target location: follow Obsidian’s default, same folder as note, subfolder, or a fixed vault folder
  • Three strategies for shared attachments (referenced by multiple notes): Skip, Copy, or Ask
  • Never overwrites files — conflicts get a numeric suffix (image-1.png, image-2.png, …)
  • Orphan attachment scanner to find unreferenced files across your vault
  • In-memory operation log so you can see exactly what moved
  • Manual trigger via command palette and file explorer context menu
  • Works with [[wikilinks]] and standard ![Markdown](links) simultaneously
  • No telemetry, no external services — everything stays local

Install

Search for Consistent Attachments in Settings → Community plugins → Browse.

Or find it here: Consistent Attachments - Obsidian Plugin

GitHub: GitHub - bueckerlars/obsidian-consistent-attachments: Keep attachment locations consistent when notes are moved. · GitHub

Feedback, bug reports, and feature requests are very welcome — either here or as a GitHub issue. Hope it helps keep your vault tidy!