skills.rest
aneym
aneymCOMMUNITY
Explore all skills by this author →
𝕏@lxnmnnnGitHub

notion

Convert Notion blocks to Markdown and back via a deterministic CLI.

Updated Jan 31, 2026
Search Tags:#automation#markdown#api#cli#notion#blocks#pages
One-click install
npx skills add https://github.com/aneym/agent-skills --skill notion-aneym
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/aneym/agent-skills/tree/main/skills/notion-api
Command: npx skills add https://github.com/aneym/agent-skills --skill notion-aneym

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Notion data workflows often require manual, error-prone sequence of API calls to read, write, or export content. This Skill provides a deterministic CLI that bridges Markdown and Notion blocks, enabling automation of common Notion tasks.

Core Features & Use Cases

  • Rich Markdown support: export and import between Notion blocks and Markdown, including tables, callouts, toggles, and images.
  • CRUD operations: read, create, update, delete blocks and pages from Notion via a single CLI entrypoint.
  • Data portability: export pages to Markdown, capture notes, and reuse content across Notion pages or databases.
  • Use Case: quickly bulk-create a knowledge base page from a Markdown document or update a project doc with new sections.

Quick Start

Install and run the CLI to connect to your Notion workspace and manage pages and blocks.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I convert Notion pages to Markdown?▼

You can convert Notion pages to Markdown by using a CLI that translates Notion blocks into rich Markdown format. This enables data portability and allows you to export pages with tables, callouts, toggles, and images.

Can I bulk-create Notion pages from a Markdown file?▼

Yes, you can bulk-create Notion pages and knowledge bases from a Markdown file. The CLI reverses the conversion process, turning rich Markdown syntax into Notion blocks to automate content creation.

How do I automate updating Notion blocks via API?▼

You automate updating Notion blocks via API by executing CRUD operations through a single CLI entrypoint. The process enforces environment-based authentication and handles Notion-Version headers automatically.

Does this Notion CLI handle API rate limits and errors?▼

Yes, the Notion CLI handles API rate limits and errors robustly. It features configurable rate limits and retries to ensure deterministic automation when reading, writing, or moving content between databases.

What is the best way to move content between Notion databases?▼

The best way to move content between Notion databases is using a deterministic CLI that bridges Markdown and Notion blocks. This approach preserves rich formatting during CRUD operations and avoids manual API calls.

Do I need environment variables to authenticate with the Notion API?▼

Yes, you need environment variables for authentication. The CLI enforces environment-based authentication to securely connect to your Notion workspace and manage pages and blocks.

Related Skills

Explore More Software Engineering Skills→
zkcpkuzkcpku

notion

Create, retrieve, and modify Notion pages, databases, and blocks via API.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
georgekhananaevgeorgekhananaev
27

md

Enforce consistent Markdown syntax across documentation and README files.

Community
Basic
framerslabframerslab

notion

Manage Notion pages, databases, and content blocks via CRUD operations.

Official
Intermediate