OneNote markdown support does not exist. Not partially. Not in beta. Not behind a feature flag. In February 2026, across every version of Microsoft OneNote (Windows, Mac, iOS, Android, and web), there is zero native markdown support. No detection, no rendering, no import, no export.
This is not an obscure gap. Thousands of users have requested it. The feature request accumulated massive vote counts on Microsoft's now-deprecated UserVoice feedback platform. The demand has only grown as AI tools have made markdown the default format for generated content. Every major AI assistant, including ChatGPT, Claude, Gemini, and Copilot (Microsoft's own AI), outputs markdown. And Microsoft's own note-taking application cannot render it.
What happens when you paste markdown into OneNote
The failures are comprehensive. Every markdown formatting element that AI tools produce is ignored by OneNote.
Headings display as hash marks. Paste ## Project Status and OneNote shows ## Project Status as literal text. No heading style is applied. No font size change. No structural hierarchy. A document with 10 sections becomes 10 lines with # or ## prefixes that look like formatting errors to anyone unfamiliar with markdown.
Bold and italic show as asterisks. **critical deadline** appears with the asterisks visible. *emphasis* shows its asterisks too. The formatting intent is clear to anyone who reads markdown, but OneNote makes no attempt to interpret it.
Tables become pipe characters. A markdown table with rows and columns pastes as lines of pipe characters, dashes, and text. No table is created. No cells, no borders, no alignment. For data-heavy AI output, this is the most destructive failure because manually recreating a table in OneNote takes significant time.
Code blocks show backticks. Fenced code blocks (triple backticks) paste with the backtick characters visible. Inline code (single backticks) does the same. There is no monospace formatting applied, no visual distinction between code and prose, and no syntax highlighting.
Lists remain as plain characters. Markdown list markers (-, *, 1.) are treated as literal text. OneNote does not convert them to its native bullet or numbered list format. Nested lists, which use indentation in markdown, become flat text with varying levels of leading whitespace.
Links display as bracket syntax. [click here](https://example.com) appears exactly as written. No hyperlink is created. The URL is visible but not clickable.
In short, pasting markdown into OneNote gives you the raw source code of your document. Every formatting instruction is exposed as visible syntax characters. The document is less readable than it was in the AI chat window.
Why Microsoft has not added OneNote markdown support
The absence of markdown in OneNote is not an oversight or a resource constraint. It reflects fundamental architectural decisions and strategic priorities.
The canvas model is incompatible with markdown
OneNote uses a free-form canvas layout. Content can be placed anywhere on the page. Text boxes, images, handwritten notes, audio recordings, and file attachments can overlap, be positioned side by side, or be scattered across the canvas. There is no enforced top-to-bottom flow.
Markdown, by contrast, is inherently linear. Content flows top to bottom. Elements appear in sequence: a heading, followed by a paragraph, followed by a list, followed by a table. Markdown has no concept of spatial positioning, overlapping elements, or free-form layout.
Converting between these two models is not straightforward. Where should a markdown heading appear on a OneNote canvas? How wide should the text container be? What happens to content that follows the heading? OneNote's spatial model makes markdown conversion an ambiguous problem in ways that it is not for linear applications like Google Docs or Word.
Microsoft is investing in Copilot, not format support
Microsoft's AI strategy centers on Copilot, which is deeply integrated into OneNote. Copilot can summarize notes, generate to-do lists, rewrite content, and answer questions about your notebooks. From Microsoft's perspective, the answer to "I have AI output and want it in OneNote" is "use Copilot inside OneNote" rather than "paste markdown from an external AI tool."
This strategic focus means markdown support competes with Copilot features for development resources. Adding markdown rendering would implicitly acknowledge that users work with external AI tools, which conflicts with the push to keep users within the Microsoft 365 ecosystem.
Microsoft Loop also lacks markdown support
Microsoft Loop, the newer collaboration tool in the Microsoft 365 suite, also does not support markdown natively. Loop uses its own component-based system with structured blocks. If Microsoft were planning to build markdown support into their productivity tools, Loop would have been the obvious starting point given its more recent architecture. Its absence there suggests the decision is deliberate across the platform.
The UserVoice requests went unanswered
Microsoft's UserVoice platform, where users could submit and vote on feature requests, hosted multiple high-vote requests for OneNote markdown support. Microsoft deprecated UserVoice in 2021 without addressing most of these requests. The Feedback Portal that replaced it does not provide the same visibility into which features are being considered.
The lack of any public acknowledgment from Microsoft, despite thousands of votes and years of requests, strongly suggests that markdown support is not on OneNote's roadmap.
OneNote markdown workarounds that actually work
Given that native support is not coming, here are the tools and methods available for getting markdown content into OneNote.
OneMark add-in
OneMark is a OneNote add-in that adds markdown rendering capabilities. The workflow:
- Install OneMark from the add-in store
- Paste or type markdown into a OneNote page
- Press F5 to render the markdown into formatted OneNote content
OneMark handles headings, bold, italic, lists, links, code blocks, and basic tables. The rendering replaces the markdown source with formatted content on the same page.
Pros: Works directly inside OneNote. No external tools needed. Supports the most common markdown elements.
Cons: Requires the F5 render step every time. Only works in the OneNote desktop application (not the web version). Complex tables and nested formatting may not render perfectly. The add-in must be installed and maintained separately.
Convert to HTML first, then paste
OneNote handles HTML paste much better than markdown. If you convert your markdown to HTML before pasting, headings, tables, links, and lists all transfer correctly because OneNote interprets HTML elements natively.
The conversion step can be done through:
- A markdown previewer: Paste markdown into any browser-based markdown preview tool, select the rendered output, copy it, and paste into OneNote.
- A dedicated tool: Unmarkdown™ converts markdown to OneNote-compatible HTML with a single click. The output is optimized for OneNote's rendering, handling edge cases that generic converters miss.
- VS Code preview: If you have VS Code, open the markdown file, press Ctrl+Shift+V for preview, select all, copy, and paste into OneNote.
This approach works for all OneNote versions including the web version. The main drawback is the extra step of conversion.
Pandoc for batch conversion
Pandoc is a command-line document converter that can transform markdown files into formats that OneNote can import:
- Convert markdown to
.docx:pandoc input.md -o output.docx - Open the
.docxfile in Word - Copy the formatted content from Word
- Paste into OneNote
This is more steps than direct conversion, but Pandoc handles complex markdown (math, footnotes, cross-references) better than most tools. For batch processing multiple files, Pandoc can be scripted.
Joplin as a bridge
Joplin is an open-source note-taking app that natively supports markdown and can import from OneNote via the Evernote export format:
- Export OneNote notebooks (OneNote > File > Export, or use Microsoft's export tool)
- Import into Joplin
- Edit in Joplin's markdown editor
This does not solve the "paste AI output into OneNote" problem, but it provides a migration path for users who want to move from OneNote to a markdown-native environment.
onenote-md-exporter (GitHub)
For going in the other direction (OneNote to markdown), the onenote-md-exporter open-source tool on GitHub extracts OneNote pages and converts them to markdown files. This is useful for:
- Migrating from OneNote to Obsidian, Notion, or other markdown-based tools
- Creating markdown backups of OneNote content
- Extracting content for use with AI tools that work better with markdown input
The tool uses the Microsoft Graph API to access OneNote data and produces clean markdown files with reasonable formatting preservation.
Microsoft Graph API for programmatic access
Developers can push HTML content to OneNote pages via the Microsoft Graph API:
POST https://graph.microsoft.com/v1.0/me/onenote/pages
Content-Type: application/xhtml+xml
<html>
<head><title>Page Title</title></head>
<body>
<h1>Heading</h1>
<p>Content here</p>
</body>
</html>
This creates a properly formatted OneNote page with real headings, tables, and styling. It is not a user-facing solution, but teams that build internal tools or automations can use this API to bypass the markdown paste problem entirely. Convert markdown to HTML in your pipeline, then push the HTML to OneNote via the API.
OneNote markdown alternatives to consider
If markdown is central to your workflow, and especially if you work heavily with AI tools, you may find that OneNote is not the right fit despite its other strengths. Here are alternatives that handle markdown natively.
Obsidian
Obsidian stores notes as plain markdown files on your local file system. It renders markdown in real time, supports internal linking ([[wikilinks]]), has a plugin ecosystem with over 1,000 community plugins, and runs on Windows, Mac, Linux, iOS, and Android. For users who work with AI output regularly, Obsidian is one of the most natural destinations.
Trade-offs vs. OneNote: No free-form canvas (linear documents only), no native handwriting support, no built-in audio recording, sync requires Obsidian Sync ($8/mo) or third-party solutions. Collaboration is limited compared to OneNote's shared notebooks.
Notion
Notion supports a block-based format that accepts markdown input. You can paste markdown and Notion will convert headings, lists, code blocks, and basic tables. It also supports databases, kanban boards, and extensive team collaboration features.
Trade-offs vs. OneNote: Requires internet connection (no true offline mode), different organizational model (pages and databases vs. notebooks and sections), proprietary format (no plain markdown files on disk).
Bear
Bear is a macOS and iOS note-taking app that uses markdown natively. It supports tags, nested tags, export to multiple formats, and a clean writing interface. For Apple ecosystem users, it is a compelling alternative.
Trade-offs vs. OneNote: Apple only (no Windows, no Android, no web), no collaboration features, simpler organizational model (tags only, no notebooks or folders).
Typora
Typora is a desktop markdown editor that renders formatting in real time as you type. It supports all standard markdown, math (LaTeX), diagrams (Mermaid), and exports to PDF, HTML, Word, and other formats.
Trade-offs vs. OneNote: Desktop only (no mobile, no web), single-user (no collaboration), no organizational features (file system only, no notebooks or tagging).
The growing gap between AI output and OneNote
The disconnect between AI-generated content and OneNote is growing, not shrinking. Every major AI tool produces increasingly rich markdown output: tables, code blocks, task lists, math, diagrams. OneNote's formatting capabilities have not changed to accommodate any of this.
Microsoft's response has been to integrate Copilot into OneNote, which addresses some use cases (generating content within OneNote, summarizing existing notes) but does not address the fundamental problem of importing structured content from external AI tools. If you use ChatGPT, Claude, or any non-Microsoft AI for drafting, research, or analysis, the markdown-to-OneNote gap remains unsolved at the platform level.
The workarounds listed above are real and functional. OneMark works. HTML conversion works. The Graph API works. But they are all friction points in a workflow that should be frictionless. Pasting formatted content into a note-taking app should just work. In OneNote, for markdown, it does not.
Whether Microsoft will eventually add markdown support is unknown. What is known is that the demand exists, the gap is real, the workarounds are imperfect, and the alternatives are mature. For users whose workflow centers on markdown and AI tools, the choice comes down to working around OneNote's limitations or switching to a tool that speaks markdown natively.
