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.