Manage Confluence documentation with downloads, uploads, conversions, and diagrams. Use when asked to "download Confluence pages", "upload to Confluence", "convert Wiki Markup", "sync markdown to Confluence", "create Confluence page", or "handle Confluence images".

Confluence Management Skill Manage Confluence documentation through Claude Code: download pages to Markdown, upload large documents with images, convert between formats, and integrate Mermaid/PlantUML diagrams. Table of Contents [Quick Decision Matrix]( quick decision matrix) [MCP Size Limits]( mcp size limits) [Prerequisites]( prerequisites) [Core Workflows]( core workflows) [Reference Documentation]( reference documentation) Quick Decision Matrix Task Tool Notes Read pages MCP tools confluence get page , confluence search Small text only uploads (<10KB) MCP tools confluence create page , confluence update page Large documents ( 10KB) upload confluence v2.py REST API, no size limits Documents with images upload confluence v2.py Handles attachments automatically Git to Confluence sync mark CLI Best for CI/CD workflows Download pages to Markdown download confluence.py Converts macros, downloads attachments MCP Size Limits MCP tools have size limits (10 20KB) for uploads. For large documents or pages with images, use the REST API via upload confluence v2.py : MCP works for reading pages but not for uploading large content. Prerequisites Required Atlassian MCP Server ( mcp atlassian evinova ) with Confluence credentials Optional mark CLI : Git to Confluence sync ( brew install kovetskiy/mark/mark ) Mermaid CLI : Diagram rendering ( npm install g @mermaid js/mermaid cli ) Core Workflows Download Pages to Markdown See [Downloading Guide](references/conversion guide.md) for details. Upload Pages with Images 1. Convert diagrams to images first using design doc mermaid or plantuml skills 2. Reference images with standard markdown: ![Description](./images/diagram.png) 3. Upload via REST API: See [Image Handling Best Practices](references/image handling best practices.md) for details. Search Confluence Create/Update Pages (Small Documents) Sync from Git (mark CLI) Add metadata to Markdown files: Sync to Confluence: See [mark Tool Guide](references/mark tool guide.md) for details. Convert Between Formats See [Conversion Guide](references/conversion guide.md) for the complete conversion matrix. Quick reference: Markdown Wiki Markup Heading h1. Heading bold bold italic italic code {{code}} [text](url) [text\ url] Reference Documentation Detailed guides in the references/ directory: Guide Purpose [Wiki Markup Reference](references/wiki markup guide.md) Complete syntax for Confluence Wiki Markup [Conversion Guide](references/conversion guide.md) Markdown to Wiki Markup conversion rules [Storage Format](references/confluence storage format.md) Confluence XML storage format details [Image Handling](references/image handling best practices.md) Workflows for images, Mermaid, PlantUML [mark Tool Guide](references/mark tool guide.md) Git to Confluence sync with mark CLI [Troubleshooting](references/troubleshooting guide.md) Common errors and solutions Available MCP Tools Tool Description confluence search Search using CQL or text confluence get page Retrieve page by ID or title confluence create page Create new page confluence update page Update existing page confluence delete page Delete page confluence get page children Get child pages confluence add label Add label to page confluence get labels Get page labels confluence add comment Add comment to page confluence get comments Get page comments Utility Scripts Script Purpose scripts/upload confluence v2.py Upload large documents with images scripts/download confluence.py Download pages to Markdown scripts/convert markdown to wiki.py Convert Markdown to Wiki Markup scripts/convert wiki to markdown.py Convert Wiki Markup to Markdown scripts/render mermaid.py Render Mermaid diagrams Version : 2.1.0 Last Updated : 2025 01 21