Images & Attachments

Where pasted screenshots land — and how to put them exactly where you want.

What happens when you paste

Copy a screenshot to the clipboard, put the caret in a note, press Ctrl/⌘ V — SoloMD writes the image file to disk next to your note and inserts the Markdown link for you. Dragging an image file into the editor does the same. By default the file goes into an _assets/ folder in the same directory as the note:

my-folder/
├── note.md          ← you pasted here
└── _assets/
    └── image-20260806-093012.png

Everything stays local and relative — the vault remains a plain folder you can sync, zip, or open in any other editor.

Rename _assets to images (or anything else)

Open Settings → Writing. With “Where to save pasted/dropped images” on its default (Shared _assets/ folder per directory), a “Shared attachments folder name” field appears below it. Type images and you're done — every image pasted from now on is saved to images/ next to the note, and links are inserted as ![](images/…).

Slashes are stripped from this field — it's a plain folder name, not a path. For paths and per-note folders, use Custom mode below.

The three attachment modes

Custom path templates

Switch “Where to save pasted/dropped images” to Custom path (Typora-style) and a “Custom image path” field appears. The template supports one variable — ${filename}, the note's file name without extension (foo.md → foo):

Relative templates resolve against the note's own directory. The inserted Markdown link always uses forward slashes, so links render correctly on Windows too. The syntax matches Typora's “copy image to custom folder” setting — vaults migrated from Typora can keep their existing template as-is.

Good to know

• Changing the setting only affects new pastes. Existing images and links are left untouched. To migrate an old vault, rename the folder on disk and search-and-replace _assets/ → images/ across your notes (global search is Ctrl/⌘ ⇧ F).
• Notes without a file yet (unsaved tabs) save pasted images to a temp folder; the link is rewritten once you save the note.
• Prefer an image host? SoloMD can also upload pasted images to PicGo, SM.MS, S3 or GitHub and insert the URL instead — see the editor guide and Settings → Image upload.