import-notion

Name: import-notion
Availability: InStock
Author: my-entourage

Export Notion pages and databases to local Markdown files.

2|Updated Jan 11, 2026

Search Tags:#markdown #integration #notion #assets #frontmatter #export #link-resolution

Ready to run

npx skills add https://github.com/my-entourage/entourage-plugin --skill import-notion

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: import-notion
Source: https://github.com/my-entourage/entourage-plugin/tree/main/skills/import-notion
Command: npx skills add https://github.com/my-entourage/entourage-plugin --skill import-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires notion-client, python-dotenv, httpx, and includes scripts (resource) components.

What problem does it solve?

Notion pages and databases often live in a dynamic workspace; this Skill exports them to local Markdown files to enable offline context, reproducible documentation, and easier integration with context repositories.

Core Features & Use Cases

Exports Notion pages and databases shared with the integration to local Markdown files.
Resolves Notion hierarchy, downloads assets, and generates frontmatter with notion_id, notion_url, and author for each page.
Use Case: Build a portable knowledge base by converting a Notion workspace into a static, searchable set of Markdown files with linked references.

Quick Start

Run /import-notion to start exporting your Notion pages to local Markdown in your project.

Frequently Asked Questions about import-notion

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

FAQPage Schema

How do I export Notion pages to Markdown files with frontmatter?▼

Exporting Notion pages to Markdown requires a configured Notion integration with API keys and script dependencies in scripts/. The tool exports shared pages and databases, downloads assets, and generates frontmatter with notion_id and notion_url for provenance.

Do I need a Notion API key to export pages to local Markdown?▼

Yes, you need a configured Notion integration with API keys to export pages to local Markdown. The script requires these credentials along with dependencies like notion-client, python-dotenv, and httpx to access and download your shared Notion content.

Can I download Notion assets and resolve hierarchy when exporting to Markdown?▼

Yes, the script resolves Notion hierarchy and downloads linked assets during the Markdown export. It maintains the original page structure and generates frontmatter with notion_id, notion_url, and author metadata to preserve provenance and linked references.

What's the best way to convert a Notion database to static Markdown for offline context?▼

Running the export script converts shared Notion databases into static, searchable Markdown files with linked references. This approach enables offline context, reproducible documentation, and easier integration with context repositories for portable knowledge management.

Why are my Notion pages not exporting to Markdown?▼

Notion pages may not export to Markdown if they are not shared with the configured Notion integration. You must explicitly share the target pages or databases with the integration using your API key, and ensure all required script dependencies are installed correctly.