Build my stack
Migrate from Notion to Obsidian
A complete guide detailing how to export your logs, map data columns, and upload your databases successfully without losing records.
Execution Checklist
Export Notion Workspace as HTML/Markdown
Navigate to Notion Settings > Settings > Export all workspace content. Select Markdown & CSV format.
Unzip Files to Obsidian Vault
Create a new vault directory inside Obsidian and unzip the Notion export files directly into it.
Format Internal Links
Run an Obsidian plugin like 'Notion to Obsidian Converter' to clean up sub-page directories and fix double brackets.
Recommended CSV Columns Mapping
Match your CSV export parameters precisely when uploading files:
| Source (Notion) | Target (Obsidian) | Example Payload | Mapping Action |
|---|---|---|---|
| Title Property | H1 Header | Weekly Review | Converted to top of Markdown file. |
| Relation Column | File Backlink | [[Project Alpha]] | Mapped using custom converter plugin. |
Migration Hazards & Mitigations
Inline Database Views
Solution: Use Obsidian Dataview plugin to build dynamic views on file metadata tags.
Image Embeds Pathing
Solution: Enable Obsidian's 'Detect attachments path' and copy Notion's assets folder.
Automated Migration Alternatives
If you prefer a hands-off, risk-free sync, these third-party tools offer API migrations:
Notion to Markdown Exporter CLI
Node script that optimizes file formatting, asset placement, and sanitizes file paths.
Critical Import/Export Advice
Markdown does not support database sub-relations out of the box. Store database tables as inline lists or dataview tables inside Obsidian.