---
title: "Export your docs"
url: "/help/buuk/export-your-docs"
updated: "2026-11-13T13:32:09.971Z"
---
# Export your docs

Your content is never locked in. The Buuk CLI exports published docs as plain files — a backup, a migration path, or something to commit to a repository.

## The export command

The export command looks like this:

```bash
buuk export --workspace your-slug --format mint --output ./docs-out
```

Use these flags to shape the export:

- format — `mdx+openapi` (the default) or `mint`.
- output — the target directory. Defaults to `./buuk-export`.
- workspace — the workspace slug. You can set it as `BUUK_WORKSPACE` instead.

Exports authenticate with a token from **Settings → Developers → API tokens**. Set it as `BUUK_API_TOKEN`, and point `BUUK_API_URL` at your app's base URL if you are not running locally. See [API tokens and MCP](./api-tokens-and-mcp).

## What you get

- `help/`, `guides/`, and `faq/` each holding one .mdx per published article, with title, kind, section, and slug in the frontmatter.
- `openapi/` with each API spec as a JSON file, when the workspace has specs.
- `changelog/` with one .mdx per release.
- With `--format mint`, a `mint.json` that maps the whole navigation: API Reference, Guides, Help, FAQ, and Changelog tabs.

> [!NOTE]
> Exports include published pages only. Drafts never export, and uploaded media is not bundled — the files carry the article text and specs.

## When you would use it

- Backups — export on a schedule and commit the output, so your docs live in version control too.
- Moving on — the markdown and mint.json are plain files another tool can read when you leave.
- Docs-as-code pipelines — render the export your own way, or review doc changes through pull requests.

For a quick copy without the CLI, **Settings → Import content** has an **Export your help center** action that downloads published articles and translations as a zip of markdown files.

## Related

- [Migration overview](./migration-overview)
- [Import markdown](./import-markdown)
- [API tokens and MCP](./api-tokens-and-mcp)
- [Publish your help center](./publish-your-help-center)