notion-to-obsidian

Convert Notion pages and course workbooks into Obsidian Markdown notes with local images.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill notion-to-obsidian-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-to-obsidian
Source: https://github.com/cookkie03/skills/tree/main/notion-to-obsidian
Command: npx skills add https://github.com/cookkie03/skills --skill notion-to-obsidian-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Public and workspace Notion pages are hard to archive: toggles stay collapsed, images sit on expiring AWS S3 URLs, and copy-pasting loses math equations, tables, and code formatting. This Skill automates full-fidelity extraction of Notion content into offline Obsidian Markdown notes. ## Core Features & Use Cases - Recursive Toggle Expansion: Progressively scrolls virtualized Notion DOM and clicks every collapsed toggle until the page fully converges, capturing content hidden in large workbooks. - Faithful Format Conversion: Transforms tables of contents, code blocks with language detection, KaTeX/LaTeX equations, tables, callouts, and nested lists into clean Obsidian Markdown. - Local Asset Archiving: Downloads images from expiring signed URLs into the vault and rewrites embeds as local references, with non-destructive merging that preserves existing user annotations. - Use Case: A student archiving a university course workbook (e.g., a Data Mining practical with hundreds of toggles) can batch-process pages into a structured Obsidian vault folder with working math, code, and offline images. ## Quick Start Extract this Notion course workbook URL into my Obsidian vault, expanding all toggles and downloading images locally.

Frequently Asked Questions about notion-to-obsidian

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

FAQPage Schema
How do I convert a Notion page to Obsidian Markdown?

Open the Notion URL in a browser session, expand all collapsed toggles with progressive scrolling, then parse the DOM into Markdown. This Skill automates that pipeline, producing notes with headings, lists, tables, and local image embeds.

How to expand all toggles on a Notion page automatically?

Notion virtualizes its DOM, so toggles must be expanded during incremental scroll passes of about 600px. The Skill clicks elements with aria-expanded="false" and collapsed notion-toggle-block classes, repeating passes until no new toggles open.

Why do Notion images break after exporting to Markdown?

Notion serves images through temporary AWS S3 signed URLs that expire within hours, so exported links go dead. The fix is downloading each image locally during extraction and rewriting references to local vault paths.

Does Notion to Markdown conversion preserve LaTeX math equations?

Yes, KaTeX blocks are converted to $$ delimited blocks and inline math to $ delimiters using the embedded TeX annotation. Currency figures like $1,000 are escaped as \$1,000 so Obsidian's MathJax does not misparse them.

Can I convert large Notion course workbooks with hundreds of toggles?

Yes, but batch processing is required. The Skill processes 3-5 pages per execution turn for workbooks with 300-1,200+ toggles to avoid timeouts, and maintains parent-child hierarchy for vault folder organization.