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 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).

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).

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.

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.

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

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.

Importación: recupera un ZIP exportado o traslada una base de conocimiento a otra instancia.
Resumen de la sección: por qué file-first abarata la importación y la exportación.