Import & Export

Admins can export the entire knowledge base and import it back — a portable, human-readable copy of your document content. (For a complete database snapshot, see Backups & restore instead.)

It’s in Settings → Import & export.

Export

Export all docs (.zip) downloads a zip containing:

manifest.json                          # spaces + a document index
documents/<space-slug>/<doc-slug>.md   # one file per document

Every .md file carries the document’s metadata as YAML front-matter (title, type, status, space, tags, summary, author, timestamps) followed by the Markdown body. Drafts are included.

Import

Upload an export zip — or any zip of front-matter Markdown files:

• Documents are matched to existing ones by (space, title) and updated in place; otherwise they’re created.
• Missing spaces are created automatically (using the manifest’s names/icons when present, otherwise the folder or front-matter value).
• type and status are validated (defaulting to knowledge / draft); tags accept a YAML list or a comma-separated string.

You get a summary of how many documents were created, updated, and skipped, with a warning for any file that couldn’t be read (e.g. a missing title).

Migrate from Confluence or Notion

Coming from another tool? Settings → Data → Migrate from another tool imports a Confluence or Notion export directly — no reshaping required.

1. Export from the source:
   • Confluence — Space settings → Export space → HTML, and download the zip.
   • Notion — Settings → Export (or the ••• menu on a page) → Markdown & CSV, with Include subpages turned on, and download the zip.
2. In CompassDocs, upload the zip. The format is auto-detected and you get a preview — the detected source and the number of pages and attachments found.
3. Choose the destination: a new space (named for you, editable) or an existing space, and whether pages arrive as drafts to review or are published.
4. Click Import.

What comes across:

• Page hierarchy becomes nested pages (Confluence’s page tree; Notion’s sub-page folders), up to the 3-level nesting limit — anything deeper is flattened to the deepest allowed parent.
• Formatting is converted to CompassDocs Markdown — headings, lists, tables, code blocks, and links. (Confluence’s HTML is converted automatically.)
• Images and file attachments are imported and every reference is rewritten to the imported copy, so nothing points back at the old tool.

The import is admin-only and recorded in the audit log. Because pages can arrive as drafts, you can review everything before publishing.

Large spaces

Vendor exports include their attachments, so the zip can be big — imports accept files up to 200 MB. For a very large Confluence instance, export one space at a time.

Uses

• Migrate from Confluence or Notion with the guided importer above (or from any other tool by shaping it into front-matter Markdown).
• Bulk-edit offline: export, edit the .md files, re-import.
• Move content between CompassDocs instances.