notion-to-obsidian

Convert Notion export zip archives into Obsidian-compatible Markdown files.

8|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/joonlab/joonlab-claudecode-setting-for-share --skill notion-to-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-to-obsidian
Source: https://github.com/joonlab/joonlab-claudecode-setting-for-share/tree/main/claude/skills/notion-to-obsidian
Command: npx skills add https://github.com/joonlab/joonlab-claudecode-setting-for-share --skill notion-to-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill solves the friction of migrating knowledge bases between platforms by automating the conversion of Notion's proprietary export format into clean, link-ready Markdown files for Obsidian.

Core Features & Use Cases

  • Format Conversion: Automatically cleans up Notion-specific syntax and converts it into standard Obsidian-compatible Markdown.
  • Link Resolution: Handles the mapping of internal page links to ensure your knowledge graph remains connected after the move.
  • Use Case: When you decide to switch your personal knowledge management system from Notion to a local-first Obsidian vault, use this skill to batch-process your exported zip file to maintain your folder structure and cross-references.

Quick Start

Use the notion-to-obsidian skill to convert the exported zip file located in my downloads folder into my current obsidian vault.

Frequently Asked Questions about notion-to-obsidian

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

FAQPage Schema
How do I migrate my Notion workspace to Obsidian?

Notion to Obsidian migration involves converting Notion's proprietary export format into standard Markdown files. This process cleans up syntax, maps internal page links, and restructures hierarchical pages to maintain your knowledge graph.

Can I preserve internal links when moving from Notion to Obsidian?

Yes, the conversion process maps internal page links from the Notion export to ensure your knowledge graph remains connected. It restructures hierarchical pages and resolves internal references to maintain cross-references in your Obsidian vault.

Does converting Notion to Markdown require file system access?

Yes, the conversion requires file system access to parse exported zip archives and perform batch text transformations. This allows the tool to read the Notion export and write the cleaned Markdown files directly into your Obsidian vault.

What is the best way to clean up Notion-specific syntax for Obsidian?

Automated batch text transformation is the best way to clean up Notion-specific syntax. It parses the exported zip archive, removes proprietary formatting, and outputs standard Obsidian-compatible Markdown files while preserving your folder structure.

Will migrating a large Notion knowledge base keep the original folder structure?

Yes, the migration process restructures hierarchical pages from the Notion export to mirror your original folder structure. This ensures your personal knowledge management system retains its directory layout and cross-references in the Obsidian vault.