如何通过REST API向Confluence页面添加Markdown内容？

• 转换Markdown为Confluence存储格式
  Confluence的REST API创建/更新页面仅支持其原生的基于XML的XHTML存储格式，不直接兼容Markdown。所以核心步骤是先将Markdown内容转换为该格式，可借助第三方工具实现：

  • Python环境可使用markdown2confluence库，示例代码：

    from markdown2confluence import convert
    
    markdown_content = "# 测试标题\n这是一段带**加粗**的Markdown内容"
    confluence_storage = convert(markdown_content)
    

  • JavaScript环境可使用confluence-markdown-converter包完成双向转换。

• 调用REST API提交转换后的内容
  用你已掌握的页面创建/更新API接口，将转换后的存储格式内容填入请求体的body.storage.value字段，同时指定body.storage.type为"storage"。以更新页面为例，请求体示例：

  {
    "version": {
      "number": 2
    },
    "body": {
      "storage": {
        "value": "<h1>测试标题</h1><p>这是一段带<strong>加粗</strong>的Markdown内容</p>",
        "type": "storage"
      }
    }
  }
  

• Confluence Cloud的简化方案
  若使用Confluence Cloud，API支持"wiki"格式输入，部分基础Markdown语法可被自动识别转换。可尝试将Markdown内容放入body.wiki.value，指定type为"wiki"，但该方式对复杂语法（如嵌套表格、代码块）的支持有限，需测试验证。

• 关键注意事项

  • 第三方转换工具对部分特殊Markdown语法（如自定义样式、复杂公式）的支持可能不全，需测试后调整内容适配。
  • Confluence Server/Data Center版本暂无官方原生Markdown支持，相关Jira问题（CONFSERVER-55637、CONFSERVER-59543）仍未解决，必须依赖转换工具完成适配。

内容的提问来源于stack exchange，提问作者jerdub1993