A specialized CLI utility that transforms standard Markdown content into fully formatted Notion blocks, supporting tables, callouts, and rich text.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install notion-md
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install notion-md using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is notion-md?
notion-md is a robust integration designed to streamline the migration of technical documentation from local Markdown files into Notion's block-based environment. As a key component of the Openclaw Skills ecosystem, it ensures that headings, code blocks, lists, and advanced formatting like callouts are preserved with high fidelity. This tool is essential for developers who prefer writing in Markdown but require the collaborative power of Notion for their team's knowledge base.
Beyond simple text conversion, the skill handles complex structural elements such as nested lists and table formatting, providing a seamless bridge between static text and dynamic blocks. By automating the publishing process, it eliminates the manual overhead typically associated with updating Notion pages from local source files.
notion-md Use Cases
- Automating the publication of technical READMEs or documentation to a centralized Notion workspace.
- Syncing research notes and project logs directly from a terminal or automated script.
- Migrating content from static site generators or personal wikis into Notion blocks.
- Appending automated build reports or system logs to specific Notion pages for team visibility.
How notion-md Works
- The user provides Markdown content via a file path or through standard input (stdin).
- The utility parses the Markdown syntax and maps it to specific Notion block types according to its internal schema.
- The skill authenticates with the Notion API using a secure integration token provided by the user.
- It identifies the target parent page or specific page ID where the content should be created or appended.
- The content is transmitted as a series of block objects, which Notion renders natively as headings, tables, or rich text annotations.
notion-md Setup
1. Generate Integration Key
Visit Notion Integrations to create a new integration and copy your Internal Integration Secret.
2. Configure Environment
You can set your credentials via environment variables for use with Openclaw Skills:
export NOTION_API_KEY="ntn_your_key_here"
export NOTION_PARENT_PAGE_ID="your_page_id"
3. File-based Configuration
Alternatively, store your key locally for persistent access:
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
notion-md Data Schema & Taxonomy
The skill utilizes a strict mapping between standard Markdown syntax and the Notion Block API (v2022-06-28).
| Markdown Syntax | Notion Block Type | Metadata Handled |
|---|---|---|
#, ##, ### |
heading_1, 2, 3 | Text styling |
**bold**, *italic* |
rich_text annotations | Style & Color |
-, 1. |
bulleted/numbered_list_item | Indentation |
::: callout |
callout | Icons & Backgrounds |
| table | |
table | Basic Rows & Columns |
> quote |
quote | Text content |
--- |
divider | Separators |
notion-md Advanced Features
- Support for standard input (stdin) allowing it to be piped into other CLI tools or Openclaw Skills.
- Dry-run capability to validate block structures before committing changes to the Notion API.
- Batch appending features to update existing documents without overwriting previous content.
- Customizable page icons and emojis via command-line flags for better visual organization.
SKILL.md
Loading
Related Openclaw Skills
Emily Radix Assistant
A comprehensive AI-powered assistant for querying Radix DLT blockchain data, including wallets, tokens, and ecosystem news.
Emily Radix Assistant
A comprehensive AI-powered assistant for querying Radix DLT blockchain data, including wallet balances, DeFi yields, and ecosystem news.
Emily Radix Assistant
A comprehensive AI assistant for querying real-time Radix DLT blockchain data, DeFi yields, and ecosystem news.
Zapier MCP
A powerful integration skill that connects AI agents to over 8,000 applications through the Model Context Protocol without complex OAuth management.
Groq Whisper API
High-speed audio transcription leveraging Groq specialized ASR models via a streamlined curl interface.
BirdWeather
A CLI-based tool for querying public bird song detection data and wildlife trends from BirdWeather stations globally.
Featured*
