markdown-to-confluence

Publish Markdown content to a Confluence page via the Atlassian MCP server.

198|19|Updated May 7, 2026
One-click install
npx skills add https://github.com/testdouble/han --skill markdown-to-confluence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-confluence
Source: https://github.com/testdouble/han/tree/main/han-atlassian/skills/markdown-to-confluence
Command: npx skills add https://github.com/testdouble/han --skill markdown-to-confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Publishing local Markdown content to a Confluence location specified by the user, creating a new page or updating an existing one through the Atlassian MCP server. It does not write or generate the Markdown itself — the caller supplies an existing Markdown file.

Core Features & Use Cases

  • Publish to a Confluence location specified by the user (page URL or space + parent), creating a new page or updating an existing one.
  • Resolve the destination exactly and perform create or update with proper handling of drafts vs live pages.
  • Return the page URL on success and provide error details on failure.

Quick Start

Provide the Markdown file path and a Confluence destination, then run the skill to publish as draft by default.

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 Markdown content to a Confluence page?

You need a local Markdown file and a Confluence destination specified by a page URL or a space plus parent page. The skill connects through the Atlassian MCP server to resolve the target and performs the create or update action.

Does publishing Markdown to Confluence create a draft or go live by default?

Publishing Markdown to Confluence defaults to draft mode unless you explicitly request a live publish. The skill honors the specified publish mode when creating or updating the page via the Atlassian MCP server.

Can I update an existing Confluence page with a Markdown file?

Yes, you can update an existing Confluence page by providing the page URL as the destination along with your Markdown file. The skill resolves whether to create or update based on the specified target location.

Do I need the Atlassian MCP server to publish Markdown to Confluence?

The skill requires the Atlassian MCP server to resolve the exact Confluence destination and perform the page creation or update. It does not function as a standalone publishing tool without this MCP connection.

What is needed to specify a Confluence destination for Markdown publishing?

To specify a Confluence destination for Markdown publishing, provide either an existing page URL or a combination of a space and parent page. The skill resolves this input to determine where to create or update the content.

Can this skill generate or write the Markdown content for me?

No, this skill does not generate or write Markdown content. It strictly publishes an existing local Markdown file to Confluence, meaning the caller must supply the Markdown file before invoking the publish action.