notion-publish

Publish markdown documents to private Notion pages with block mapping.

2|1|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/lucidlabs-hq/agent-kit --skill notion-publish
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-publish
Source: https://github.com/lucidlabs-hq/agent-kit/tree/main/.claude/skills/notion-publish
Command: npx skills add https://github.com/lucidlabs-hq/agent-kit --skill notion-publish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publish markdown documents to Notion as private pages to share specs, docs, or session outputs without exposing them publicly.

Core Features & Use Cases

  • Notion integration: publish markdown to Notion pages with basic formatting.
  • Formatting enforcement: maps Markdown to Notion blocks (headings, paragraphs, lists, code, quotes, tables, dividers).
  • Use Case: Ideal for sharing internal specs, design notes, or session outputs within a private Notion workspace.

Quick Start

Publish a Markdown file to Notion by running the /notion-publish command with the file path.

Frequently Asked Questions about notion-publish

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

FAQPage Schema
How do I publish markdown documents to private Notion pages?▼

To publish markdown to private Notion pages, run the /notion-publish command with your file path. The Skill converts markdown formatting like headings, lists, and code blocks into corresponding Notion block types within a private workspace.

What markdown formatting is supported when converting to Notion?▼

Markdown formatting support includes mapping headings, paragraphs, lists, code blocks, quotes, tables, and dividers directly to their corresponding native Notion block types for accurate document rendering.

Do I need a Notion API integration token to publish markdown files?▼

Yes, you need a local Notion integration token configured to publish markdown files. The Skill requires this token alongside a defined parent page target to safely post your converted markdown content.

Can I share internal specs and session outputs to Notion without exposing them publicly?▼

You can share internal specs and session outputs to Notion without public exposure by publishing them as private pages. This targets personal or team documentation workflows within a secured Notion workspace.

What's the best way to map markdown blocks to Notion block types?▼

The best way to map markdown blocks to Notion block types is using a defined conversion rule that translates plain markdown syntax directly into native Notion structures for headings, lists, tables, and code.