Migrating Posts from Atlassian Confluence

AI-generated summary

In a discussion about migrating content from Atlassian Confluence to Discourse, Tris20 asks if anyone has successfully migrated topics, noting that Confluence’s export options (HTML, XML, PDF, Word) are not ideal and may require manual extraction. pfaffman recommends using XML, as the Discourse import script (specifically discus) is built for it, and suggests modifying the script to match Confluence’s XML schema. Alternatively, pfaffman points to the Marketplace channel or Literate Computing’s migration service for professional help. Tris20 replies, acknowledging the challenge—especially given past frustrations with XML—but notes migration may not begin for months, and hopes official support might be available by then, especially as Atlassian’s rising costs may push more companies toward Discourse. pfaffman reassures that if Tris20 has any XML experience, adapting the script should be manageable, and wishes them luck.

I’m wondering if anyone has had any success, or even attempted a migration of topics from confluence? When reading the confluence pages I see a few export options

  • HTML
  • XML
  • PDF
  • Word

None of these look too great. I expect we will need to do some extraction from html or xml – whichever offers the easiest extraction.

Anyone tried this, or have any good suggestions?

XML is what you want. The discus import script appears to use XML. I thought that there were a couple others if you grep in script/import_scripts, but I don’t see them.

So you’d get the XML dump and then modify the discus import script to use whatever schema that you get from Confluence. If you don’t want to do it yourself, you can post in Marketplace and/or see Redirecting…

@pfaffman Thanks for the response. I worried this was the case. I know we can extract it, but my experiences with xml in the past haven’t been particularly pleasant. It will be maybe even a few months before we begin this, and maybe support is possible when we move to an official server. Attlasian are increasing costs these days, so I’d be surprised if there isn’t an increase of companys that will consider Discourse as a good migration choice.

If you’re experienced with it at all then you may be in fine shape. I think I’ve modified that script before and it was reasonably straightforward. Good luck!