OneNote Exporter

Thinking of moving your OneNote collection to another note-taking app such as Obsidian, Logseq, Org Mode and more? You're in the right place!

OneNote Exporter (in short, one) is a PowerShell program which is capable of exporting all your OneNote notes to any Pandoc-supported plain text markup format using the OneNote Object Model and Pandoc. That is to say: markdown, org-mode and more!

---

Notable alternatives

• onenote-md-exporter

---

Table of Contents

Introduction

Results

Supported Markups

Markup Packs

Requirements

Usage

Recommendations

Attribution

---

Introduction

one exports OneNote pages to Word using the OneNote Object Model, and then uses Pandoc to convert them to your markup format of choice. Then, one uses Markup Packs to customize the result. Markup Packs are functions specific to each markup format, which contain search and replace queries executed at runtime against the text output by Pandoc to tailor it to your desires. If search and replace doesn't cut it, you can add a postprocessing scriptblock to increase your freedom. Markup Packs give you fine-grained control over of all elements of your notes, including

• Headers
• Metadata (eg: note creation date)
• Other markup elements such as horizontal lines, custom indentation and formatting, and whatever else you might be able to conjure up from the text in your notes

one currently ships Markup Packs for Emacs Org Mode (OrgPack1) and markdown (MarkDownPack1).

What is being exported?

one will export all your local OneNote notebooks, meaning that to export a notebook of yours, you will need to download it to OneNote >= 2016* with the "Add Notebook" option.

Customizing the output

As long as Pandoc supports your desired markup format, all one needs to shine is a Markup Pack to tailor the output to your tastes. The section on Markup Packs contains a step by step guide to write and use your own Markup Packs.

Results

You can see the actual test results in the test directory (as well as the Word file to which the test note was exported). I have attempted to identify all unsupported syntax, which you can see as you would in OneNote at the bottom of the test Word file, and the respective export (failure) in the Org Mode and markdown conversions.

As you can see in the image above, the Markup Packs shipping for Org Mode and markdown (OrgPack1 and MarkdownPack1 respectively) will give your notes:

• Note creation data (in the case of Org Mode in its timestamp format)
• Correctly rendered lists, numbered and unnumbered, as well as indented paragraphs
• And finally clean the output of export artifacts, excess newlines, etc

Some notes:

• If you want markdown output compatible with VSCode and GitHub, specify markdown_github in the line 66 of your config.ps1

  $conversion = 'markdown_github-simple_tables-multiline_tables-grid_tables+pipe_tables'
  

• Formatting using different fonts and colors doesn't survive export, as could be expected
• Underscored text is annotated as such in markdown, but does not render correctly (at least in VSCode)
• Images resized within OneNote are rendered with size information when exporting to markdown. Be mindful of the markdown flavour you are using. Pandoc markdown (markdown in the Pandoc call in your config.ps1) image size notation will not render properly in GitHub or other GitHub-flavoured markdown renderers such as the VSCode markdown preview window.

Supported Markups

With support is meant that one understands which file type you are trying to export your notes to: it will use this knowledge to appropriately name files and apply default Markup Packs if markupPack is set to '' in line 74 of your config.ps1.

one supports all (as of June 2022) Pandoc supported markups, as follows (from the Pandoc manual),

• Emacs Org Mode

  • org

• Markdown

  • markdown_strict

• CommonMark

  • commonmark
  • commonmark_x

• GitHub-Flavored Markdown

  • gfm
  • markdown_github

• Pandoc Markdown

  • markdown

• MultiMarkdown

  • markdown_mmd

• PHP Markdown Extra

  • markdown_phpextra

Markup Packs

You can specify your Markup Pack of choice line 74 of your config.ps1. markupPack may have three values, as follows:

Configuration

'<markup pack>'

You Markup Pack of choice.

''

The default Markup Pack for your export format. one determines which Markup Pack to use by first identifying the extension of the file format you have specified in your Pandoc call (currently .org and .md), and then choosing the default Markup Pack for that format.

'none'

No post-processing will be applied.

Adding Markup Packs

Markup Packs are markup-format-specific functions containing search and replace queries executed at runtime against a string containing the entire markup content. If search and replace doesn't cut it, you can add a postprocessing scriptblock to increase your freedom (check the scriptblock to "Remove over-indentation of list items" in Markdown MarkdownPack1).

A Markup Pack template is available in the templates directory. It's an annotated version of the Emacs Org Mode OrgPack1 Markup Pack. If you're interested in exporting to a Markdown format, check the Markdown MarkdownPack1 Markup Pack for inspiration.

To add a Markup Pack, follow these steps:

1. Write your Markup Pack in the file containing the Markup Packs of your markup format of choice (Org.psm1 or Markdown.psm1 in src/Conversion/Markup-Packs).
2. Set markupPack in your config.ps1 to the name of your markup pack. That is, the name of the function you have written.

Requirements

• Windows >= 10

• Windows Powershell 5.x and above, or Powershell Core 6.x up to 7.0

• Microsoft OneNote

  >= 2016 (Desktop version, NOT the Windows Store version)

  • Download: FREE - https://www.onenote.com/Download

• Microsoft Word

  >= 2016 (Desktop version, NOT the Windows Store version)

  • Download: Office 365 Trial - https://www.microsoft.com/en-us/microsoft-365/try

• PanDoc >= 2.2.3.2

  • TIP: You may also use Chocolatey to install Pandoc on Windows, this will also set the right path (environment) statements. (https://chocolatey.org/packages/pandoc)

Usage

1. Clone this repository
2. Start the OneNote desktop application
3. Rename config_example.ps1 to config.ps1 and configure the available options to your liking.
4. Open a PowerShell terminal at the directory containing the script and run it.
   • .\one.ps1
5. Sit back and wait until the process completes. To stop the process at any time, press Ctrl+C.

• While running the conversion OneNote will be unusable, as the Object Model might be interrupted if OneNote is used through the conversion process.

Options

All of the following are configured from config.ps1 (assuming you have renamed config example.ps1 to that).

• Create a folder structure for your Notebooks and Sections
  • Process pages that are in sections at the Notebook, Section Group and all Nested Section Group levels
• Choose between converting a specific notebook or all notebooks
• Choose between creating subfolders for subpages (e.g. Page\Subpage.md) or appending prefixes (e.g. Page_Subpage.md)
• Specify a value between 32 and 255 as the maximum length of markdown file names, and their folder names (only when using subfolders for subpages (e.g. Page\Subpage.md)). A lower value can help avoid hitting [file and folder name limits of 255 bytes on file systems](https://en.wikipedia.