File attachments and media management

Knowledge vaults frequently incorporate architectural diagrams, presentation slides, meeting audio snippets, and design mockups. Oyma manages all media attachments locally on disk using standard Markdown syntax and wikilink embeds.

Embedding media with wikilinks

Embed any image, audio file, or document in your vault using the exclamation mark wikilink prefix:

![[system-architecture-diagram.png]]

Specifying image dimensions

Control image display size in the editor and exported documents by appending width dimensions:

• Set width: ![[diagram.png|600]]
• Set width and height: ![[diagram.png|600x400]]

Configuring attachment locations

Configure how Oyma handles new media in Settings › Files & Links › Attachments:

1. In the folder specified below: Saves all media to a central vault directory (e.g. attachments/ or assets/).
2. Same folder as current note: Keeps attachments alongside the .md document they belong to.
3. In subfolder under current folder: Creates a ./attachments/ folder within each active directory.

Supported media formats

Format	Extensions	Rendering behavior
Images	.png, .jpg, .jpeg, .webp, .svg, .gif	High-DPI inline display with resize handles
PDF Documents	.pdf	Native multi-page scrollable macOS PDF viewer
Audio Files	.m4a, .mp3, .wav	Embedded waveform player with timestamp jumps
Video Clips	.mp4, .mov	Native AVFoundation video player

Safe renaming and file integrity

When you rename an image or attachment within Oyma, all wikilink references across every note in your vault update automatically. No broken links or orphan assets remain.

Related guides

• Learn wikilink syntax in Linking and backlinks.
• Export with images in Exporting notes to PDF and DOCX.
• Check vault hygiene in Prepare an Obsidian vault.