Migrate Apple Notes to local Markdown on Mac

Apple Notes comes pre-installed on every Mac, iPhone, and iPad. For millions of macOS users, it is the natural starting point for digital note-taking: launching instantly, syncing effortlessly via iCloud, and supporting rich features like Apple Pencil sketching, document scanning, and quick checklist creation.

However, as personal and professional note archives grow, users inevitably encounter Apple Notes’ frustrating architectural boundaries:

First, the proprietary database silo. Your notes do not exist as standard files in Finder. Instead, they are locked inside Apple’s internal Core Data SQLite database located in ~/Library/Group Containers/group.com.apple.notes/. You cannot open them in external editors, version control them with Git, or process them with command-line tools.

Second, the lack of bidirectional linking. Apple Notes added basic page links in macOS Sonoma, but it lacks the rich, dynamic interconnectedness of [[WikiLinks]], backlinks panels, and visual knowledge graphs essential for managing complex interconnected projects.

Third, the absence of meeting transcription and AI summaries. Apple Notes cannot record call audio from Google Meet, Zoom, or Slack, nor can it transcribe conversations on-device or generate structured meeting notes with action items.

Migrating your Apple Notes archive to sovereign local Markdown (.md) in Oyma gives you the best of both worlds: the elegance and speed of native macOS design, combined with the permanent freedom of plain text files.

The architectural reality of Apple Notes: Core Data vs plain files

To understand why migrating to Oyma transforms your workflow, consider how Apple Notes manages your information:

1. Inside Apple’s closed database

When you write a note in Apple Notes, macOS saves your text as an encoded binary blob (using Protocol Buffers and Core Data) inside a local SQLite database:

• No file transparency: You cannot browse your notes in Finder or back them up individually.
• No external tool support: You cannot use VS Code, Sublime Text, or terminal grep to query your documents.
• Export restrictions: Apple allows you to export a single note as a PDF, but deliberately provides no mechanism to export your entire library into open file formats.

2. Oyma‘s open file-system philosophy

Oyma adopts an opposite, file-first architecture:

• Every note is a standard .md text file stored in a folder you choose on your Mac.
• You can move, rename, copy, and organize files directly in Finder.
• Backing up your vault is as simple as copying a folder or letting macOS Time Machine back up your drive.
• Your documents remain readable on any device, now and decades into the future, without needing Oyma or any specific software installed.

Comprehensive transfer matrix: what moves from Apple Notes

Using modern export tools, nearly every element of your Apple Notes library converts cleanly to Markdown:

Apple Notes Feature	Conversion Status	Result in Oyma & Local Storage
Title headings & subheadings	Clean	Converted to standard #, ##, and ### CommonMark headings.
Checklists & to-do items	Clean	Converted to standard - [ ] and - [x] Markdown task items.
Bulleted & numbered lists	Clean	Preserved with standard markdown indentation.
Photos & image attachments	Clean	Extracted as standalone JPEG/PNG files in local folders and linked via relative paths.
PDF documents & scanned receipts	Clean	Extracted as discrete PDF files and linked via standard markdown syntax.
Apple Notes tables	Partial	Converted to standard GitHub Flavored Markdown (GFM) pipe tables.
Apple Pencil sketches	Partial	Exported as high-resolution raster PNG images; stroke vector data is flattened.
Audio recordings	Clean	Saved as local audio files; can be transcribed on-device in Oyma with Whisper.
Password-locked notes	Partial	Must be unlocked manually before export; encrypted notes are skipped by export tools.
Smart folders & query tags	Unsupported	Query logic is not exported; notes preserve their inline #tags.

Step-by-step migration playbook: from Apple Notes to Oyma

Because macOS lacks a built-in “Export All” button, the following procedure uses proven, privacy-preserving tools to extract your notes safely:

Step 1: Unlock any encrypted notes

Apple’s encryption protects notes with a local passphrase or Touch ID. Migration tools cannot read locked notes:

1. Open Apple Notes on your Mac.
2. Review your folders for notes displaying a lock icon.
3. Open each locked note, click the lock icon in the toolbar, and select Remove Lock.
4. (You can re-encrypt sensitive files later using local macOS disk encryption or encrypted disk images).

Step 2: Choose your export tool

We recommend two free, local-only export methods:

Method A: Exporter for Mac (Fastest, graphical interface)

1. Download Exporter from the Mac App Store (free utility by Chintan Ghate).
2. Launch Exporter and grant it permission to access Apple Notes.
3. Select Export format: Markdown (.md).
4. Click the export button and choose a destination folder on your Mac (e.g., ~/Documents/Notes/Apple-Notes-Vault).
5. Exporter will process your entire library, replicating your folder structure and extracting all attachments into subfolders.

Method B: apple-notes-exporter CLI (For advanced users)

If you prefer an open-source command-line tool, use apple-notes-exporter:

# Install via homebrew or github
brew install apple-notes-exporter

# Export notes directly to Markdown with attachments
apple-notes-exporter --format markdown --output ~/Documents/Notes/Apple-Notes-Vault

Step 3: Verify the exported files in Finder

Navigate to your destination directory in Finder. You will see:

• Your Apple Notes folders mapped 1:1 to native macOS folders.
• Every note saved as an individual .md file.
• Photos, drawings, and PDF scans stored neatly in accompanying subfolders.

Step 4: Open your vault in Oyma

1. Launch Oyma on your Mac.
2. From the welcome screen, select Open vault (or press ⌘O).
3. Select the folder containing your exported Apple Notes.

Oyma instantly mounts your notes:

• Your notes appear in our fluid live-preview editor, with zero latency.
• Internal links between notes can be created effortlessly using [[WikiLinks]].
• Local SQLite FTS5 search enables instant full-text searching across your entire library.
• You can begin recording meetings without bots directly into your notes via ScreenCaptureKit.

Elevating your workflow beyond Apple Notes

Once your notes are liberated into plain Markdown in Oyma, you gain access to powerful capabilities designed for serious knowledge work:

1. Bidirectional linking and visual graph view

In Apple Notes, documents exist as isolated pages. In Oyma, you can link thoughts together using [[Note Title]] syntax. As you build connections, our interactive Graph View visualizes relationships across projects, revealing emergent patterns in your research.

2. High-performance spreadsheet tables

Apple Notes tables are basic text grids with limited formatting. Oyma provides full spreadsheet-like tables with Tab and Enter cell traversal, column sorting, Excel/Numbers clipboard paste, and image insertion—all saved as standard text on your disk.

3. Native botless meeting capture and transcription

Apple Notes offers no meeting intelligence. Oyma captures both sides of your audio calls on Zoom, Google Meet, Slack, or Teams without sending an awkward recording bot to the meeting. On-device Whisper models transcribe speech locally, and private LLMs extract key decisions and action items directly into your notes.

Permanent freedom for your ideas

Apple Notes is convenient, but your intellectual life shouldn’t be locked inside a proprietary database. By migrating to standard Markdown in Oyma, you preserve the clean simplicity of a Mac-native application while gaining complete ownership of your files.

What transfers from Apple Notes to local Markdown

Migrating from Apple Notes to sovereign Markdown (.md) preserves your core intellectual property while changing how formatting blocks are stored. Here is our empirically tested fidelity matrix:

Step-by-step migration procedure

Follow this sequence to export your Apple Notes library safely and open it in Oyma without data loss:

1. Unlock password-protected notes in Apple Notes

   Launch Apple Notes on your Mac. Locate any notes protected with a password or Touch ID, enter your credentials, and select 'Remove Lock'. Migration utilities cannot access notes while Apple's native encryption lock is engaged.

2. Export your notes library using Exporter or AppleScript

   Because Apple Notes lacks a native bulk export feature, use the free macOS app 'Exporter' (available on the Mac App Store) or an open-source AppleScript. Configure the exporter to preserve folder structures, convert notes to CommonMark (.md), and save attachments into local subfolders.

3. Inspect the exported folder structure on your Mac

   Open the destination directory in Finder. Verify that your iCloud folder hierarchy is reflected as native macOS folders, note titles match filenames, and images appear alongside their respective `.md` documents.

4. Open the folder directly in Oyma

   Launch Oyma, select 'Open vault', and choose your exported Apple Notes directory. Oyma instantly mounts your notes, builds a local SQLite full-text index, and displays your entire archive in our live-preview editor.

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 Apple Notes's structural limitations:

• Absence of native bulk export: Apple Notes only allows exporting one note at a time as a PDF. Using third-party tools like Exporter or AppleScript is required for bulk markdown conversion.
• Flattened vector drawings: Apple Pencil sketches export as static PNG images rather than editable vector strokes.
• Smart folder query loss: Dynamic smart folders do not translate into physical directories; organize notes using standard folders or frontmatter tags.

Frequently asked questions

Why doesn't Apple Notes have a built-in 'Export to Markdown' button?

Apple designs its default apps to encourage deeper integration into the Apple and iCloud ecosystem. Notes are stored in an internal SQLite database (`NoteStore.sqlite`) rather than exposed as loose files in Finder. Fortunately, macOS provides rich AppleScript automation APIs that allow tools like Exporter to extract notes cleanly.

What is the safest way to export Apple Notes to Markdown on Mac?

The most reliable, private method is using the free app 'Exporter' by Chintan Ghate (from the Mac App Store) or the open-source python tool `apple-notes-exporter`. Both tools run 100% locally on your Mac with zero internet access, converting your notes directly to standard `.md` files.

What happens to scanned documents and Apple Pencil drawings?

Document scans and sketches are extracted as clean image files (PDF or PNG) into an accompanying assets folder. In Oyma, these attachments display directly inline within your live-preview Markdown editor.

How does Oyma's privacy compare to iCloud Apple Notes?

While Apple Notes stores your notes on iCloud servers where corporate administrators or cloud synchronization can expose data, Oyma stores files strictly on your local disk. With Local-only mode enabled, network connections are completely blocked, ensuring total data sovereignty.