skills/skills.volces.com/notion-to-markdown

notion-to-markdown

Installation
SKILL.md

Notion to Markdown Converter

Convert Notion pages and databases to clean, readable markdown using the official Notion API.

⚠️ Security & Credentials

Required Credentials:

  • NOTION_API_KEY - Your personal Notion integration token (required)

Security Best Practices:

  1. Create a dedicated integration - Go to notion.so/my-integrations and create an integration for this tool only
  2. Use read-only permissions - Grant the integration "Reader" access, not "Editor"
  3. Share selectively - Only share specific pages/databases with the integration, not your entire workspace
  4. Protect your token - Never commit .env files containing NOTION_API_KEY to version control
  5. Use temporary tokens - Consider creating a rotation policy for tokens or using temporary tokens
  6. Code inspection - This tool only uses the official @notionhq/client library and communicates exclusively with Notion's API. No data is sent elsewhere.
Installs
2
First Seen
Apr 23, 2026