OctarineOctarineDocs
Desktop / Editing and Formatting /

Attachments

Managing images, videos, and other media files

Octarine makes it easy to enrich your notes with images and videos. Whether you're documenting a project, creating a visual guide, or just adding some personality to your notes, attachments work seamlessly.

All your media attachments are kept organized in a .attachments folder inside your workspace. If you don't see it in Finder, you may need to enable viewing hidden folders.

What You Can Attach

Octarine supports common image formats like png, jpg, jpeg, gif, svg, and webp, plus video formats including mp4, webm, and mov. Pretty much anything you'd expect to work does.

You can also embed web links. Regular URLs become preview cards, direct image URLs become images, and YouTube links can become playable embeds.

Adding Attachments to Your Notes

There are a few ways to get media into your notes, depending on what feels most natural:

Adding a new attachment:

  • Type / and select "Insert Media" to open a file picker and choose an image or video from your computer
  • Or just drag and drop a file directly from Finder into your note—it'll be added automatically

Reusing an existing attachment:

  • Type [[ to see a list of all attachments already in your workspace, then pick the one you need
  • You can also drag attachments from the attachments popover directly into your note

Want to resize an attachment? Just grab the resize handle and adjust it to fit. The width gets stored right in the wikilink format, like this: [[Image.png|450]], where 450 is the width in pixels.

If you have a normal external link in a note, you can turn it into an embed from the link popover.

  • Click into the link, then choose Embed link.
  • Or Option/Alt + click the link while editing.

Octarine handles different links in the way that makes the most sense:

  • Regular links become preview cards with the title, domain, description, and image when that metadata is available.
  • Direct image links become embedded images.
  • YouTube links from youtube.com, m.youtube.com, or youtu.be become YouTube embeds. Octarine also understands YouTube iframe embeds when you paste or import them.

Embeds stay portable in Markdown. Link previews are saved as normal Markdown links with Octarine metadata, and YouTube embeds are saved as iframe markup plus metadata. If you ever want the plain link back, open the embed menu and choose Convert to text link.

Managing Unused Attachments

Over time, you might accumulate attachments that are no longer referenced in any of your notes. Octarine makes it easy to clean these up.

Open the attachments popover and look for files that aren't being used. You can delete any unused attachments with a single click, keeping your workspace tidy and freeing up storage space.