notion-publisher

Publish markdown documents with embedded images to Notion.so pages via Notion MCP.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NEXUZ-SYS/nxz-tutorial-agents --skill notion-publisher
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-publisher
Source: https://github.com/NEXUZ-SYS/nxz-tutorial-agents/tree/main/skills/notion-publisher
Command: npx skills add https://github.com/NEXUZ-SYS/nxz-tutorial-agents --skill notion-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publish documents with images to Notion.so pages. Handles image hosting, page creation, and image embedding via the Notion MCP integration. Use when a squad pipeline needs to save its final output to Notion.

Core Features & Use Cases

  • Notion MCP integration validation and setup for publishing
  • Upload local images to public hosting and embed them in Notion pages
  • End-to-end page creation under a specified parent page with converted markdown content

Quick Start

Publish a final document with images to a Notion page using the MCP flow.

Frequently Asked Questions about notion-publisher

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

FAQPage Schema
How do I publish a markdown document with locally hosted images to Notion?▼

You need the Notion MCP integration configured and available, accessible local image files for hosting, and a designated target parent page in Notion to serve as the publishing destination for your converted markdown content.

Can I automate saving squad pipeline final outputs directly to a Notion page?▼

Yes, you can automate saving squad pipeline outputs to a Notion page by applying this skill to handle end-to-end document creation, image uploading, and markdown conversion through the Notion MCP flow.

Does Notion MCP support uploading and embedding local images in published pages?▼

Notion MCP supports embedding local images in published pages by first uploading the hosted images to a public URL, then embedding that link within the markdown during the atomic page creation process.

What is the best way to convert markdown content into a Notion page with embedded images?▼

The best way to convert markdown into a Notion page with images is using an automated pipeline that handles image hosting, markdown conversion, and page creation under a target parent page via Notion MCP.

Why do my local image links break when publishing markdown to Notion?▼

Local image links break in Notion because the platform requires public URLs; this skill resolves the issue by uploading local images to public hosting before embedding them in the Notion page.