✓Direct Answer

Yes. You can drag and drop or paste images, audio files, videos, and PDFs directly into Oyma. Media files are saved in your local vault assets folder and render natively inside the editor.

Rich Media Without Cloud Lock-In

A comprehensive knowledge base contains more than plain words: it includes whiteboard photos, system architecture diagrams, PDF scientific papers, and meeting audio recordings.

Oyma delivers rich media embedding while adhering strictly to open, local-first storage standards.

Supported Media Types and Syntax

Embedding media follows standard CommonMark and Obsidian syntax conventions:

  • Images (PNG, JPEG, WebP, SVG, GIF): 
    ![Architecture Diagram](attachments/architecture-diagram.png)
    Paste screenshots directly from your clipboard (⌘V). Images render inline with interactive zoom and light/dark mode contrast awareness.
  • Audio Recordings (M4A, MP3, WAV): 
    ![[recordings/2026-10-09-planning.m4a]]
    Renders an embedded audio player featuring scrubbable waveform visualization, playback speed controls (0.75x to 2x), and timestamp seeking.
  • PDF Documents: 
    ![[research/distributed-systems-paper.pdf]]
    Embeds an interactive multi-page PDF viewer with search, page flipping, and zoom.
  • Video Files (MP4, QuickTime MOV): 
    ![Demo Video](attachments/feature-walkthrough.mp4)
+-----------------------------------------------------------+
|  ### Meeting Audio Review                                 |
|                                                           |
|  [> Play]  03:42 / 42:15  |=====----|  [1.0x]             |
|                                                           |
|  - [03:45] Action Item: Deploy ScreenCaptureKit tap       |
|  - [12:20] Security sign-off approved                     |
+-----------------------------------------------------------+

Drag, Drop, and Resize

You can drag files directly from macOS Finder into your note. To resize images visually, add pixel dimensions inside the Markdown link: ![Diagram|600](diagram.png). All assets reside safely on your local drive.

Asset Organization and Optimization

Managing media files across a large vault requires clean asset organization:

  • Automated Asset Hashing: When pasting screenshots from the clipboard, Oyma generates clean, timestamped filenames (e.g., Pasted-image-20261009-143022.png) to avoid accidental file overwrite collisions.
  • High-DPI Retina Support: Pasted screenshots preserve 2x Retina resolution while displaying at natural proportions within the editor view.
  • Light and Dark Theme Awareness: Diagram images with transparent backgrounds adapt smoothly to your active editor theme without unreadable dark-on-dark contrast issues.
  • Relative Linking Integrity: Because all media links use relative paths, moving your entire vault folder to another computer or sharing a folder via Git keeps all images and audio players fully functional.

Audio Scrubber and Interactive Media Players

Embedded audio recordings feature an interactive waveform scrubber with timestamp seeking. Clicking any timestamp inside your notes automatically cues playback to that exact second, allowing you to cross-examine written summaries against spoken dialogue.

You can also control playback speed (0.5x, 1.0x, 1.5x, 2.0x), jump forward or backward by 5 seconds with keyboard shortcuts (⌘[ / ⌘]), and export isolated audio clips directly for sharing with colleagues.

Media Integration Invariants

  • Storage Location: Saved in vault’s attachments/ folder on local Mac storage.
  • Markdown Links: Uses standard relative syntax ![Caption](attachments/filename.png).
  • Retina Displays: Preserves 2x pixel density while scaling naturally in editor views.
  • Audio Players: Includes scrubbable waveforms, 0.5x–2.0x speed toggles, and timestamp seeking.

Related Questions & Architecture Guides