skills.rest
my-entourage
my-entourageOFFICIAL
Explore all skills by this author →
GitHub

import-notion

Export Notion pages and databases to local Markdown files.

2|Updated Jan 11, 2026
Search Tags:#markdown#integration#notion#assets#frontmatter#export#link-resolution
One-click install
npx skills add https://github.com/my-entourage/entourage-plugin --skill import-notion
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
HaraldeRoesslerHaraldeRoessler

notion

Query, create, update, and append content in Notion workspaces via the REST API.

Community
Intermediate
drillandrillan

crawl

Crawl websites and save pages as local markdown files.

Community
Intermediate
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced
gnestorgnestor

notion

Your AI-powered travel assistant for effortless trip planning and booking.

Community
Advanced