notion-to-markdown

To clean up Notion export artifacts for Markdown migration, this skill applies a cleanup checklist that removes formatting cruft and Notion-specific structures while preserving your substantive content.

The best way to organize a large Notion knowledge base into Markdown is running a multi-phase migration. This skill interviews you about your setup, builds a config file, and migrates content in three phases.

The config file works by capturing your filing logic and preferences in a .notion-migrate.yml file. It supports target_path mappings and per-file git workflows to structure your Markdown knowledge base.

You can migrate Notion content to Markdown in phases. The migration starts with easy items and progressively handles higher-judgment content, allowing you to review decisions and provide feedback.

Notion Markdown exports contain nested structures and formatting cruft because Notion embeds specific artifacts that hinder publishing. This skill targets those artifacts to generate clean, organized Markdown files.

You need a YAML frontmatter entry point in your SKILL.md to migrate Notion pages to Markdown. The skill leverages this setup along with references to guide migration decisions and apply the cleanup checklist.