Migration guide

How to migrate from Confluence to BookStack

The hardest part of migrating notes or documentation isn't the text itself — it's the structure (folders, internal links, databases) and team permissions.

1. 1

   Export each space/page from Confluence

   Almost every notes app lets you export to Markdown, HTML or PDF from each page's or space's menu. Export root pages first, then subpages, to preserve the hierarchy.

2. 2

   Import the content into BookStack

   Most open source alternatives accept bulk Markdown/HTML import. Check BookStack's documentation for the exact format it expects — some require a specific folder structure.

3. 3

   Fix internal links

   Links between pages (wikilinks) almost never migrate automatically between different platforms. After importing, review the most-linked pages and fix broken references.

4. 4

   Re-invite your team

   Workspace permissions and members aren't exported. Create the spaces/teams in BookStack and re-invite each person with the right role.

These steps are a general guideline — the exact export menu can vary depending on Confluence's plan and version.