OneNote to Markdown: 4 Methods to Export Your Notes (2026 Guide)

Microsoft OneNote is a powerful note-taking tool, but its proprietary format creates a real problem: your notes are locked into a closed ecosystem. Whether you want to use your notes in Obsidian, feed them into an AI model for analysis, or simply store them as plain text you can read without any software, you need to convert them to Markdown.

This guide covers four practical methods to convert OneNote to Markdown, from the easiest no-install approach to automation-friendly developer workflows. The first method — exporting as a Word document and converting online with file2markdown — is the only approach that works on both Mac and Windows without installing anything.

Why Convert OneNote to Markdown?

OneNote stores notes in a format that only Microsoft software can read. Converting to Markdown gives you several advantages:

• Portability: Plain .md files open in any text editor, on any device, forever.
• AI and LLM compatibility: Large language models like Claude and GPT-4 process structured Markdown far more effectively than raw OneNote exports. Clean headings, lists, and tables let the model understand the hierarchy of your notes.
• Interoperability: Tools like Obsidian, Notion, Confluence, and most documentation platforms accept Markdown natively.
• Version control: Markdown files work seamlessly with Git, letting you track changes to your notes over time.

For developers and researchers building RAG pipelines or AI workflows, this conversion is particularly valuable. Structured Markdown reduces token waste and improves retrieval accuracy compared to unformatted text dumps. See our guide on preparing documents for LLMs for more on why format matters.

Method 1: Export as DOCX, Then Convert Online (Mac + Windows)

This is the most universally applicable method. It requires no additional software and produces clean, AI-ready Markdown from any device.

Step 1: Export your OneNote page or section as a Word document.

In the OneNote desktop app, go to File → Export. Select the scope (page, section, or notebook) and choose Word Document (.docx) as the format. Save the file to your computer.

On OneNote for Mac, the export path is the same: File → Export → Word Document.

Step 2: Upload the .docx file to file2markdown.

Go to the free DOCX to Markdown converter. Drag and drop your exported Word file. The converter preserves headings, bullet lists, numbered lists, tables, and bold/italic formatting — the full structure of your notes.

Step 3: Copy or download your Markdown.

Within seconds you get clean, structured Markdown. Copy it directly into Obsidian, a code editor, or any Markdown-based tool. Download the .md file if you need to process it programmatically.

This path works because OneNote's DOCX export is high-quality — it preserves formatting that a direct text export would lose. Converting the resulting DOCX with file2markdown handles the format translation cleanly, including tables and nested lists that trip up other converters.

For converting entire notebooks this way, OneNote lets you export a full section as a single DOCX. If you need to convert many files at once, see our batch conversion guide.

Method 2: Obsidian Importer Plugin

If you are migrating your notes to Obsidian, this is the easiest path. The official Obsidian Importer plugin connects directly to your Microsoft account and converts all notebooks automatically.

1. Open Obsidian and go to Settings → Community Plugins → Browse.
2. Search for "Importer" and install the official plugin.
3. Open the Importer, select Microsoft OneNote, and sign in with your Microsoft account.
4. Choose the notebooks you want to import and click Import.

The plugin creates a folder structure in your Obsidian vault that mirrors your OneNote hierarchy. Pages become .md files, sections become folders, and notebooks become top-level folders.

The limitation is scope: this method is designed specifically for Obsidian. If you want Markdown files for a different purpose — AI workflows, documentation, or general archiving — you need a method that produces standalone .md files.

Method 3: OneNote to Markdown Exporter (Windows Only)

For Windows users who want a dedicated desktop tool, the open-source segunak/one-note-to-markdown application is a solid option. It connects directly to the OneNote desktop app via COM interop and exports notebooks, sections, and pages to individual Markdown files, including embedded images.

1. Download the application from the GitHub releases page.
2. Open the app while OneNote desktop is running.
3. Select the notebooks you want to export and choose an output folder.
4. Click Export.

This tool is Windows-only because it relies on the Windows COM interface. Mac users cannot use it.

Method 4: Export DOCX and Convert with Pandoc (Developers)

For developers who prefer command-line tools or need to automate conversions in a script, the classic approach is to export OneNote pages as DOCX files and then convert them with Pandoc.

pandoc input.docx -o output.md

To convert an entire folder of exported DOCX files to Markdown in one shot:

for f in *.docx; do pandoc "$f" -o "${f%.docx}.md"; done

Pandoc is free, handles most formatting correctly, and works on Mac, Windows, and Linux. The main tradeoff compared to Method 1 is setup: you need to install Pandoc and run commands in a terminal. For a comparison of Pandoc and web-based converters, see our Word to Markdown guide.

Which Method Should You Choose?

Method	Platform	Best For
Export DOCX + file2markdown	Mac + Windows + Linux	AI workflows, quick conversion, no install
Obsidian Importer plugin	Mac + Windows	Migrating entire notebook to Obsidian
OneNote MD Exporter	Windows only	Bulk export with images, offline
Export DOCX + Pandoc	Mac + Windows + Linux	Automation, scripting, batch workflows

For most users, Method 1 (DOCX export + file2markdown) is the best starting point. It works on every platform, requires no installation, and produces clean Markdown that works well in AI tools like Claude and ChatGPT.

If you are specifically migrating to Obsidian, Method 2 is more convenient. If you need images preserved and are on Windows, Method 3 is worth the setup. If you are building an automated pipeline, Method 4 gives you full scripting control.

Frequently Asked Questions

Can I convert OneNote to Markdown on a Mac?

Yes. The most reliable Mac-compatible method is to export your OneNote pages as .docx files and then use the DOCX to Markdown converter at file2markdown. The Obsidian Importer plugin also works on Mac. The OneNote MD Exporter desktop app is Windows-only.

Does OneNote support native Markdown export?

No. As of 2026, Microsoft OneNote does not have a built-in Markdown export option. The methods above work around this limitation by using an intermediate format (usually DOCX) or third-party tools.

What is the best way to prepare OneNote notes for AI tools?

Export your notes as DOCX and convert them to Markdown using file2markdown. The resulting structured Markdown — with proper headings, lists, and tables — gives AI models like Claude, ChatGPT, or Gemini a much cleaner input than raw text. For more detail on how Markdown improves LLM accuracy, see our post on Markdown for RAG pipelines.

Can I convert an entire OneNote notebook at once?

Yes. In OneNote desktop, go to File → Export and select the full notebook (not just a page) before exporting. This creates a DOCX file containing all sections. Upload that to file2markdown to get a single Markdown file, or use Pandoc's batch script to create one .md file per section. The Obsidian Importer also imports entire notebooks in one step.