If you have ever pasted markdown into OneNote and watched your carefully structured document dissolve into a mess of hash marks, asterisks, and pipe characters, you are not alone. OneNote is one of the most popular note-taking applications in the world, with over 100 million monthly users across Windows, Mac, iOS, Android, and the web. It is deeply integrated into the Microsoft 365 ecosystem.
And it has absolutely zero native markdown support.
No import. No detection. No rendering. No plans from Microsoft to add it. This is the state of affairs in 2026, and it has been a source of frustration for technical users for years.
What happens when you paste markdown into OneNote
Let's be specific about what goes wrong, because the failures are comprehensive.
Headings become hash marks. Paste ## Project Status and OneNote displays exactly that: ## Project Status. The hash marks are treated as literal text. There is no heading style applied, no font size change, no structural hierarchy. Your carefully organized document outline becomes a flat wall of text with scattered # symbols.
Bold and italic show as asterisks. **important deadline** appears as **important deadline** with the asterisks visible. *emphasis* shows the asterisks. Your formatting intent is there in the raw syntax, but OneNote does not interpret it.
Tables become pipe characters. This is perhaps the most visually jarring failure. A markdown table like:
| Feature | Status |
|------------|----------|
| Auth | Complete |
| Billing | In progress |
Pastes into OneNote as four lines of pipe-separated text. No table structure, no cells, no borders. Just pipes and dashes rendered as plain characters. You would need to manually recreate the entire table using OneNote's built-in table tool.
Code blocks show literal backticks. Fenced code blocks (triple backticks) paste as text with the backtick characters visible. Inline code (single backticks) does the same. There is no monospace formatting, no syntax highlighting, no visual distinction between code and prose.
Lists lose their structure. Markdown list markers (-, *, 1.) are treated as literal characters. OneNote does not convert them to its native bullet or numbered list format. Nested lists, which depend on indentation in markdown, become particularly unreadable.
Links display as bracket syntax. [click here](https://example.com) shows up as that exact string. No hyperlink is created. The URL is visible but not clickable without manual editing.
In short, pasting markdown into OneNote gives you the raw source code of your document instead of the rendered result. Every formatting instruction is exposed as visible syntax.
Why Microsoft has not added markdown support
This is the part that frustrates technical users the most. Microsoft knows that people want markdown support in OneNote. The feature has been one of the most requested items on the Microsoft 365 feedback portal for years. Community threads on Reddit, Microsoft Answers, and the OneNote UserVoice forum are full of requests, workarounds, and complaints.
Microsoft has never committed to implementing it. The closest acknowledgment has been vague statements about "considering" the feature.
There are a few likely reasons. OneNote uses a freeform canvas model rather than a linear document model. Content can be placed anywhere on the page, in text boxes that can be moved, resized, and overlapped. This spatial approach is fundamentally different from markdown's linear, block-based structure. Adding markdown detection to a canvas-based editor introduces significant design challenges.
There is also the question of audience. OneNote's core user base includes students, meeting note-takers, and general knowledge workers. Most of them have never heard of markdown. Adding markdown detection could confuse non-technical users who type # at the start of a line and suddenly get a heading style they did not expect.
That said, the competitive landscape has shifted. Evernote now supports markdown input. Notion has native markdown shortcuts and full import/export support. Obsidian is entirely markdown-native. Bear, Typora, and Craft all support markdown. OneNote's refusal to acknowledge markdown is increasingly an outlier, and it is driving technically-inclined users toward alternatives.
The add-in workarounds
The community has built several tools to bridge the gap. None of them are as seamless as native support, but they work.
OneMark
OneMark is a OneNote add-in that renders markdown within OneNote pages. You write markdown in a OneNote text block, press F5, and OneMark converts it to formatted rich text in place. It supports GitHub Flavored Markdown (GFM), including tables, task lists, code blocks with syntax highlighting, LaTeX math expressions, and table of contents generation.
The workflow is: write your markdown in OneNote as plain text, then trigger the render. It is two-step rather than live, but it works reliably. OneMark is free for basic use, with a paid tier for advanced features.
The main limitation is that the conversion is one-directional per render. Once you press F5, the markdown source is replaced with rich text. If you need to edit, you are editing the formatted output, not the markdown source. Some users maintain a separate text block with the markdown source alongside the rendered version.
OneNote Gem (One Markdown)
OneNote Gem is a paid add-in suite that includes a "One Markdown" feature. It can convert markdown files to OneNote pages and export OneNote pages back to markdown. The add-in integrates into the OneNote ribbon and provides import/export buttons.
One Markdown handles standard markdown elements and some extended syntax. The export direction (OneNote to markdown) is particularly useful for users who want to extract their notes into a portable format. The add-in is Windows-only and requires a license purchase.
OneMore
OneMore is an open-source OneNote add-in with a broad feature set, including markdown support. It can convert markdown to formatted OneNote content and provides dozens of other utilities (page management, search, formatting tools). Being open-source, it is free and community-maintained.
The markdown feature in OneMore handles the basics: headings, bold, italic, links, lists, code blocks, and tables. It may not cover every GFM extension, but for standard markdown documents it produces clean results.
NoteWidget
NoteWidget takes a different approach by providing a standalone markdown editor that syncs with OneNote. You write in the markdown editor, and the formatted output appears in your OneNote notebook. This sidesteps the problem of OneNote not understanding markdown by keeping the authoring environment separate.
The conversion approach: render first, paste second
If you do not want to install add-ins, the most reliable workaround is to convert your markdown to formatted rich text before pasting into OneNote. This means rendering the markdown to HTML or rich text outside of OneNote, copying the rendered result, and pasting the formatted output.
OneNote handles rich text paste quite well. When you paste formatted content (from a browser, Word, or any application that copies rich text to the clipboard), OneNote preserves headings, bold, italic, links, tables, lists, and most structural elements. The problem is not that OneNote cannot display formatted content. The problem is that it cannot interpret markdown syntax to produce that formatting.
This is where Unmarkdown™ comes in. Select OneNote as your destination, and Unmarkdown™ converts your markdown to rich text specifically optimized for OneNote's rendering engine. The output is copied to your clipboard as formatted content that you can paste directly into OneNote.
The OneNote-specific conversion handles several elements that other destinations do not need to worry about.
All six heading levels. OneNote actually handles heading hierarchy better than Google Docs in some ways. Google Docs technically supports six heading levels but rarely uses anything beyond H3 in practice. OneNote renders all six levels with distinct visual weight, making deeply structured documents more readable.
Tables with proper cell structure. Instead of pipe characters, you get actual OneNote table cells with borders and alignment. The table is immediately editable within OneNote's table tools.
Code blocks with monospace formatting. Fenced code blocks paste as monospace-formatted text blocks, visually distinct from surrounding prose. Inline code receives the same monospace treatment.
Lists with native formatting. Bullet lists, numbered lists, and nested lists convert to OneNote's native list format with proper indentation and markers.
Links as clickable hyperlinks. Markdown link syntax converts to actual hyperlinks that you can click to open in a browser.
The workflow is straightforward: paste or write your markdown in Unmarkdown™, choose OneNote as the destination, copy, and paste into OneNote. The formatting transfers cleanly because you are pasting rich text, not markdown syntax.
When to use each approach
For occasional markdown documents: Use Unmarkdown™ or another external converter. The copy-paste workflow takes seconds and produces reliable results without installing anything in OneNote.
For writing markdown directly in OneNote: Install OneMark. The F5 render workflow lets you author in markdown and see formatted results without leaving OneNote.
For importing markdown files into OneNote: Use OneNote Gem (One Markdown) or OneMore. Both can batch-import .md files as formatted OneNote pages.
For a markdown-native experience: Consider whether OneNote is the right tool. If markdown is central to your workflow, Obsidian, Notion, or Bear will give you native markdown support without workarounds. OneNote excels at freeform note-taking, handwriting, audio recording, and Microsoft 365 integration. It does not excel at structured text authoring.
The broader problem
OneNote's lack of markdown support is a symptom of a larger issue: most productivity applications do not speak markdown. Google Docs has minimal detection (bold and italic only). Slack uses its own mrkdwn format that differs from standard markdown. Email clients ignore markdown entirely. Word has no markdown awareness.
This is the fundamental challenge that every AI user faces. AI tools output markdown because it is efficient and well-suited to language model training data. But the applications where that content ultimately lives, including OneNote, do not understand markdown natively.
Until Microsoft adds markdown support to OneNote (if they ever do), the workaround is the same as it is for every other non-markdown destination: convert the markdown to the format your destination expects before you paste it. The tools exist. The workflow is reliable. It just should not be necessary.
Related reading
- 5 Things That Break When You Paste AI Output (And How to Fix Each One)
- The AI Formatting Problem Nobody Talks About (And How to Fix It)
- How to Convert Markdown to Google Docs (3 Methods Compared)
- How to Convert Markdown to Word Without Pandoc
- OneNote Markdown: The Missing Feature Microsoft Won't Build
