Three steps
Convert to Markdown
Use one of the tools below to turn each notebook into a folder of
.mdfiles, with pictures and attachments saved beside them.Store it in OneDrive or SharePoint
Save the converted folder somewhere in your OneDrive, or in a SharePoint document library your team uses. For example
OneDrive › Notes.Add it to NoteSweep
In NoteSweep, choose Add Account, sign in to OneDrive or SharePoint, and pick the folder. Notebooks become folders, sections become sub-folders and pages become pages.
How OneNote maps across
- Notebook → top-level folder
- Section (and section group) → folder inside it
- Page → Markdown file, named after the page
- Images and files → saved next to the pages and embedded
- Tables, to-do tags and links → Markdown tables, checklists and links
Pick what suits you
Any tool that writes standard Markdown works. These are the common routes; try one notebook first and check it in NoteSweep before converting everything.
Claude, or Claude Code
An AI assistant can do the conversion for you. Claude Code can take notebooks you've exported and write them out as tidy Markdown pages, with headings, lists, tables and pictures, straight into your OneDrive folder.
Ask it to keep one file per page and one folder per section, and to put pictures in an attachments folder.
Power Automate
For work and school accounts, a Power Automate flow can copy your pages into OneDrive or SharePoint as Markdown, for whole notebooks or a team notebook that keeps flowing into a shared library.
More options on GitHub
Free tools you can run yourself. Most run on Windows with the OneNote desktop app installed; check each project's instructions.
OneNote Md Exporter
Exports whole notebooks to Markdown, with a folder per section and attachments kept.
ConvertOneNote2MarkDown
A script that converts notebooks to Markdown, with options for file names and pictures.
Pandoc
The document converter many of these tools use. Handy for turning exported Word or HTML pages into Markdown yourself.
Before you switch over
- Keep your OneNote notebooks until you're happy with the converted copy
- Convert one notebook first, add it to NoteSweep, and check pictures, tables and checklists
- Choose an attachments folder when you set up the Library, so pictures you add later sit with the converted ones
- Links between OneNote pages become links between Markdown pages when the tool supports it; check a few
- Page dates may change to the day you converted them; some tools keep the originals
Why OneDrive or SharePoint?
Your notes stay in Microsoft 365 alongside everything else, sync to your other devices, and are backed up by the same service. NoteSweep reads and writes them there directly; nothing goes through a NoteSweep server.