Feature · Built for Mac

Images and video in your notes

Photos, screenshots and videos live in the note, and every one stays a plain file or link.

Shipped in Mac AppProven in codebase: editor/attachments/image-drop.ts, decorations/embed-format.ts, decorations/image-format.ts, shared/video-embed.ts, decorations/link-card-format.ts (as of 2026-10-03)The video player loads from the provider (youtube-nocookie for YouTube) only after you press play.

What this helps you achieve

  • Paste or drag an image into a note and it is saved in your attachments folder
  • Set an image's width by typing it in the link, or drag the corner on Markdown images
  • Watch YouTube, Vimeo and Loom videos inside the note, with nothing loaded until you press play

Notes are rarely only text. A trip plan wants the photo of the street you want to find again, a design review wants the screenshot, and a research note wants the talk you are taking notes on. Oyma keeps all of that inside the note without turning your notes into a database.

Paste or drop an image

Copy an image or take a screenshot, then paste it into a note. Or drag a photo in from Finder or a browser. Oyma saves the file in an attachments folder at the top of your notes folder and inserts a link to it at the spot where you dropped it:

![[attachments/paste-2026-10-03t20-15-04-512z.jpg]]

The image shows inline, right where the link is. Put the cursor on the line and the link shows again, so you can edit it like any other text.

Choose the size

Add a width in pixels after a vertical bar and the image follows:

![[attachments/paste-2026-10-03t20-15-04-512z.jpg|360]]

Images written in the standard ![alt](link) form can also be resized with the mouse: click the image and drag the handle in its corner. The new width is written back into the link, in the same |width form. More on the syntax in Markdown basics.

Photos in tables

A table cell that holds only an image link shows the picture. A day-by-day plan with one photo per row, or a comparison of three designs, reads at a glance and is still a plain Markdown table on disk.

Videos that play in the note

Paste a YouTube, Vimeo or Loom link on its own line and it becomes a player. You keep your notes, quotes and to-dos right under the video instead of in another tab. Any other address becomes a link card.

The player is quiet until you ask for it. The note shows a poster and a play button, and nothing is loaded from the video site until you press play. YouTube videos play from the youtube-nocookie address. The same rule holds on the privacy architecture page: nothing third-party loads before you ask for it.

Formats that show inline

Image links ending in .png, .jpg, .jpeg, .gif, .webp, .svg, .avif, .heic or .bmp render as pictures. Every pasted or dropped image is saved as a new file with a time-stamped name, so nothing already in the folder is overwritten. Rename the file later if you like; it is an ordinary file.

For video, three providers are recognised today:

ProviderLinks that become a player
YouTubeyoutube.com/watch?v=…, youtu.be/…, /shorts/… and /embed/… links
Vimeovimeo.com/<number> links
Loomloom.com/share/… links

Good ways to use it

  • Trip plans. One note per trip, a photo of every place you want to find again, and a table of days with a picture per row.
  • Design reviews. Paste the screenshot, write the feedback under it, and link the note from the meeting it came up in.
  • Learning from talks. Paste the talk, then keep timestamps, quotes and questions right under the player while you watch.
  • Moodboards. A table of images is a quick grid of references that any Markdown app can still open.

Where it falls short

  • Local paths in ![alt](…) links. Standard Markdown image links render when they point to a web address. Links to a file path on your Mac in that form show as text for now; use the ![[attachments/…]] form that pasting and dropping create.
  • Other video sites. Anything that isn’t YouTube, Vimeo or Loom becomes a link card rather than a player.
  • Resizing embeds with the mouse. The drag handle works on ![alt](link) images. For ![[…]] embeds, type the width after the bar.

Every image is a file in your folder and every video is the link you pasted. Open the same notes in any other Markdown editor and they still make sense. Nothing is uploaded, and there is no account to hold your media.

Where do pasted images go?

Into an attachments folder at the top of your notes folder. The note gets a link like ![[attachments/photo.jpg]], so the image is a normal file you can open, move or back up like any other.

How do I make an image smaller?

Add a width in pixels to the link, like ![[attachments/photo.jpg|360]]. For images written as ![alt](link), you can also click the image and drag its corner handle; the new width is saved in the link.

Can a table cell hold an image?

Yes. A cell that contains only an image link shows the picture, which makes trip plans, moodboards and product comparisons easy to scan.

Which video sites play inside a note?

YouTube, Vimeo and Loom. Paste the link on its own line and it becomes a player. Other links become a link card.

Does a video embed track me before I watch it?

No. The note shows a poster and a play button. The player itself, and anything it loads, is only fetched after you press play, and YouTube videos use the youtube-nocookie address.

Your notes, in plain Markdown.

Free during the private beta. Apple silicon Macs, macOS 14 or later.

features images and video downloadDownload for Mac

No account needed. Intel Mac build