Migrate OneNote notebooks to local Markdown on Mac

Microsoft OneNote is one of the longest-standing digital notebook applications in computing history. Shipped as part of the Microsoft Office suite, OneNote pioneered the digital binder metaphor: dividing knowledge into color-coded Notebooks, Section Groups, Sections, and multi-tier sub-pages.

For enterprise knowledge workers, academic students, engineers, and project managers, OneNote provided a reliable canvas for taking lecture notes, pasting meeting screenshots, organizing project binders, and writing research outlines.

However, as personal computing and modern workflows evolved, OneNote users increasingly encounter severe structural obstacles:

First, the proprietary binary container format and OneDrive lock-in. OneNote does not store documents as accessible files on your computer. Instead, it encapsulates pages inside proprietary binary files (.one and .onetoc2) stored on Microsoft OneDrive. You cannot open these files in external text editors, back them up with standard macOS tools, or run command-line search scripts across your notes.

Second, clunky macOS performance and bloated synchronization. The OneNote for Mac client is notorious for heavy memory consumption, slow search indexing across large notebooks, and frequent OneDrive synchronization conflicts (“Page has conflicts with another version”).

Third, absence of modern knowledge management primitives. OneNote has no bidirectional [[WikiLinks]], no backlinks panel, no dynamic knowledge graph, and no integrated on-device meeting transcription. It remains stuck in the rigid, hierarchical notebook paradigm of the early 2000s.

Migrating your OneNote library to sovereign local Markdown (.md) in Oyma modernizes your knowledge base: freeing your files from Microsoft’s cloud silo, restoring lightning-fast local performance, and unlocking the power of interconnected knowledge on macOS.

The architectural chasm: proprietary binary blocks vs open text files

To understand why migrating to Oyma revitalizes your note-taking experience, consider how OneNote stores your data:

1. Inside Microsoft’s proprietary container model

OneNote treats a page not as a document, but as an infinite, two-dimensional coordinate canvas:

• Disjointed text frames: Clicking anywhere on a OneNote page creates an independent floating text container. While visually flexible, this creates unstructured text fragments that are difficult to parse programmatically.
• Binary encapsulation: Notebook sections are stored in Microsoft’s proprietary .one binary format. Only Microsoft applications can read and render these files.
• Mandatory cloud syncing: You cannot save local notebooks on macOS; OneNote for Mac forces all notebooks to sync through a Microsoft OneDrive or SharePoint cloud account.

2. Oyma‘s clean, linear Markdown architecture

Oyma adopts a modern, file-first approach:

• Every document is a standard .md file stored directly on your local Mac disk.
• Content follows structured CommonMark standards: clear heading hierarchies, standard lists, and clean tables.
• All files are accessible directly in Finder, version-controllable via Git, and fully searchable offline with local SQLite FTS5.
• Zero network dependencies: your notes are completely yours, whether online or completely air-gapped.

Comprehensive transfer matrix: what moves from OneNote

Using modern conversion tools, OneNote notebooks translate into clean, organized Markdown directories:

OneNote Feature	Conversion Status	Result in Oyma & Local Storage
Body text & heading styles	Clean	Converted to standard #, ##, ### CommonMark headers and paragraphs.
Bulleted & numbered lists	Clean	Preserved with standard markdown indentation and task checkboxes (- [ ]).
Images, screenshots & scans	Clean	Extracted as discrete PNG/JPEG files in local assets/ folders and linked via relative paths.
Notebook sections & groups	Clean	Converted to native macOS directories and subdirectories mirroring your notebook binder.
OneNote tables	Partial	Converted to standard GitHub Flavored Markdown (GFM) pipe tables.
Digital ink & hand drawings	Partial	Flattened into high-resolution PNG image attachments; vector strokes are not editable.
Audio clips & recordings	Clean	Extracted as standalone audio files; transcribe them locally in Oyma with Whisper.
Math equations (MathML)	Partial	Converted to standard LaTeX / KaTeX math blocks ($...$ and $$...$$).
OneDrive sharing permissions	Unsupported	Microsoft cloud metadata is stripped; notes become sovereign local text files.

Step-by-step migration playbook: from OneNote to Oyma

Because OneNote for Mac restricts bulk local export, the following procedure uses proven tools to extract your notebooks cleanly:

Step 1: Export notebooks via OneNote Online

1. Open your web browser and navigate to OneNote Online (notebooks.office.com).
2. Log in with your Microsoft personal or business account.
3. In the notebook list, locate the notebook you wish to migrate.
4. Right-click the notebook title (or click the three dots) and select Export notebook.
5. Microsoft will generate and download a .zip archive containing the raw section files for that notebook.
6. Repeat for any other notebooks you want to migrate.

Step 2: Convert OneNote archives to Markdown

To convert the downloaded OneNote archive into clean Markdown, use one of the following open-source converters:

Option A: OneNote-to-Markdown CLI (Recommended)

Use the open-source community tool onenote-to-markdown:

# Install via npm or python
npm install -g onenote-to-markdown

# Convert your unzipped notebook folder to clean Markdown
onenote-to-markdown --input ~/Downloads/MyNotebook --output ~/Documents/Notes/OneNote-Vault

Option B: Obsidian Importer (Graphical interface)

If you have Obsidian installed on your Mac, use the official Importer plugin:

1. In Obsidian, install the community Importer plugin.
2. Select Microsoft OneNote as the source format.
3. Sign into Microsoft or select your exported .one files.
4. Set the destination directory to a local folder (e.g., ~/Documents/Notes/OneNote-Vault).
5. Click Import. The tool automatically converts all pages to CommonMark .md files and extracts all attachments.

Step 3: Review and clean up converted notes

Open the destination folder in Finder. You will find:

• Your OneNote section groups and sections mapped to standard folders.
• Every page saved as an individual .md file.
• Embedded screenshots and images stored neatly in accompanying asset folders.

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 your converted OneNote directory.

Oyma instantly mounts your entire library:

• Every note renders in our fluid live-preview editor with native typography.
• SQLite FTS5 search enables sub-50ms full-text searching across thousands of pages.
• You can create bidirectional links between notes using [[WikiLinks]].
• You can begin recording meetings without bots directly into your notes via ScreenCaptureKit.

What Oyma adds to your OneNote workflow

Migrating from OneNote to Oyma transforms a static, legacy binder into an active, interconnected intelligence hub:

1. Bidirectional [[WikiLinks]] and visual Graph View

OneNote’s page links were brittle and prone to breaking when notebooks were reorganized. Oyma provides robust [[WikiLinks]] with heading autocompletion and automatic rename rewriting. Connecting notes together builds an interactive, force-directed Graph View revealing hidden relationships across your work.

2. High-performance spreadsheet tables

OneNote tables are rudimentary text boxes that lack formulas, sorting, and keyboard navigation. Oyma provides spreadsheet-like tables with Tab/Enter cell traversal, column sorting, Excel/Numbers clipboard paste, and image insertion—all saved as standard Markdown on disk.

3. Native botless meeting capture and transcription

OneNote offered basic audio recording, but could not transcribe or summarize calls. Oyma records meetings directly on your Mac using ScreenCaptureKit—capturing both microphone and system audio without sending a bot to your Zoom, Google Meet, or Teams call. On-device Whisper models transcribe conversations locally, and private LLMs extract key decisions and action items directly into your notes.

Permanent freedom for your knowledge

Your accumulated notebooks represent years of hard work and intellectual effort. Entrusting them to a proprietary cloud format leaves you vulnerable to service changes and subscription lock-in.

By converting your OneNote library to standard Markdown in Oyma, you secure permanent access to your intellectual property on open, timeless standards designed to last.

What transfers from Microsoft OneNote to local Markdown

Migrating from Microsoft OneNote 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 Microsoft OneNote library safely and open it in Oyma without data loss:

1. Export your OneNote notebooks via OneNote Online or OneNote for Windows/Mac

   Because OneNote for Mac restricts bulk local export, log into OneNote Online (notebooks.office.com). Under 'My Notebooks', right-click your notebook and select 'Export notebook'. This downloads a compressed zip package of your entire notebook hierarchy. Alternatively, use the open-source OneNoteMD or Pandoc converter.

2. Convert OneNote sections into Markdown using an open-source converter

   Run an open-source converter such as OneNote-to-Markdown or the community OneNote parser. The tool unpacks `.one` section files, translates HTML text boxes into CommonMark (.md), extracts media assets, and builds a standard folder hierarchy.

3. Normalize freeform canvas layout into linear Markdown prose

   OneNote allows placing text boxes anywhere on an infinite 2D canvas. The converter serializes these disjointed boxes sequentially. Review complex multi-column notes to ensure logical top-to-bottom reading order.

4. Open the folder directly in Oyma

   Launch Oyma, select 'Open vault', and choose your converted directory. Oyma builds an on-device SQLite full-text search index instantly, displaying your entire notebook collection 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 Microsoft OneNote's structural limitations:

• Infinite freeform canvas layout: OneNote allows typing anywhere on an infinite page; Markdown organizes text linearly from top to bottom.
• Mac desktop export restriction: Microsoft's macOS app lacks a native 'Export Notebook' button; exporting requires using OneNote Online or third-party conversion tools.
• Ink handwriting vector data: Surface Pen and stylus ink notes export as rasterized PNG images rather than editable vector strokes.

Frequently asked questions

Why is Microsoft OneNote difficult to export on a Mac?

Microsoft stores OneNote notebooks on OneDrive using proprietary cloud synchronization protocols (`.one` and `.onetoc2` binary container files). The Mac desktop client does not expose a bulk export menu, requiring users to export notebooks via OneNote Online or utilize open-source automated conversion scripts.

What happens to OneNote's multi-tier hierarchy (Notebook → Section Group → Section → Page)?

When converted to Markdown, this hierarchy translates cleanly into standard macOS folders: the Notebook becomes the root folder, Section Groups become parent folders, Sections become subfolders, and Pages become individual `.md` files.

Can I transcribe embedded OneNote audio memos in Oyma?

Yes. When audio clips are extracted during conversion, Oyma's built-in file transcription feature allows you to transcribe them 100% locally on your Mac's Neural Engine using on-device Whisper models.

How does Oyma protect my notes compared to Microsoft OneDrive?

OneNote stores your documents on Microsoft cloud servers where they are subject to corporate scanning, enterprise administrative visibility, and cloud policy changes. Oyma operates strictly on-device on Apple Silicon: your files remain on your local disk with zero cloud data transmission.