confluence-markdown

Synchronize Confluence pages with Markdown files using Python libraries.

3|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/lan99mu/confluence-markdown-mcp --skill confluence-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence-markdown
Source: https://github.com/lan99mu/confluence-markdown-mcp/tree/main
Command: npx skills add https://github.com/lan99mu/confluence-markdown-mcp --skill confluence-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables users to synchronize content between Confluence wiki pages and local Markdown files, streamlining content management and editing workflows.

Core Features & Use Cases

  • Pull pages from Confluence and save as Markdown with full formatting and attachments.
  • Push local Markdown updates back to existing Confluence pages, including attachments.
  • Preview pages inline via resources, suitable for quick review and editing.
  • Supports converting complex Confluence macros, tables, code blocks, and attachments to Markdown, ensuring round-trip fidelity.

Quick Start

Use the confluence-markdown skill to download a Confluence page with ID 12345 into the local directory for editing.

Frequently Asked Questions about confluence-markdown

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

FAQPage Schema
How do I sync Confluence pages with local Markdown files?

Syncing Confluence pages with Markdown files allows you to pull content to local directories and push updates back. It preserves formatting, tables, and attachments during conversion to maintain round-trip fidelity for technical documentation.

Can I convert Confluence macros to Markdown without losing content?

Converting Confluence macros to Markdown is fully supported to preserve content integrity. The Skill handles complex macros, code blocks, and attachments, ensuring that formatting remains intact during the synchronization workflow.

How do I pull a Confluence page down to my local machine for editing?

Pulling a Confluence page to a local directory saves it as a Markdown file with full formatting and attachments. You can target a specific page ID to download content for offline editing and version control.

Does the Confluence Markdown sync support attachments and tables?

Confluence Markdown sync supports attachments and complex tables. It employs Python libraries for API communication and file handling to ensure that all page elements are converted accurately between formats.

What is the best way to maintain version control for Confluence documentation?

Maintaining version control for Confluence documentation is best achieved by syncing pages to local Markdown files. This approach enables technical teams to edit content offline and push updates back to existing pages seamlessly.

Are there limitations when pushing local Markdown updates to existing Confluence pages?

Pushing local Markdown updates to existing Confluence pages preserves attachments and formatting. The workflow relies on Python libraries for API communication to ensure content conversion maintains round-trip fidelity without data loss.