Attachment Placement

by hutnerr
5
4
3
2
1
New Plugin

Description

This plugin has not been manually reviewed by Obsidian staff. Define rules for more advanced and custom placement of newly created attachments.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

Downloads

Overview

This plugin is meant to make resource placement more flexible and context-aware.

Instead of forcing all new resources into a single hardcoded folder, it lets you define where resources should go based on the file or folder you’re currently working in. Rules can target individual .md files for per-note precision, or entire folders for broader coverage. The plugin checks the active file first, then walks up the directory tree until a matching rule is found.

This plugin would likely be useful for people who like to copy-paste in images and would like some further organization.

Links

How To Use

Placement rules can be defined on individual files or folders.

When a new resource is created:

  1. The plugin checks if the active file itself has a placement rule.
  2. If not, it checks the file's parent folder.
  3. If not, it checks the parent folder's parent, and so on.
  4. The resource is placed according to the first matching rule found.

To get started with the plugin, open up the settings and define some rules for which attachments should be placed.

Once there are rules set, the plugin will pay attention to new files being created and handle them according to the rules set.

Example

Given the following structure:

/
├── attachments/
│   ├── school/
│   ├── journal/
│   └── videogames/
├── journal/
├── league-of-legends/
├── dragon-age-origins/
└── school/
    └── math/
        ├── factoring.md
        └── addition.md

If we are working within addition.md, we first check if there is a rule for addition.md itself. If not, we check its parent folder (math/), then school/, continuing upward until a rule is found or the root is reached.

If no rule is found, the plugin uses the fallback location defined in settings.

To complete the example, these are what some actual placement rules might look like:

If you'd like another example, check out the help page.

Support

If you found this project helpful or enjoyable, and want to support future work, you can buy me a coffee on Ko-fi Totally optional, always appreciated.

ko-fi