Attachments

SnipperApp 3 lets you attach files and images to any snippet, so a snippet can carry its screenshots, diagrams, configuration files, and reference documents along with the code.

Attachments live in the attachments strip, a row of cards between the snippet header and the editor. The strip appears as soon as a snippet has at least one attachment.

Adding Attachments

Paste

Copy an image to the clipboard (take a screenshot with Cmd+Shift+4, or copy an image from a browser or chat app), then press Cmd+V in the editor:

• In a code snippet, the image is attached to the strip. If the snippet's language is Markdown, an image reference is also inserted at the cursor so it renders in the Markdown preview.
• In a Note, the image is placed inline at the cursor. See Notes.

Pasting text works as it always has. Cmd+V only creates an attachment when the clipboard holds an image.

Snippet > Paste Attachment no longer has a keyboard shortcut. Cmd+Shift+V is the menubar popup's global hotkey, and Cmd+V now handles images in any snippet, so the menu item stays only as the way to force an image into the attachments strip of a Note instead of placing it inline.

Drag and Drop

Drag one or more files from Finder onto the editor or the attachments strip. They are attached immediately. In a code snippet this works for any file type. In a Note, image files go inline; other files, or a drop that mixes images with other files, go to the strip.

Attach File…

Open the file picker in any of these ways:

• Choose Snippet > Attach File… or press Shift+Cmd+A. The shortcut can be remapped in Settings > Shortcuts.
• Click the paperclip button in the toolbar.
• Right-click in the editor and choose Attach File….

Pick one or more files and click Open. In a code snippet, all of them go to the strip. In a Note, images go inline at the cursor and other files go to the strip.

Images in Code Snippets

A code snippet keeps its content as plain text, so images always live in the attachments strip. Paste a screenshot, drop image files onto the editor, or use Attach File…, and the image appears as a card with a thumbnail above the editor.

If the snippet's language is Markdown, pasting an image also inserts a reference at the cursor:

![screenshot.png](snipper://attachment/UUID)

The snipper://attachment/ link points at the attachment, and the image renders in the Markdown preview. For attachments you added earlier, right-click the card and choose Insert as Markdown Link (see below).

Inline Images in Notes

In a Note, pasted, dropped, or picked images are placed right in the text at the cursor, and are also stored as attachments of the Note. Delete the image from the text and the attachment is removed; remove the attachment from the strip and the image leaves the text. Notes are the only place images render inline. See Notes for the details, including the supported formats and the .svgz caveat.

Viewing Attachments

Each card in the attachments strip shows the file name, file size, and a type icon, with a thumbnail for images. SVG files get a thumbnail too, and thumbnails of transparent images (an SVG logo, a window screenshot) sit on a white background.

Quick Look

Select an attachment and press Space, or double-click it, to open a Quick Look preview. Quick Look handles images (PNG, JPEG, GIF, SVG, WebP, HEIC), PDFs, text files, and the many other formats macOS Quick Look supports. Press Space again or Escape to dismiss it.

Supported Formats

SnipperApp 3 accepts any file type. Common cases:

SVGs are stored as vectors and stay crisp at any size. Compressed .svgz files are attached as ordinary files.

Size Limits

• Individual file limit. Each attachment can be up to 50 MB.
• Per-snippet limit. There is no hard limit on the number of attachments per snippet, but keep in mind that large attachment sets will affect sync times.
• Storage. Attachments are stored locally and in iCloud (if sync is enabled). They count toward your iCloud storage quota.

Insert as Markdown Link

When the snippet's language is Markdown, you can insert an attachment into the text as a Markdown image or link:

1. Right-click an attachment card.
2. Choose Insert as Markdown Link.
3. An image reference (for images) or a link (for other files) is inserted at the cursor.

For images this produces:

![screenshot.png](snipper://attachment/UUID)

where UUID is the attachment's identifier. The image renders in the Markdown preview pane. This menu item only appears for Markdown snippets.

Managing Attachments

Right-click an attachment card for its menu:

Removing

Choose Remove from the menu, or click the × on the card. There is no confirmation: the attachment is removed from the snippet and from local storage right away. If iCloud sync is on, the removal reaches your other Macs on the next sync.

In a Note, removing an attachment that is placed inline also removes the image from the text.

Saving to Disk

Choose Save to Downloads to save a copy of the file to your Downloads folder. SnipperApp reveals the saved file in Finder.

iCloud Sync for Attachments

Attachments are synced alongside their parent snippets via iCloud:

• Upload. When you add an attachment, it is uploaded to iCloud as a CloudKit asset on the next sync.
• Download. When you open a snippet on another Mac, its attachments are downloaded automatically.
• Large files. Larger attachments may take more time to sync than text-only snippets. A progress indicator shows download status for pending attachments.
• Offline access. Once downloaded, attachments are available offline.

MCP Access

Attachments are accessible through the MCP integration. AI assistants can:

• List attachments for a snippet using list_attachments.
• Retrieve attachment metadata with get_attachment.
• Add new attachments using add_attachment.
• Remove attachments using delete_attachment.

Tips

• Screenshots are a common use case. Attach a screenshot of the expected output, UI component, or error message alongside your code snippet for complete context.
• Cmd+V is the fastest screenshot workflow. Take a screenshot, click into the snippet, and paste. No menu needed.
• Keep attachments relevant. Attach only files that are directly related to the snippet. Use Finder for general file storage.
• Consider file sizes. Large attachments slow down iCloud sync. Compress images or use optimized formats when possible.

Related

• Notes. Rich-text notes with images placed inline.
• Markdown Preview. Render attached images in Markdown preview.
• iCloud Sync. How attachments sync across devices.
• MCP Integration. Manage attachments via AI assistants.