---
title: "Exportação"
description: "Baixe um espaço ou uma pasta em um único ZIP com os seus arquivos Markdown — com estrutura e identidade preservadas, sem perder nada."
---

# Exportação

A exportação baixa um espaço inteiro — ou uma única pasta — em um único ZIP de arquivos Markdown. Como os seus arquivos são a fonte da verdade (o princípio file-first), a exportação os lê direto do disco em vez de reconstruí-los a partir de um índice: o pacote leva os **arquivos de verdade**, com o `notarium-id` no frontmatter de cada um.

É justamente por isso que a exportação é **reversível** — dá para trazer tudo de volta pela [importação](/docs/import-export/import/) ou levar para outra instância sem perder estrutura, identidade nem datas. No fundo, exportar não é "tirar os dados para fora"; é uma forma prática de empacotar o que já está no disco na forma dos seus arquivos.

## Como exportar

A exportação fica na aba **Export**, nas configurações do espaço:

- O botão enfileira uma tarefa; a partir daí você acompanha uma barra de progresso com porcentagem (assim que o número de notas é conhecido) e um botão **Cancel**.
- Quando fica pronto, o pacote é baixado automaticamente; ao lado permanecem os botões **Download .zip** (baixar de novo) e **Export again** (rodar a exportação outra vez).
- Sair da aba e voltar é seguro: ao retornar, você vê de novo a tarefa em andamento ou o arquivo pronto para baixar.

Dá para exportar uma **única pasta** pelo menu de contexto da árvore — o item **Export folder**. É a mesma tarefa, só que restrita a uma subárvore; o progresso aparece em um toast "fixo" com botão de cancelar.

## Opções

Os dois caminhos de exportação aceitam o mesmo conjunto de parâmetros:

| Parâmetro | Valores | O que faz |
|---|---|---|
| `scope` | `user` (padrão) · `all` | `user` — apenas as suas notas; `all` — tudo o que o espaço contém, incluindo o mount de memória do agente (`.notarium/memory`). |
| `frontmatter` | `keep` (padrão) · `strip` | `keep` grava o arquivo como está; `strip` corta o bloco YAML — uma cópia limpa para leitura. |
| `folder` | caminho | Restringe a exportação a uma subárvore (o que o **Export folder** faz). |

> [!warning] `frontmatter=strip` quebra a reimportação
> Cortar o frontmatter gera uma cópia com perdas: junto com o bloco YAML você perde o `notarium-id` e as tags. Um pacote assim é prático para repassar notas para leitura, mas você não consegue mais importá-lo de volta sem perdas. Para migrar dados, fique com `keep` (o padrão).

> [!important] Exportação não é backup da instância
> Mesmo com `scope=all`, o pacote da exportação carrega só os arquivos Markdown do espaço. Não há banco de metadados dentro dele: nem contas, nem permissões de acesso, nem histórico de versões, nem estado das tarefas. Não dá para restaurar uma instância a partir dele. Backup é uma operação à parte, feita por um comando embutido na imagem — veja [Backup e restauração](/docs/self-hosting/backup/).

## Como funciona por baixo dos panos

A exportação foi feita para trabalhar em streaming, para que uma base de conhecimento arbitrariamente grande nunca fique retida na memória:

- **Tarefa assíncrona por padrão.** Quando o host tem banco de metadados (a norma na auto-hospedagem), a exportação é uma tarefa durável: um worker em segundo plano monta o ZIP no armazenamento de artefatos e entrega o arquivo pronto com suporte a download retomável. Aba fechada, conexão caída ou reinício do servidor não comprometem a exportação.
- **O download não passa por buffer.** O navegador transmite o pacote pronto direto para o disco e tira o nome do cabeçalho da resposta — uma base de conhecimento grande não fica retida na memória da aba.
- **Cancelar interrompe o trabalho.** Um download cancelado para de puxar notas — o servidor não fica lendo a base de conhecimento inteira à toa.

```mermaid
flowchart LR
  notes[(Notas Markdown)] -->|ler do disco| worker[Worker em segundo plano]
  worker -->|ZIP| artifact[Artefato da tarefa]
  artifact -->|download| user([Navegador])
```

> [!note] Exportação sem banco de metadados
> Em um host sem banco de metadados (ele só está ausente no modo `AUTH_MODE=none`) não existe camada de tarefas: a exportação segue o caminho síncrono de streaming — o mesmo ZIP é entregue como download direto dentro de uma única requisição, sem progresso e sem download retomável. Muda só a forma de entrega; o resultado é o mesmo.

## Limites

- **Um espaço por vez.** Espaços são armazenamentos isolados, cada um com seu próprio controle de acesso; para exportar vários, exporte um de cada vez.
- **O artefato tem TTL.** O ZIP pronto fica guardado por um tempo limitado (7 dias por padrão) e é removido pelo coletor de lixo; até expirar, dá para baixá-lo de novo.
- **Anexos binários não são exportados.** O pacote leva o texto das notas — arquivos Markdown.
- **Cancelar, mas não pausar.** Uma tarefa pode ser cancelada; não há como pausar e retomar.

## A seguir

- [Importação](/docs/import-export/import/) — traga um pacote de volta ou mova a base de conhecimento para outra instância.
- [Visão geral da seção](/docs/import-export/) — por que o file-first torna importação e exportação baratas.