Note: I'm unfortunately very tied up with work at this time, but feel free to open issues with any requests, suggestions, questions, or bugs! I'll try to address them as soon as life settles down again. Pull requests are welcome!

Thank you! <3

Notion to Obsidian Converter

This is a simple script to convert exported Notion notes to Obsidian (or maybe other systems too).

Usage

1. Download Notion data from Notion>Settings & Members>Settings>Export content>Export all workspace content
2. Unzip the data using 7-Zip (or something better than Window's default)
3. Get the script
4. Run node main
5. Input the path where your Notion notes are
6. Move notes folder into Obsidian directory

Warning: Notion pages that contain parentheses or dashes in the title will have them removed by Notion while exporting your data so the file will be created without them, even though the link itself will still retain them.

node main.js [args] [path_to_export]

node main.js /my/notion/export

node main.js my_export

node main.js -v[vv] my_export

node main.js --help

How it works

Paths:

The script searches through every path and removes the long uuid at the end of both the directory paths and the file paths.

Conversion Features:

f083b5eaef3a47fca23c7433d7c255b0

Markdown links are converted from [Link Text](Notion\Link\Path) to [[Link Text]]. It isn't perfect due to name collision, but it works for most links. Some links contain www.notion.so when they are related table records and those are converted from https://www.notion.so/The-Page-Title-2d41ab7b61d14cec885357ab17d48536 to [[The Page Title]].

fe41f3d62d6e403c8000b42cc3542970

CSV links are converted from ../Relative%20Path/To/Page%20Title.md to [[Page Title]]. Again, not perfect but it works for most links.

553d2ce07ec04dd48bc90d2b4c990a3e

After CSV's have their links corrected a secondary Markdown file is created with the same name and all of its contents converted into a Markdown table.

c80f023a627d493d96e5859b845fd2dc

URL links found in Markdown are left as-is: [Link Text](URL) because Obsidian renders these correctly. The signifier for a "valid URL" is just containing :// or if it matches a standard IP address structure, so it captures http://, https:// and other networks like ipfs:// as well as xxx.xxx.xxx.xxx.

46528ea007df4e56a8d9a1223b417f83

If a link contains illegal characters *"/\<>:|? the character is replaced with a space.

466649c074fd4119ab3054a606f4ba8a

Image links are converted from ![Page%20Title%20c5ae5f01ba5d4fb9a94d13d99397100c/Image%20Name.png](Page%20Title%20c5ae5f01ba5d4fb9a94d13d99397100c/Image%20Name.png) to ![Page Title/Image Name.png]

Why

Windows can't handle large paths. After unzipping the Notion data I wasn't able to move the folder because Windows doesn't like long paths and Notion put a long uuid on every directory and file.

Note

This is not made to be robust. Don't run it twice on the same export or it's likely to fail and truncate paths unnecessarily.

Contributors

• me
• zeyus
• nguyentran0212
• CodeMySky
• all of the users who have given helpful feedback to make the project more stable and helped cover edge cases!