notion-import

Import Notion workspaces into Obsidian vaults as .base files.

2|1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/cdeistopened/skill-stack-skills --skill notion-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-import
Source: https://github.com/cdeistopened/skill-stack-skills/tree/main/infrastructure/notion-import
Command: npx skills add https://github.com/cdeistopened/skill-stack-skills --skill notion-import

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion-to-Obsidian migration is tedious when databases, pages, and hierarchy must be preserved. This Skill automates the conversion and preserves database structures as Obsidian .base files, while mapping pages to folders for a ready-to-use vault.

Core Features & Use Cases

  • API-based import preserves Notion databases as Obsidian .base files, maintaining properties and links.
  • Folder structure mirroring Notion page hierarchy for intuitive navigation.
  • Safe staging workflow to avoid direct writes to working vaults; supports bulk migrations and incremental imports.

Quick Start

Install and configure the Notion API integration, run the importer against your workspace, and specify a staging directory for initial results.

Frequently Asked Questions about notion-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I import Notion to Obsidian and keep my page hierarchy?

Notion databases are converted into Obsidian `.base` files during import, maintaining their original properties and internal links for seamless data continuity within your vault.

What do I need to migrate a Notion workspace into an Obsidian vault?

Migrating a Notion workspace requires configuring Notion API access, specifying a staging output path for safe initial results, and using frontmatter identifiers like notion-id for traceability.

Does Notion to Obsidian migration support incremental imports?

Notion to Obsidian migration supports incremental imports and bulk migrations through a safe staging workflow, preventing direct writes to working vaults during the data transfer process.

How does Notion database conversion work when moving to Obsidian?

Notion database conversion works by preserving database structures as Obsidian `.base` files, ensuring properties and relational links remain intact and usable after the migration.

Why use a staging directory when importing Notion exports to Obsidian?

Using a staging directory when importing Notion exports prevents direct writes to working vaults, ensuring a safe workflow to validate the converted folder structure before final integration.