Moving from OneNote

Bring your OneNote notebooks with you

NoteSweep works on a folder of Markdown files. To move from OneNote, convert your notebooks to Markdown once, save the result in OneDrive or SharePoint, and add that folder to NoteSweep. Your notebooks, sections and pages become folders and files you own.

The plan

Three steps

  1. Convert to Markdown

    Use one of the tools below to turn each notebook into a folder of .md files, with pictures and attachments saved beside them.

  2. 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.

  3. 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
Ways to convert

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.

Open source

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.

github.com/alxnbl/onenote-md-exporter →

ConvertOneNote2MarkDown

A script that converts notebooks to Markdown, with options for file names and pictures.

github.com/theohbrothers/ConvertOneNote2MarkDown →

Pandoc

The document converter many of these tools use. Handy for turning exported Word or HTML pages into Markdown yourself.

github.com/jgm/pandoc →

Tips

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.

How NoteSweep works with your storage