If your documentation already exists as files — a folder of Word docs, exported PDFs, or a Markdown repo — you don't need to rewrite it. This guide imports exist...
If your documentation already exists as files — a folder of Word docs, exported PDFs, or a Markdown repo — you don't need to rewrite it. This guide imports exist...
If your documentation already exists as files — a folder of Word docs, exported PDFs, or a Markdown repo — you don't need to rewrite it. This guide imports existing documents into Doxbrix, where they're converted into editable pages built from real Doxbrix blocks.
Who this is for
Anyone migrating documentation that lives in document files. For platform-specific migrations, see the Notion, Confluence, and GitBook guides.
Supported formats
| Format | Extensions |
|---|---|
| Word | `.docx` |
| `.pdf` | |
| HTML | `.html`, `.htm` |
| Markdown | `.md` |
| MDX | `.mdx` |
| Plain text | `.txt` |
Each file can be up to 20 MB.
Option A — Import in the app
In the editor, on a new line press <kbd>/</kbd> and choose Import Document (/doc).
Drag a file onto the drop zone or click Choose file.
Doxbrix converts the document into blocks — you'll see "imported as N blocks". Click Done.
Fix anything the converter couldn't map perfectly.
See Import content for the dialog details.
Option B — Import from the CLI
For bulk imports or docs-as-code workflows:
# Import a single document (optionally to a path, with a title)
dxb import file ./legacy/handbook.docx --into get-started/handbook --title "Handbook"
# Import an entire folder of docs (structure preserved)
dxb import repo ./old-docsdxb import repo mirrors the folder structure as spaces and groups, so an organized folder of Markdown becomes an organized Doxbrix project.
What converts well — and what needs cleanup
| Source element | Result |
|---|---|
| Headings | Mapped to H1–H4. |
| Bullet / numbered lists | Mapped to lists (consider `<Steps>` for procedures). |
| Tables | Mapped to Markdown tables. |
| Code blocks | Preserved with language where detectable. |
| Images | Uploaded and inserted with the [`<Image>`](/write/formatting-and-media#images) block. |
| Links | Internal links remapped where possible. |
Cleanup checklist
Ensure one H1 and no skipped levels.
Turn procedures into <Steps>, notes into <Tip>/<Warning>, and tabbed content into <Tabs>.
Update links that pointed at the old system to Doxbrix pages.
Give imported images descriptive alt text.
Use Scan with AI to find gaps, and Improve with AI to polish prose.