Attachments

SnipperApp 3 lets you attach files and images to any snippet, turning snippets into rich documents that combine code with supporting materials like screenshots, diagrams, configuration files, and reference documents.

Adding Attachments

Drag and Drop

The simplest way to add an attachment:

1. Open a snippet in the editor.
2. Drag a file from Finder into the snippet's attachment area.
3. The file is attached immediately.

You can drag multiple files at once to add them all in a single operation.

Clipboard Paste

Paste images directly from your clipboard:

1. Copy an image to the clipboard (e.g., take a screenshot with Cmd+Shift+4, or copy an image from a browser).
2. In the snippet editor, press Cmd+Shift+V to paste the clipboard content as an attachment.
3. The image is saved as a PNG attachment.

This is especially useful for attaching screenshots of UI layouts, error messages, terminal output, or diagrams.

File Picker

1. In the snippet detail view, click the Attach File button (paperclip icon).
2. Select one or more files from the file picker dialog.
3. Click Open to attach them.

Viewing Attachments

Attachments appear in a dedicated section of the snippet detail view, below the code editor.

Attachment List

Each attachment shows:

• File name
• File type icon
• File size
• A thumbnail preview (for images)

Quick Look Preview

Select an attachment and press Space (or double-click) to open a Quick Look preview. Quick Look supports a wide range of file formats:

• Images (PNG, JPEG, GIF, SVG, WebP, HEIC)
• PDFs
• Text files
• And many more formats supported by macOS Quick Look

The Quick Look preview opens in a floating window that you can dismiss by pressing Space again or Escape.

Supported Formats

SnipperApp 3 supports attaching any file type. Common use cases include:

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 working with a Markdown snippet, you can insert an attachment as a Markdown image or link:

1. Right-click an attachment.
2. Select Insert as Markdown Link.
3. A Markdown image reference (for images) or link (for other files) is inserted at the cursor position in the editor.

For images, this produces:

![Screenshot](attachment:screenshot.png)

The image renders in the Markdown preview pane.

Managing Attachments

Renaming

Right-click an attachment and select Rename to change its file name.

Deleting

1. Select an attachment.
2. Press Delete or right-click and select Remove Attachment.
3. Confirm the deletion.

Deleting an attachment removes it from the snippet and from local storage. If iCloud sync is enabled, the deletion propagates to other devices on the next sync.

Saving to Disk

Right-click an attachment and select Save to Disk to export it to a location on your Mac.

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.
• Use Cmd+Shift+V for the fastest screenshot workflow: take a screenshot, then immediately paste it as an attachment.
• 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

• Markdown Preview -- Render attached images in Markdown preview.
• iCloud Sync -- How attachments sync across devices.
• MCP Integration -- Manage attachments via AI assistants.