gather-notion

Export published Notion pages to local Markdown files with source metadata.

9|3|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/corca-ai/charness --skill gather-notion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gather-notion
Source: https://github.com/corca-ai/charness/tree/main/plugins/charness/support/gather-notion
Command: npx skills add https://github.com/corca-ai/charness --skill gather-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This capability fills the gap by turning published Notion pages into durable local Markdown assets, enabling offline access and long-term archival without requiring consumer repos to implement export tooling.

Core Features & Use Cases

  • Converts a publicly published Notion page to a durable local Markdown file, preserving the page title and source metadata.
  • Keeps the export logic self-contained within the harness so consumer repos do not need to recreate an exporter.
  • Supports only publicly published pages; private Notion API access remains out of scope and guardrails prevent access to unpublished content.

Quick Start

Run the wrapper script to export a published Notion page to a local Markdown file.

Frequently Asked Questions about gather-notion

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

FAQPage Schema
How do I export a published Notion page to local Markdown?

To export Notion pages to Markdown, run the wrapper script with a public Notion URL or page ID. It writes the Markdown file to your workspace, preserving the page title and source metadata for offline access.

Can I use this Notion export tool with private pages or do I need API access?

No, the export only supports publicly published Notion pages. Private Notion API access is out of scope, and guardrails prevent access to unpublished content to ensure secure offline archival.

What is the best way to archive Notion documentation for offline access?

Archiving Notion documentation as local Markdown provides durable offline access. This tool converts published pages into self-contained Markdown files, eliminating the need to build custom export tooling in consumer repos.

Do I need Python to convert Notion pages to Markdown files?

Yes, converting Notion pages to Markdown requires Python 3. The tool uses a self-contained wrapper and vendor exporter to validate output paths within the workspace and generate the final local Markdown artifacts.

What happens if a Notion page is inaccessible during the Markdown export?

If a Notion page is inaccessible or the export fails, the tool reports errors directly. It validates output paths within the workspace to ensure only accessible, published pages are converted to local Markdown.