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.