OneNote Markdown: Does OneNote Support Markdown?

No. OneNote Markdown support doesn't exist natively in any current version: Windows, Mac, web, iPad, iPhone, or Android. Type # Heading or **bold** and OneNote keeps the symbols as plain text. This guide gives you two workflows that work on every platform, covers the Windows-only add-ins, and shows how to get notes out of OneNote as Markdown.

Does OneNote Support Markdown in 2026?

As of September 2026, no version of OneNote parses Markdown. A January 2025 Microsoft Q&A thread confirms this: a Mac user asked for native support and was told that add-ins "exist only on Windows". A June 2025 Tech Community thread asking for the same feature was still collecting replies in 2026 with no change announced.

What OneNote does have is a handful of auto-format shortcuts that look Markdown-adjacent. Per Microsoft's OneNote keyboard shortcut reference, the Mac app starts a bulleted list when you type * and press the spacebar. Typing 1 and the spacebar starts a numbered list.

On Windows, Ctrl+Period toggles a bulleted list, Ctrl+Slash a numbered list, and Ctrl+Alt+1 through 6 apply heading styles. Those are the whole of it. Headings, links, code, quotes, and tables written in Markdown syntax stay as literal text.

The gap matters more now than it did five years ago, in our view. Every AI assistant answers in Markdown, so pasting a ChatGPT or Copilot response into OneNote produces asterisks and pipes instead of formatting. That complaint is what opened the Tech Community thread.

What Happens When You Paste Markdown Into OneNote?

Nothing converts. A pasted block like this:

## Sprint notes

- **Done:** billing page
- *In progress:* invoice migration

| Task | Owner |
|---|---|
| QA pass | Priya |

lands in OneNote as the same characters: two hashes, asterisks, hyphens, and a row of pipes and dashes. OneNote doesn't recognise a fenced code block either; the backticks stay and the content is set in the page's default font. The forum threads above describe exactly this result, with tables from AI answers arriving as rows of pipes.

That behaviour is the same in the Windows desktop app, the web app, and the mobile apps. If you want formatted notes, you need to convert the Markdown before it reaches OneNote.

Workflow 1: Render Markdown, Then Paste Into OneNote

The Markdown OneNote workflow that works on every platform is to render the Markdown somewhere else and paste the rendered result. OneNote accepts rich text from the clipboard and maps headings to its own heading styles, bold and italic to formatting, lists to lists, and tables to OneNote tables.

1. Write or paste your Markdown into the editor.
2. Select everything in the preview pane and copy it.
3. Click into a OneNote page and paste.

Try it with the note below. Copy from the preview side, not the Markdown side, and paste into OneNote.

Headings paste as styled text, the list keeps its bullets, and the table arrives as an editable OneNote table. Code blocks are the weak spot: expect monospace text without the background, and don't count on syntax highlighting carrying over. Check images after pasting, since the web app handles remote images less reliably than the desktop app.

One limitation to plan around: OneNote's paste is only as good as the HTML on the clipboard. Copying from the raw Markdown pane pastes Markdown, not formatting, so the copy has to come from the rendered preview.

Workflow 2: Convert Markdown to DOCX for OneNote

When the document is long, or when you want to keep a file on disk as well, go through Word. Convert the Markdown to a .docx with the Markdown to DOCX converter, open it in Word, select all, copy, and paste into OneNote. The formatting survives the same way as in Workflow 1, and you also have a Word file for anyone who doesn't use OneNote.

There are two ways to get a Word file into OneNote and only one of them is useful for Markdown. Insert, then File Printout places a picture of the document's pages on the note. You can annotate it and copy text out of it, but you can't edit it as notes. Copy-and-paste from Word, on the other hand, gives you editable text. Use paste for Markdown notes and printouts for reference documents you don't intend to change.

The general methods for producing the .docx (Pandoc, Word's own import, online converters) are covered in the Markdown to Word guide. This post only needs the paste step on the OneNote side.

Windows-Only OneNote Markdown Add-ins

If you're on Windows with the desktop OneNote (not the Store app), two OneNote Markdown add-ins bring the syntax closer to native.

OneMark is a commercial add-in that converts Markdown as you type. Per its product page, it supports GitHub Flavored Markdown with code blocks, LaTeX, and a table of contents. It renders the current line when you press Enter and can re-render the whole page with F5. It ships standard and 64-bit installers for Windows only.

OneMore is a free, open-source add-in (MPL-2.0) with more than 240 commands. Its edit commands include Convert Markdown, which "converts selected text or all text on the page from markdown to OneNote format", Copy as Markdown, and Preview Markdown. The workflow is paste raw Markdown, select it, run Convert Markdown. It's the one we'd install first because it also handles the reverse direction.

Neither add-in runs on macOS, the web app, or mobile, which is why the two paste workflows above come first in this guide.

Can I Convert OneNote to Markdown?

Yes, with limits. The OneNote Markdown export question usually comes up when moving to Obsidian, Joplin, or Notion, and the tools are Windows-only because they read notebooks through the desktop OneNote application.

• OneMore's Copy as Markdown copies a page or selection as Markdown to the clipboard. Good for a handful of pages.
• onenote-md-exporter exports whole notebooks. It needs Windows 10 or later, the desktop OneNote (2013 or newer, not the Store version), and Word 2013 or newer. It writes a folder hierarchy of Markdown files with images and attachments, with an Obsidian-friendly layout and a separate Joplin raw format.
• Manual copy and paste into the editor with the HTML-to-Markdown tool works on any platform for a page at a time. Paste the OneNote content, then check the Markdown pane for headings and tables that need tidying.

Whichever route you take, expect to fix two things afterwards: OneNote's free-positioned text containers become sequential paragraphs, and ink or drawings don't export at all. If Obsidian is the destination, the Obsidian Markdown cheat sheet covers the wikilink and callout syntax you'll want to add once the files are in.

OneNote vs Notion and Obsidian for Markdown

As a freeform canvas app, OneNote was never built around plain text, and its lack of Markdown follows from that design. Notion converts Markdown shortcuts as you type and imports .md files; the Notion Markdown guide covers its quirks. Obsidian stores every note as a plain .md file on disk.

If Markdown is central to how you write, one of those is a better home. If you need OneNote for its handwriting, page canvas, or Microsoft 365 integration, the paste workflows above are a reliable bridge.

OneNote Markdown FAQ

OneNote Markdown support isn't coming from Microsoft any time soon, but the workaround takes seconds. Write in Markdown, render it in the editor, copy the preview, and paste it into your notebook with headings, lists, and tables intact. Windows users can add OneMore for in-app conversion and for getting notes back out as Markdown when it's time to move.