confluence

Convert Markdown to Confluence Wiki Markup and update pages via REST.

62|9|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/SpillwaveSolutions/confluence-skill --skill confluence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence
Source: https://github.com/SpillwaveSolutions/confluence-skill/tree/main/.
Command: npx skills add https://github.com/SpillwaveSolutions/confluence-skill --skill confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/server-atlassian, mark, @mermaid-js/mermaid-cli, markdown2confluence, requests, python-dotenv, PyYAML, markdownify, beautifulsoup4, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solves? This skill eliminates the manual overhead and inconsistencies often associated with managing documentation in Confluence. It automates format conversions, streamlines diagram integration, and ensures your Confluence content stays in sync with your Git repositories, saving time and reducing errors.

Core Features & Use Cases

  • Effortless Page Management: Create, update, search, and organize Confluence pages with natural language commands, ensuring proper hierarchy and labeling.
  • Seamless Format Conversion: Bidirectionally convert content between Markdown and Confluence Wiki Markup, preserving formatting and handling complex structures.
  • Automated Diagram Integration: Extract and render Mermaid diagrams from Markdown, then upload and embed them directly into Confluence pages as images.
  • Git-to-Confluence Synchronization (Documentation-as-Code): Integrate with the mark CLI tool to automatically sync Markdown documentation from your Git repository to Confluence, perfect for CI/CD pipelines.
  • Use Case: A development team maintains all their API documentation in Markdown files within a Git repository, including architecture diagrams in Mermaid syntax. Using this skill, they can automatically publish and update these documents to a Confluence space, ensuring the documentation is always current with the codebase without any manual copy-pasting or formatting adjustments.

Quick Start

Create a Confluence page from this Markdown document in the DEV space titled 'API Guide'. Search Confluence for pages about API authentication. Convert this Wiki Markup to Markdown.

Frequently Asked Questions about confluence

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

FAQPage Schema
How do I sync Markdown documentation from Git to Confluence automatically?

Git-to-Confluence synchronization converts and uploads Markdown files directly to Confluence pages via the mark CLI tool, keeping documentation current with your codebase without manual copy-pasting. This integrates seamlessly into CI/CD pipelines for documentation-as-code workflows.

Can I convert Markdown to Confluence Wiki Markup and back?

Bidirectional format conversion between Markdown and Confluence Wiki Markup preserves formatting and handles complex structures. The Skill supports both directions, enabling you to work in your preferred format while maintaining Confluence compatibility.

How do I embed Mermaid diagrams into Confluence pages?

Mermaid diagrams are extracted from Markdown, rendered as images, and uploaded directly to Confluence pages as embedded attachments. This automates diagram integration without manual rendering or file uploads.

What file formats and tools does this Skill work with?

The Skill processes Markdown and Wiki Markup formats, integrates with the mark CLI, renders Mermaid and PlantUML diagrams, and uses the Atlassian MCP server for REST API communication with Confluence across global, project, and workspace installations.

Can I create and update Confluence pages programmatically with natural language commands?

Pages can be created, updated, searched, and organized through automated commands that handle proper hierarchy and labeling. The Skill manages version control and metadata via YAML frontmatter, reducing manual page administration.

Does this Skill handle image attachments and complex page structures?

Image and attachment handling is built into the conversion and upload process, supporting complex page structures and maintaining proper formatting through Wiki Markup conversion and REST API uploads.

Related Skills