markdown-to-confluence

Publishes a local Markdown file to a specified Confluence page via the Atlassian MCP server.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/amirbiron/Han --skill markdown-to-confluence-amirbiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: markdown-to-confluence
Source: https://github.com/amirbiron/Han/tree/main/han-atlassian/skills/markdown-to-confluence
Command: npx skills add https://github.com/amirbiron/Han --skill markdown-to-confluence-amirbiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Moving documentation written in Markdown into Confluence normally means manual copy-paste, reformatting, and losing track of which page to update. This Skill automates the publishing step by creating or updating a Confluence page directly from an existing Markdown file through the Atlassian MCP server. ## Core Features & Use Cases - Create or update pages: Publish a Markdown file as a new Confluence page under a space or parent page, or update an existing page identified by URL. - Draft-first safety: Defaults to saving an unpublished draft so nothing goes live unintentionally, with an explicit live mode when requested. - User-specified destinations: Requires an exact page URL or space plus parent page instead of guessing locations through search. - Use Case: After generating project documentation locally, point the Skill at the Markdown file and a Confluence parent page URL to publish it as a draft for team review. ## Quick Start Publish the file docs/architecture.md as a draft child page under this Confluence page URL using the markdown-to-confluence skill.

Frequently Asked Questions about markdown-to-confluence

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

FAQPage Schema
How do I publish a Markdown file to Confluence?▼

Provide the path to your Markdown file and an exact Confluence destination, either a page URL or a space plus optional parent page. The Skill posts the content via the Atlassian MCP server using contentFormat markdown, creating or updating the page as a draft by default.

How do I update an existing Confluence page from Markdown?▼

Pass the Confluence page URL of the page you want to update along with the Markdown file. The Skill reads the current page for its version, then calls the update tool with the new body, keeping the existing title unless you ask to rename it.

Does publishing Markdown to Confluence require the Atlassian MCP server?▼

Yes, a configured and authenticated Atlassian MCP server is a hard requirement. The Skill runs a preflight check for accessible Atlassian resources and stops immediately with instructions if the server is unavailable or unauthenticated.

Can I publish a Confluence page as a draft instead of live?▼

Yes, draft is the default mode so nothing goes live unintentionally. The page is saved with draft status and you must review and publish it in Confluence, or re-run the Skill with live mode to publish immediately.

Why do Mermaid diagrams show as code blocks in Confluence?▼

Confluence does not render Mermaid natively without a Mermaid macro, so fenced mermaid blocks publish as plain code. The Skill leaves them intact and notifies you so you can add a rendering macro or convert them manually.

Does this Skill search Confluence to find the right page?▼

No, it never searches Confluence for a destination because large instances contain many similarly named pages. You must supply an exact page URL or a space plus parent page, and the Skill asks for one if it is missing.