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:
- Create a dedicated integration - Go to notion.so/my-integrations and create an integration for this tool only
- Use read-only permissions - Grant the integration "Reader" access, not "Editor"
- Share selectively - Only share specific pages/databases with the integration, not your entire workspace
- Protect your token - Never commit
.envfiles containingNOTION_API_KEYto version control - Use temporary tokens - Consider creating a rotation policy for tokens or using temporary tokens
- Code inspection - This tool only uses the official
@notionhq/clientlibrary and communicates exclusively with Notion's API. No data is sent elsewhere.