BookStack to Confluence (Cloud) migration

[Diego Cela Fabián]

Hello!

Has anyone migrated from BookStack to Confluence (Cloud)?

If so, what would be the process?

Thanks!

[jguyer]

We are in the same boat of needing to migrate a ton of pages from bookstack over to Confluence. Any success with this? I'm still not seeing any add-ons in the marketplace for this.

[Shawn Doyle - ReleaseTEAM]

Hi @Diego Cela Fabián 

While I haven't done this exact import or worked with BookStack before, I have done many migrations into Confluence.

If I didn't find a Marketplace addon that already handles this, my approach would be to learn BookStack's export options. A quick Google search leads me to believe you can get an HTML export (as well as a PDF, but not as useful for a migration).

I would then inspect the exported HTML to get a feel for how the Confluence import will handle it. If needed, I would create a Python (or Perl) script to massage the HTML. Then, I would write a script to use Confluence's API to import it. Depending on how complicated the HTML export is, e.g. mostly text with some images, or very structured tables and divs, the script can become very detailed, as importing direct HTML is not as trivial as it should be.

https://developer.atlassian.com/server/confluence/confluence-rest-api-examples/

If you are only importing a small section of pages, it may be quicker to just use the Confluence GUI to import the HTML.  However, once you create an import script it will be handy in the future, and you got to learn something.