Obsidian revolutionized personal knowledge management by establishing the gold standard of local-first software: your notes are plain text files in a local folder that you own forever.
For researchers, software architects, writers, and knowledge workers, Obsidian provided liberation from cloud databases and proprietary silos. Its bidirectional linking, markdown live-preview, and customizable frontmatter empowered users to build interconnected digital brains.
However, as knowledge work evolved toward distributed collaboration and daily video meetings, Obsidian users began facing significant friction:
First, the plugin assembly dilemma. To capture meetings, transcribe speech, or summarize calls in Obsidian, users must research, install, configure, and maintain a patchwork of community plugins (such as community Whisper wrappers, Smart Connections, or Granola sync scripts). These plugins frequently break with app updates, conflict with one another, or depend on remote cloud APIs that require ongoing subscriptions ($140 to $299 per year).
Second, meeting capture is absent from the core app. Obsidian has no native audio capture pipeline. It cannot record incoming audio from Zoom, Google Meet, or Slack without external virtual audio drivers, and it cannot transcribe conversations locally on Apple Silicon without third-party CLI utilities.
Third, table editing friction. While Obsidian introduced improved table editing in recent versions, manipulating complex spreadsheets, pasting CSV data, and sorting multi-column datasets remains clumsy compared to native Mac productivity tools.
Oyma was engineered specifically to solve this dilemma: providing the full power of a local Markdown vault, paired with native, zero-bot meeting capture and on-device AI transcription built directly into the core macOS application.
The zero-migration guarantee: your files stay where they are
Switching from Obsidian to Oyma is not a painful export-and-import migration. There is zero conversion required.
Because both applications read and write standard CommonMark text files on your local drive, adopting Oyma requires simply opening your existing vault directory:
Your Obsidian Vault/
├── .obsidian/ <-- Untouched by Oyma
│ ├── app.json
│ └── plugins/
├── Daily/
│ └── 2026-10-09.md <-- Native daily note in both apps
├── Projects/
│ ├── Architecture.md <-- Opens in both apps
│ └── Research.md <-- [[WikiLinks]] resolve in both apps
└── Meetings/
└── 2026-10-09-sync.md <-- Recorded silently in Oyma
You can open your vault in Oyma, record a meeting, edit notes, and immediately inspect the exact same files in Obsidian. There are no file locks, no proprietary database conversions, and no synchronisation conflicts.
Comprehensive transfer matrix: Obsidian to Oyma
When opening an Obsidian vault in Oyma, your core intellectual property functions seamlessly:
| Obsidian Feature | Status in Oyma | Technical Details |
|---|---|---|
| Plain Markdown files (.md) | Clean | Read and edited natively in place on your Mac filesystem. |
| Folder & file organization | Clean | Your directory structure is mirrored 1:1 in the sidebar. |
| Bidirectional [[WikiLinks]] | Clean | Piped aliases, heading links, and link autocompletion work out of the box. |
| Obsidian Callouts | Clean | [!NOTE], [!WARNING], [!TIP], and custom callout blocks render natively. |
| Frontmatter YAML properties | Clean | Metadata headers (tags, date, status) are parsed and indexed. |
| Daily notes & templates | Clean | ⌘D shortcut opens today’s note; customizable templates are supported. |
| Full-text search | Clean | SQLite FTS5 index delivers sub-30ms search queries across your entire vault. |
| Interactive Graph View | Clean | Visual force-directed network graph displays all inter-note connections. |
| Community plugins | Unsupported | .obsidian/plugins is ignored; zero third-party JS executes in Oyma. |
| Obsidian Canvas (.canvas) | Unsupported | Canvas files remain intact on disk but do not render as visual boards. |
Step-by-step setup: Opening your Obsidian vault in Oyma
Setting up Oyma with your existing Obsidian library takes less than thirty seconds:
Step 1: Preflight backup (best practice)
While Oyma modifies files only when you explicitly edit or save them, taking a quick preflight backup of your vault is sound engineering hygiene:
- Locate your Obsidian vault in Finder (e.g.,
~/Documents/Vaults/Personal). - Duplicate the folder or confirm your macOS Time Machine backup has run recently.
Step 2: Open the vault in Oyma
- Launch Oyma on your Mac.
- On the welcome screen, click Open vault… (or press
⌘Oand choose “Open folder”). - Select your Obsidian vault directory in Finder and click Open.
Step 3: Verify link resolution and note rendering
- Browse your folders in the sidebar. You will see all your familiar documents and subdirectories.
- Open a note containing
[[WikiLinks]]and callouts. Notice how cleanly they render in Oyma‘s live-preview editor. - Test link creation: type
[[and observe the instant fuzzy autocompletion popover listing all notes across your vault. - Press
⌘Oto open the command palette and type#to explore all your existing tags.
What Oyma adds to your Obsidian workflow
Opening your vault in Oyma unlocks capabilities that previously required brittle plugin stacks or third-party cloud subscriptions:
1. Botless meeting recording via ScreenCaptureKit
In Obsidian, recording a call requires external audio capture software or third-party bot services that disrupt meetings. Oyma utilizes Apple’s native ScreenCaptureKit framework:
- Records both your microphone and incoming speaker audio.
- Zero recording bots join your Zoom, Google Meet, Teams, or Slack call.
- Runs silently in the background, bound directly to macOS audio APIs.
2. Live on-device Whisper transcription
Oyma executes speech-to-text transcription 100% locally on your Mac’s Neural Engine using local Whisper models (Base, Small, or Large v3 Turbo). Your meeting audio never streams to external cloud transcription servers, ensuring compliance with strict privacy standards and legal privilege.
3. Native spreadsheet-like table editor
Obsidian tables can be cumbersome to edit. Oyma provides a Numbers-style table editing experience:
- Navigate cells fluidly with Tab and Enter.
- Insert and delete rows or columns via dedicated menus.
- Sort columns alphabetically or numerically.
- Paste data directly from Excel or Apple Numbers.
- Everything is written to disk as standard, human-readable GFM Markdown.
4. Zero plugin maintenance and rock-solid stability
In Obsidian, a major application update often disables community plugins, leaving your workflow stalled until independent community developers publish fixes. Oyma provides meeting capture, transcription, live preview, graph view, and search as integrated, first-party native features that never conflict or break between updates.
Run both apps side-by-side with complete peace of mind
The beauty of the local-first, file-based model is that you never have to make an exclusive, irreversible choice.
You can continue using Obsidian for custom plugin experiments or community extensions, while using Oyma as your daily driver for high-performance writing, spreadsheet table editing, and private meeting capture. Both applications operate on the exact same files, in the exact same folder, with complete mutual respect for your data.
What transfers from Obsidian to local Markdown
Migrating from Obsidian to sovereign Markdown (.md) preserves your core intellectual property while changing how formatting blocks are stored. Here is our empirically tested fidelity matrix:
| Format / Feature | Conversion Status | Technical Notes & Workarounds |
|---|---|---|
| Standard Markdown files (.md), folders, and daily notes | ✓ Clean transfer | Operates directly on your existing files; zero conversion or file reformatting required. |
| Internal [[WikiLinks]], piped aliases, and | ✓ Clean transfer | All bidirectional wikilinks resolve seamlessly; renaming notes automatically updates links across your vault. |
| Obsidian callouts ([!NOTE], [!WARNING], [!TIP]) | ✓ Clean transfer | Renders Obsidian callout syntax natively with matching visual styles and icons. |
| Markdown tables and frontmatter YAML properties | ✓ Clean transfer | YAML metadata and tables transfer 100% cleanly; tables gain interactive spreadsheet editing. |
| Image attachments, audio recordings, and PDF documents | ✓ Clean transfer | Local assets resolve using standard relative paths and display inline in live preview. |
| Obsidian Community Plugins (.obsidian/plugins) | ✕ Unsupported | Third-party JavaScript plugins are not executed; the `.obsidian` directory is preserved untouched on disk. |
| Obsidian Canvas boards (.canvas files) | ✕ Unsupported | Infinite canvas files remain intact on your disk but are not rendered as interactive visual boards. |
Step-by-step migration procedure
Follow this sequence to export your Obsidian library safely and open it in Oyma without data loss:
Back up your Obsidian vault directory (optional preflight safety)
Before opening your vault in any new application, make a quick copy of your vault directory or ensure your macOS Time Machine backup is current. Oyma never alters your files destructively, but a backup is sound digital hygiene.
Launch Oyma and click 'Open vault...'
Launch Oyma on your Mac. From the welcome screen, select 'Open vault...' (or press ⌘O and select 'Open folder'). Select your existing Obsidian vault directory in Finder.
Instant vault mounting with zero conversion
Oyma reads your files directly in place. There is no file import, database ingestion, or format conversion. Your existing `.obsidian` configuration folder is completely ignored and left intact.
Experience fluid editing and botless meeting capture
Your notes, wikilinks, callouts, and daily notes are instantly available. You can now record meetings without bots directly into your notes via macOS ScreenCaptureKit, with speech transcribed 100% on-device via local Whisper models.
Known conversion gaps and practical workarounds
Every proprietary note system utilizes features that have no 1:1 equivalent in plain Markdown. Here is how to navigate Obsidian's structural limitations:
- Community plugins are not supported: Oyma does not execute community JavaScript plugins from your `.obsidian/plugins` folder, eliminating security attack surfaces and memory bloat.
- Canvas files are not rendered: `.canvas` files remain untouched on disk but do not display as interactive visual boards inside Oyma.
- CSS snippets are not applied: Custom CSS snippets in `.obsidian/snippets` are not loaded; Oyma uses a refined, native macOS typography system.
Frequently asked questions
- Does opening my vault in Oyma modify or break my Obsidian setup?
- No. Oyma treats your files as standard plain Markdown and leaves your `.obsidian` configuration folder completely untouched. You can even run Obsidian and Oyma side-by-side on the exact same folder without conflict.
- What happens to my Obsidian [[WikiLinks]] and daily notes?
- They work immediately. Oyma natively understands `[[WikiLinks]]`, piped aliases (`[[Note|Alias]]`), heading autocompletion (`[[Note#Heading]]`), and daily note templates. When you rename a note in Oyma, all links pointing to it are automatically updated.
- Why switch to Oyma if I already use Obsidian?
- While Obsidian is an exceptional extensible editor, adding meeting recording, transcription, and AI summaries requires assembling complex chains of brittle third-party plugins, paid SaaS subscriptions ($140–$299/year), and external cloud bots. Oyma provides native botless meeting capture, on-device Whisper transcription, and private AI summaries built directly into a high-performance Mac app.
- Can I switch back to Obsidian at any time?
- Yes, instantly. Because Oyma stores all notes as standard plain Markdown files on your disk with zero proprietary wrappers, opening your vault back in Obsidian requires zero export steps. Your notes were never locked in.
Complete your migration to Oyma.
Your notes remain plain files on your Mac. Open your vault and experience lightning-fast editing.