Notion is great for working docs, but it's not built to be a fast, branded, searchable public documentation site with AI answers. This guide walks you through mo...
Notion is great for working docs, but it's not built to be a fast, branded, searchable public documentation site with AI answers. This guide walks you through mo...
Notion is great for working docs, but it's not built to be a fast, branded, searchable public documentation site with AI answers. This guide walks you through moving your Notion content into Doxbrix — preserving your page hierarchy and converting blocks into Doxbrix components.
Who this is for
Teams using Notion for documentation who want a purpose-built docs site: custom domain, branding, AI Ask, review workflows, and analytics.
What carries over
| Notion | Becomes in Doxbrix |
|---|---|
| Workspace / teamspace | A [project](/organize/projects) |
| Top-level pages | [Spaces](/organize/spaces-and-navigation) or groups |
| Nested pages | [Groups](/organize/spaces-and-navigation) and pages |
| Headings, lists, tables | Native blocks |
| Callouts | [`<Info>`/`<Tip>`/`<Warning>`](/write/blocks-and-components#callout-blocks) |
| Toggles | [`<Accordion>`/`<Expandable>`](/write/blocks-and-components#accordion-and-expandable-blocks) |
| Code blocks | Fenced code with language |
| Images & files | Uploaded and inserted with the [`<Image>`](/write/formatting-and-media#images) block |
Step 1 — Export from Notion
In Notion, open the workspace or page you want to migrate, click ••• → Export.
Select Markdown & CSV as the format, and Include subpages to capture your full hierarchy.
Notion produces a .zip. Unzip it — you'll get a folder of .md files mirroring your page tree.
Step 2 — Import into Doxbrix
The exported folder is a structured Markdown repo, perfect for a bulk import:
dxb import repo ./notion-exportThis mirrors the folder structure as spaces and groups and converts each .md file into a draft page. Alternatively, use Import document in the app for a handful of pages — see Import files.
Step 3 — Fix Notion-specific quirks
Notion exports have a few patterns worth cleaning up:
Notion appends long IDs to file and folder names. The importer trims these, but double-check slugs and rename anything awkward.
Notion internal links become relative paths. Verify they resolve to the right Doxbrix pages; fix any that don't.
Notion toggles import as collapsible content — upgrade them to <Accordion> and callouts to the right callout variant.
Notion databases export as CSV. Recreate the important ones as tables or restructure them as pages.
Step 4 — Reshape the structure
Notion hierarchies are often deeper than a good docs site needs. Take the chance to flatten and reorganize:
- Promote major sections to spaces (top-bar).
- Group related pages into groups.
- Use the CLI or the app to move and nest pages.
Step 5 — Polish and publish
Use Scan with AI to find weak pages.
Polish imported prose with Improve with AI.
Brand your site and publish.