Free browser tool · zero cloud lock-in

OneNote Export Preparation Checker

Audit available OneNote export paths across platforms, account types, and complex notebook hierarchies.

Runs 100% locally in your browser. Diagnose exact OneNote export feasibility across Windows, Mac, and web accounts. Detect tenant export policy blocks, missing .onepkg options, and content risks before migrating to plain Markdown notes.

Step 1: Environment & Content Configuration

Select your operating system, OneNote client version, and special content types in your notebooks.

Content Risk Indicators:
Direct Native Export AvailableWindows OneNote Desktop 365 supports full *.onepkg package export

Your configuration has complete native support for notebook packaging. You can export the entire notebook into a .onepkg container, which preserves section hierarchy, embedded attachments, and internal page links for local conversion.

Verified Export Formats:
  • OneNote Single File Package (*.onepkg)
  • OneNote Section (*.one)
  • PDF Document (*.pdf)
Preservation & Policy Warnings:
  • Digital ink drawings cannot convert to editable Markdown. They will be rasterized to static PNG images or omitted.
Actionable Migration Preparation Plan
CategoryStatusStep TitleInstructionMenu Path / Command
clientmandatoryForce Full Notebook SynchronizationRight-click the notebook title in OneNote Desktop and click "Sync This Notebook Now". Verify that all page status icons show a green checkmark before exporting.—
conversionmandatoryExport Full Notebook Package (.onepkg)Go to File > Export > 1. Export Current: Notebook > 2. Select Format: OneNote Package (*.onepkg) > Click Export. Choose a safe local directory.File > Export > Notebook > OneNote Package (*.onepkg)
conversionrecommendedRun OneNoteMdExporter or pandoc ConverterExecute OneNoteMdExporter (open-source C# CLI) on Windows to convert pages directly into Obsidian-compatible Markdown with frontmatter and local assets folder.OneNoteMdExporter.exe -i "Engineering Vault.onepkg" -o "./MarkdownVault"

Step 2: Notebook Hierarchy & TOC Inspector

Paste your notebook structure or outline to audit section grouping depth, subpage levels, and filename legality.

4Sections
6Pages
2Subpages
4Max Hierarchy Depth
Input Notebook Table of Contents
Hierarchy & Path Compliance Audit
TypeDepthNamePreservation Risk
notebook0Engineering VaultClean
section-group1Hardware ArchitectureClean
section2Audio SubsystemClean
page3Core Audio OverviewClean
subpage4Low Latency BuffersClean
subpage4SIMD ResamplingClean
page3Bluetooth Codecs & HFPClean
section2Power & Battery BenchmarksClean
page3M1 vs M2 Drain ComparisonClean
section-group1Software & StorageClean
section2SQLite FTS5 EngineClean
page3Schema MigrationsClean
page3Database Vacuum StrategyClean
section2Security & TCC EntitlementsClean
page3Microphone Permissions on macOSClean

Why OneNote Migration Is Uniquely Difficult

Unlike apps that store notes as individual files on your local drive, Microsoft OneNote organizes notebooks in proprietary binary containers (.one files) synchronized via Microsoft's cloud protocols. Moving to plain Markdown requires navigating distinct technical hurdles:

  • Client Discrepancies: Only the legacy Win32 Windows OneNote Desktop application contains the native export engine capable of generating .onepkg single-file packages. The macOS client, mobile apps, and modern web interfaces lack local packaging engines entirely.
  • Enterprise Tenant Policy Locks: In corporate and academic environments (M365 Business, GCC High), Microsoft removes the right-click "Export notebook" option on OneDrive for Business to prevent data exfiltration. Users on Mac laptops with corporate accounts frequently discover they have zero bulk export pathways.
  • Vector Ink vs Plain Markdown: OneNote stores digital pen strokes as proprietary vector math with pressure and velocity points. Markdown has no digital ink primitives; ink must either be flattened to raster bitmap images or lost.
  • Subpage Nesting: OneNote supports up to three levels of page hierarchy (Page > Subpage > Sub-subpage). File-based Markdown note applications (such as Obsidian) maintain flat files inside folders, requiring subpages to be restructured as sibling notes or subfolders.

Recommended Migration Paths by Platform

Depending on your hardware and account configuration, follow these verified migration paths:

  1. Windows + Desktop 365: Open your notebook > File > Export > Notebook > OneNote Package (*.onepkg). Run an open-source converter such as OneNoteMdExporter to convert pages into CommonMark notes with relative asset folders.
  2. Mac + Personal Account: Navigate to onedrive.live.com in a desktop browser. Right-click the notebook in your Documents folder > select Export notebook. Download the .zip package containing raw .one section files, and unpack them using Python's onenote-to-markdown CLI.
  3. Mac + Enterprise M365 Tenant: Because web export is blocked and macOS lacks export menus, borrow a Windows PC to sync the corporate account and create a .onepkg, or copy non-sensitive sections to a personal notebook if tenant sharing allows.

Related Migration & Vault Tools

Explore companion offline utilities for inspecting note collections and planning migrations:

Frequently Asked Questions

Questions

Can I export a OneNote notebook as a .onepkg file on a Mac?

No. The macOS OneNote app does not support exporting full notebooks or sections into .onepkg or .one formats. It only allows printing individual pages to PDF. Mac users must log into onedrive.live.com in a web browser using a personal Microsoft account to export a .zip package, or perform the export from a Windows PC.

Why does OneNote Online lack an "Export notebook" button on my work or school account?

Microsoft 365 Business, Enterprise, and Education tenants disable the right-click "Export notebook" feature on OneDrive for Business by policy. If your account is managed by an enterprise tenant, you must open the notebook in the Windows OneNote Desktop app to export a .onepkg, or copy sections to a personal account if your IT policy allows external sharing.

What happens to stylus handwriting and drawings when moving to Markdown?

Digital ink cannot be converted to editable text or Markdown. Migration tools either rasterize ink strokes into static PNG image files or lose them entirely. We recommend reviewing handwritten pages and exporting them separately as high-resolution PDFs before migrating.

How does OneNote multi-level page indentation map into Markdown vaults?

OneNote allows pages and indented subpages. In plain Markdown filesystems, child notes do not exist inside other note files. Subpages must either be flattened into regular sibling notes with title prefixes or organized into separate nested subfolders.

Does this checker require signing into Microsoft or uploading notebooks?

No. The diagnosis runs 100% locally in your browser memory. You do not sign into Microsoft, enter credentials, or transmit notebook contents over the internet.

Keep your notes private, portable, and fast

Write your daily records in clean, future-proof plain Markdown on your local disk with zero cloud lock-in.

onenote export preparation checker downloadDownload for Mac

No account needed. Intel Mac build