如何实现Azure DevOps Wiki页面到Confluence页面的迁移？

手动导出导入方案 #

• 导出Azure DevOps Wiki内容
  • 单页面：在目标页面右上角点击「...」，选择「导出为Markdown」保存文件
  • 整个Wiki库：通过Git克隆Wiki仓库，执行命令 git clone <你的Azure DevOps Wiki仓库URL>，获取所有页面的Markdown文件
• 格式适配转换
  • 替换内部链接：将Azure DevOps的[[页面名称]]格式改为Confluence兼容的[页面名称](Confluence页面ID/相对路径)
  • 处理图片：下载Azure DevOps Wiki中的图片，后续上传为Confluence页面附件后替换图片链接
  • 统一表格、列表格式：调整部分Azure DevOps独有的Markdown语法，适配Confluence的渲染规则
• 导入Confluence
  • 单页面：新建页面后选择「从Markdown导入」，上传转换后的文件
  • 批量导入：进入空间设置，找到「导入内容」，选择Markdown批量导入，按层级上传文件

API/脚本自动化方案 #

• 获取Azure DevOps Wiki数据
  • 调用Azure DevOps REST API批量拉取页面内容、层级结构和附件信息，示例接口：

    GET https://dev.azure.com/{组织名}/{项目名}/_apis/wiki/wikis/{WikiID}/pages?api-version=7.1-preview.1
    

  • 下载页面关联的图片、附件等资源
• 格式自动转换
  • 编写脚本（如Python）处理内容：自动替换链接格式、转换代码块样式、处理图片路径映射
• 上传至Confluence
  • 调用Confluence REST API创建页面，设置父节点以保留原有层级：

    POST /wiki/rest/api/content
    

  • 通过Confluence API上传附件并更新页面中的图片链接：

    POST /wiki/rest/api/content/{页面ID}/child/attachment
    

第三方工具方案 #

• 选择专门的Wiki迁移工具，这类工具通常支持批量迁移Azure DevOps Wiki到Confluence，自动处理格式转换、层级保留和附件迁移，无需手动编写脚本

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