---
title: "Exportación"
description: "Descarga un espacio o una carpeta como un único ZIP de archivos Markdown: estructura e identidad intactas, sin perder nada."
---

# Exportación

La exportación descarga un espacio entero, o una sola carpeta, como un único ZIP de archivos Markdown. Como tus archivos son la fuente de verdad (el principio file-first), la exportación los lee directamente del disco en lugar de reconstruirlos a partir de un índice: el ZIP lleva los **archivos reales**, con el `notarium-id` incluido en el frontmatter de cada uno.

Justo por eso la exportación es **reversible**: puedes devolver ese ZIP a su sitio con la [importación](/docs/import-export/import/) o llevarlo a otra instancia sin perder estructura, identidad ni fechas. En el fondo, exportar no es «sacar los datos fuera»; es una forma cómoda de empaquetar lo que ya vive en tu disco en forma de archivos.

## Cómo exportar

La exportación está en la pestaña **Export** de los ajustes de un espacio:

- El botón encola un trabajo y, a partir de ahí, tienes una barra de progreso con porcentajes (en cuanto se conoce el número de notas) y un botón **Cancel**.
- Cuando está listo, el ZIP se descarga solo; a su lado se quedan los botones **Download .zip** (volver a descargar) y **Export again** (repetir la exportación).
- Salir de la pestaña y volver es seguro: al regresar verás de nuevo el trabajo en curso, o un archivo listo para descargar.

Puedes exportar una **sola carpeta** desde el menú contextual del árbol: la opción **Export folder**. Es el mismo trabajo acotado a un subárbol; el progreso aparece en un toast «persistente» con un botón para cancelar.

## Opciones

Ambas vías de exportación aceptan el mismo conjunto de parámetros:

| Parámetro | Valores | Qué hace |
|---|---|---|
| `scope` | `user` (por defecto) · `all` | `user`: solo tus notas; `all`: todo lo que contiene el espacio, incluido el montaje de memoria del agente (`.notarium/memory`). |
| `frontmatter` | `keep` (por defecto) · `strip` | `keep` escribe el archivo tal cual; `strip` elimina el bloque YAML: una copia limpia para leer. |
| `folder` | ruta | Acota la exportación a un subárbol (lo que hace **Export folder**). |

> [!warning] `frontmatter=strip` rompe la reimportación
> Eliminar el frontmatter produce una copia con pérdidas: junto con el bloque YAML se van el `notarium-id` y las etiquetas. Un ZIP así resulta cómodo para pasarle las notas a alguien que solo va a leerlas, pero ya no podrás volver a importarlo sin pérdidas. Para mover datos, quédate con `keep` (el valor por defecto).

> [!important] La exportación no es una copia de seguridad de la instancia
> Incluso con `scope=all`, el ZIP de una exportación no lleva más que los archivos Markdown del espacio. No incluye la base de datos de metadatos: ni cuentas, ni permisos de acceso, ni historial de versiones, ni el estado de los trabajos. A partir de él no se puede restaurar una instancia. Las copias de seguridad son una operación aparte, que se hace con un comando integrado en la imagen; consulta [Copia de seguridad y restauración](/docs/self-hosting/backup/).

## Cómo funciona por dentro

La exportación está pensada para ir en streaming, de modo que una base de conocimiento, por grande que sea, nunca se acumule en memoria:

- **Trabajo asíncrono por defecto.** Cuando el host tiene una base de datos de metadatos (lo normal en autoalojamiento), la exportación es un trabajo durable: un worker en segundo plano ensambla el ZIP en el almacenamiento de artefactos y sirve el archivo terminado con soporte de descarga reanudable. Una pestaña cerrada, una conexión perdida o un reinicio del servidor no interrumpen la exportación.
- **La descarga no pasa por un búfer.** El navegador transmite el ZIP terminado directamente al disco y toma el nombre de la cabecera de la respuesta: una base de conocimiento grande no se acumula en la memoria de la pestaña.
- **Cancelar detiene el procesamiento.** Una descarga cancelada deja de extraer notas: el servidor no se queda leyendo toda la base de conocimiento en balde.

```mermaid
flowchart LR
  notes[(Notas Markdown)] -->|leer del disco| worker[Worker en segundo plano]
  worker -->|ZIP| artifact[Artefacto del trabajo]
  artifact -->|descargar| user([Navegador])
```

> [!note] Exportación sin base de datos de metadatos
> En un host sin base de datos de metadatos (solo falta en el modo `AUTH_MODE=none`) no hay capa de trabajos: la exportación va por la vía síncrona en streaming, y el mismo ZIP se sirve como descarga directa dentro de una sola petición, sin progreso ni descarga reanudable. Solo cambia la forma de entrega; el resultado es el mismo.

## Límites

- **Un espacio cada vez.** Los espacios son almacenes aislados, cada uno con su propio control de acceso; para exportar varios, exporta cada uno por separado.
- **El artefacto tiene un TTL.** El ZIP terminado se conserva un tiempo limitado (7 días por defecto) y el recolector de basura lo elimina; puedes volver a descargarlo mientras no caduque.
- **Los adjuntos binarios no se exportan.** El ZIP lleva el texto de las notas: archivos Markdown.
- **Cancelar, pero no pausar.** Un trabajo se puede cancelar; pausarlo y reanudarlo, no.

## Siguiente

- [Importación](/docs/import-export/import/): recupera un ZIP exportado o traslada una base de conocimiento a otra instancia.
- [Resumen de la sección](/docs/import-export/): por qué file-first abarata la importación y la exportación.