Has anyone been involved in migrating Azure DevOps (ADO) Wiki to Confluence?
If yes, I'd appreciate your inputs on what's the best possible way to migrate the data.
Mesut's and zrcic's steps cover the wiki export well. One thing that often comes up in these moves: ADO wiki pages tend to link to ADO work items. If the work items move to Jira, or stay in ADO and need to sync, plan the link rewrite at the same time. Otherwise every converted page keeps pointing to ADO. If both systems stay in use, a two-way ADO ↔ Jira sync keeps the links meaningful. Disclosure: I work at ZigiWave, which builds ZigiOps for this kind of sync. A one-time find-and-replace of work-item URLs to Jira keys is fine if ADO is being retired.
Hi @Sambhav Swain
I don't know if there is a easy way to migrate it.
You can try to use this (didn't test it) -> https://pypi.org/project/md2cf/ because Azure DevOps uses Markdown and Confluence uses XHTML, native copy-pasting may lose formatting.
Regards,
Seba
Hi Sambhav, a few things that make this easier:
Disclosure: I build SourceDocs, a Forge app that shows a Markdown file from Azure Repos (also GitHub, GitLab, Bitbucket) on a Confluence page, private repos included. It does not migrate the wiki and does not render the ADO-only syntax above, so steps 1 to 3 are still the way to move the wiki itself.
Hi Sambhav, Mesut's steps above are the right way to get the files out. If you'd rather keep the wiki in Git and have Confluence act as an always-current copy instead of doing a one-time move, there's another option.
Disclosure: I'm the developer of RepoPages, a Confluence Cloud app on the Marketplace. Since an ADO wiki is already a Git repo, an Azure Pipelines step can send its Markdown files to Confluence on every push. Each .md file becomes a native Confluence page and folders become parent pages. Later pushes update only the files that changed, and renamed files move their page instead of creating a duplicate. The app never connects to Azure DevOps; the pipeline sends a signed payload, so a private repo needs no access grant.
Happy to help if you try it.
It looks like you're new here. Sign in or register to get started.