Confluence文档管理技能：Markdown转换、图片上传与Git同步指南

confluence by spillwavesolutions/confluence-skill

223 周安装量

22 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/spillwavesolutions/confluence-skill --skill confluence

开发运维技术文档知识管理

🇨🇳中文介绍

Confluence 管理技能

通过 Claude Code 管理 Confluence 文档：将页面下载为 Markdown、上传包含图片的大型文档、格式转换以及集成 Mermaid/PlantUML 图表。

快速决策矩阵

任务	工具	备注
读取页面	MCP 工具	`confluence_get_page`, `confluence_search`
小型纯文本上传 (<10KB)	MCP 工具	`confluence_create_page`, `confluence_update_page`
大型文档 (>10KB)

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

将页面下载为 Markdown

# 单个页面
python3 ~/.claude/skills/confluence/scripts/download_confluence.py 123456789

# 包含子页面
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --download-children 123456789

# 自定义输出目录
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --output-dir ./docs 123456789

详情请参阅下载指南。

上传包含图片的页面

首先使用 design-doc-mermaid 或 plantuml 技能将图表转换为图片
使用标准 Markdown 引用图片：![描述](./images/diagram.png)
通过 REST API 上传：

python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \

    document.md --id PAGE_ID

详情请参阅图片处理最佳实践。

mcp__atlassian-evinova__confluence_search({
  query: 'space = "DEV" AND text ~ "API"',
  limit: 10
})

创建/更新页面（小型文档）

// 创建页面
mcp__atlassian-evinova__confluence_create_page({
  space_key: "DEV",
  title: "API Documentation",
  content: "h1. Overview\n\nContent here...",
  content_format: "wiki"
})

// 更新页面
mcp__atlassian-evinova__confluence_update_page({
  page_id: "123456789",
  title: "Updated Title",
  content: "h1. New Content",
  version_comment: "Updated via Claude Code"
})

从 Git 同步 (mark CLI)

在 Markdown 文件中添加元数据：

<!-- Space: DEV -->
<!-- Parent: Documentation -->
<!-- Title: API Guide -->

# API Guide
Content...

同步到 Confluence：

mark -f documentation.md
mark --dry-run -f documentation.md  # 先预览

详情请参阅mark 工具指南。

完整的转换矩阵请参阅转换指南。

Markdown	Wiki Markup
`# 标题`	`h1. 标题`
`粗体`	`粗体`
`斜体`	`_斜体_`
`代码`	`{{代码}}`
`[文本](url)`	`[文本

references/ 目录中的详细指南：

指南	用途
Wiki Markup 参考	Confluence Wiki Markup 完整语法
转换指南	Markdown 到 Wiki Markup 转换规则
存储格式	Confluence XML 存储格式详情
图片处理	图片、Mermaid、PlantUML 工作流程
mark 工具指南	使用 mark CLI 进行 Git 到 Confluence 同步
故障排除	常见错误及解决方案

可用的 MCP 工具

工具	描述
`confluence_search`	使用 CQL 或文本搜索
`confluence_get_page`	通过 ID 或标题检索页面
`confluence_create_page`	创建新页面
`confluence_update_page`	更新现有页面
`confluence_delete_page`	删除页面
`confluence_get_page_children`	获取子页面
`confluence_add_label`	为页面添加标签
`confluence_get_labels`	获取页面标签
`confluence_add_comment`	为页面添加评论
`confluence_get_comments`	获取页面评论

脚本	用途
`scripts/upload_confluence_v2.py`	上传包含图片的大型文档
`scripts/download_confluence.py`	将页面下载为 Markdown
`scripts/convert_markdown_to_wiki.py`	将 Markdown 转换为 Wiki Markup
`scripts/convert_wiki_to_markdown.py`	将 Wiki Markup 转换为 Markdown
`scripts/render_mermaid.py`	渲染 Mermaid 图表

版本 : 2.1.0 | 最后更新 : 2025-01-21

🇺🇸English

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.

Quick Decision Matrix
MCP Size Limits
Prerequisites
Core Workflows
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:

# Upload large document
python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id 780369923

# Dry-run preview
python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id 780369923 --dry-run

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

# Single page
python3 ~/.claude/skills/confluence/scripts/download_confluence.py 123456789

# With child pages
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --download-children 123456789

# Custom output directory
python3 ~/.claude/skills/confluence/scripts/download_confluence.py --output-dir ./docs 123456789

See Downloading Guide for details.

Upload Pages with Images

Convert diagrams to images first using design-doc-mermaid or plantuml skills
Reference images with standard markdown: ![Description](./images/diagram.png)
Upload via REST API:

python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \

    document.md --id PAGE_ID

See Image Handling Best Practices for details.

Search Confluence

mcp__atlassian-evinova__confluence_search({
  query: 'space = "DEV" AND text ~ "API"',
  limit: 10
})

Create/Update Pages (Small Documents)

// Create page
mcp__atlassian-evinova__confluence_create_page({
  space_key: "DEV",
  title: "API Documentation",
  content: "h1. Overview\n\nContent here...",
  content_format: "wiki"
})

// Update page
mcp__atlassian-evinova__confluence_update_page({
  page_id: "123456789",
  title: "Updated Title",
  content: "h1. New Content",
  version_comment: "Updated via Claude Code"
})

Sync from Git (mark CLI)

Add metadata to Markdown files:

<!-- Space: DEV -->
<!-- Parent: Documentation -->
<!-- Title: API Guide -->

# API Guide
Content...

Sync to Confluence:

mark -f documentation.md
mark --dry-run -f documentation.md  # Preview first

See mark Tool Guide for details.

Convert Between Formats

See Conversion Guide for the complete conversion matrix.

Quick reference:

Markdown	Wiki Markup
`# Heading`	`h1. Heading`
`bold`	`bold`
`italic`	`_italic_`
`code`	`{{code}}`

Reference Documentation

Detailed guides in the references/ directory:

Guide	Purpose
Wiki Markup Reference	Complete syntax for Confluence Wiki Markup
Conversion Guide	Markdown to Wiki Markup conversion rules
Storage Format	Confluence XML storage format details
Image Handling	Workflows for images, Mermaid, PlantUML
mark Tool Guide	Git-to-Confluence sync with mark CLI
Troubleshooting	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`

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

Weekly Installs

219

Repository

spillwavesoluti…ce-skill

GitHub Stars

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykWarn

Installed on

opencode197

gemini-cli192

github-copilot189

codex185

cursor170

amp167

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

79,900 周安装