confluence

Convert Markdown files to Confluence Storage Format and publish via REST API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/garimto81/claude --skill confluence-garimto81
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence
Source: https://github.com/garimto81/claude/tree/main/.claude/skills/confluence
Command: npx skills add https://github.com/garimto81/claude --skill confluence-garimto81

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandoc, mmdc, requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of Markdown files into Confluence-formatted pages, streamlining documentation workflows and ensuring consistent publishing.

Core Features & Use Cases

  • Markdown to Confluence Conversion: Transforms Markdown content into Confluence Storage Format.
  • Automated Publishing: Uploads converted content directly to specified Confluence pages.
  • Image and Diagram Handling: Automatically embeds images and renders Mermaid diagrams as PNGs.
  • Use Case: Quickly publish meeting notes, technical documentation, or project plans written in Markdown to a central Confluence knowledge base without manual copy-pasting or format conversion.

Quick Start

Use the confluence skill to publish the file 'my-document.md' to Confluence page with ID 12345.

Frequently Asked Questions about confluence

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

FAQPage Schema
How do I publish Markdown files to Confluence pages automatically?

To publish Markdown to Confluence automatically, you convert Markdown into Confluence Storage Format and upload it via the Confluence REST API. This eliminates manual copy-pasting and ensures consistent formatting.

Does publishing Markdown to Confluence support Mermaid diagrams?

Publishing Markdown to Confluence supports Mermaid diagrams by automatically rendering them as PNG images. The workflow uses mmdc to handle diagram conversion before uploading the content.

Do I need pandoc and mmdc installed to convert Markdown to Confluence Storage Format?

Yes, you need pandoc and mmdc installed to convert Markdown to Confluence Storage Format. Pandoc handles Markdown transformation while mmdc renders Mermaid diagrams, alongside Python requests for API uploads.

What is the best way to automate technical documentation publishing from Markdown to a Confluence knowledge base?

The best way to automate technical documentation publishing to a Confluence knowledge base is using a conversion workflow that transforms Markdown directly into Confluence Storage Format and uploads it through the REST API.

Can I embed local images when converting Markdown to Confluence pages?

Yes, you can embed local images when converting Markdown to Confluence pages. The conversion process automatically handles image embedding to ensure visual assets are correctly uploaded and displayed on the page.

Why are my Mermaid diagrams not rendering when publishing to Confluence?

Mermaid diagrams may not render when publishing to Confluence if the mmdc dependency is missing. Successful rendering requires mmdc to convert diagrams into PNG images before the API upload.