Obsidian

Docs

Obsidian

Notion to Obsidian with notion-downloader.

How to set up a Obsidian vault that uses notion-downloader to pull content from Notion.

Notion to Obsidian with notion-downloader

This guide explains how to set up a Obsidian vault that uses notion-downloader to pull content from Notion.

Reference template repository: https://github.com/FranciscoMoretti/notion-to-obsidian.

Steps

Install notion-downloader:

npm install notion-downloader

Get your NOTION_TOKEN and ROOT_ID from the Notion Setup guide.
Create the downloader configuration:

Run npx notion-downloader init and use these options in downloader.json created:

{
  ... 
  "conversion": {
    ... 
    "outputPaths": {
      "markdown": "./content/",
      "assets": "./content/assets/"
    },
    "markdownPrefixes": {
      "markdown": "",
      "assets": "assets/"
    },
    "layoutStrategy": {
      "markdown": "hierarchical",
      "assets": "flat"
    },
    "namingStrategy": "default",
    ... 
  }
  ... 
}

Your Obsidian vault should point to the content folder. You can change content to any other folder name.

This config puts all assets in the assets folder. See the configuration reference for more options.

Add your Notion token:

a. In a .env file:
```
NOTION_TOKEN=your_token_here
```
b. Or use it directly with the CLI.
Run the downloader:

npx notion-downloader pull

CLI Nextra