30 Notion Pod
Goals
POD for working with Notion.
Context
Some users are looking to switch from Notion to Dendron, or integrate Dendron as part of their team's Notion workflow.
Rough Prioritization
- Export Pod - export Dendron notes into their Notion workspace.
- Import Pod - import pages/database from notion workspace to dendron vault
Proposal
The Notion export pod that can transfer contents of a dendron vault to a Notion workspace. The export config having additional options to export a specific vault.
Details
Using Notion Export Pod can be a two step process
- Authentication
- Choosing the parent page
Authentication
The Notion API uses tokens/api-key to authorize requests from integrations.
Step 1: Create an integration:
- Go to My-Integrations.
- Click the "+ New integration" button.
- Give your integration a name - I chose "Novels".
- Select the workspace where you want to install this integration.
- Click "Submit" to create the integration.
- Copy the "Internal Integration Token" on the next page and save it to the dendron notion export pod config file.
Step 2: Share a database with your integration Integrations don't have access to any pages (or databases) in the workspace at first. A user must share specific pages with an integration in order for those pages to be accessed using the API. Start from a new or existing page in your workspace. Click on the Share button and use the selector to find your integration by its name, then click Invite.
Choosing the parent page
The exported notes cannot be attached at a workspace level and require a parent page. The Pod will automatically query for pages on your Notion workspace and provide you with a drop down list of pages for you to choose as a Parent. The most recently created page will appear at the top of the dropdown.
Example
Here is an example video for an initial draft of Notion export pod.
Tradeoffs
-
The Notion API has a rate limit of 3 requests per second. If the dendron vault contains a large number of notes, it might take several minutes to export, quite similar to when we manually import notes in Notion, it first uploads all the notes and them import.
-
Exporting Dendron Notes to Notion requires a change in the format of notes. The Markdown needs to be parsed into Notion Blocks for Notion to comprehend it and parse accordingly.