---
title: "Export"
description: "Téléchargez un espace ou un dossier sous la forme d'une seule archive ZIP de fichiers Markdown — structure et identité préservées, rien de perdu."
---

# Export

L'export télécharge un espace entier, ou un dossier précis, sous la forme d'une seule archive ZIP de fichiers Markdown. Comme vos fichiers sont la source de vérité (le principe file-first), l'export les lit directement sur le disque au lieu de les reconstruire depuis un index : l'archive emporte les **fichiers réels**, avec le `notarium-id` dans le frontmatter de chacun.

C'est précisément pour cela que l'export est **réversible** — vous pouvez le réintégrer par un [import](/docs/import-export/import/), ou le déplacer vers une autre instance sans rien perdre de la structure, de l'identité ni des dates. L'export ne consiste pas vraiment à « faire sortir des données » ; c'est une façon commode d'empaqueter ce qui vit déjà sur le disque sous la forme de vos fichiers.

## Comment exporter

L'export se trouve dans l'onglet **Export** des paramètres d'un espace :

- Le bouton met une tâche en file d'attente ; s'affichent ensuite une barre de progression en pourcentage (dès que le nombre de notes est connu) et un bouton **Cancel**.
- Une fois prête, l'archive se télécharge automatiquement ; les boutons **Download .zip** (télécharger à nouveau) et **Export again** (relancer l'export) restent à côté.
- Quitter l'onglet puis y revenir est sans risque : à votre retour, vous retrouverez la tâche en cours, ou un fichier prêt à télécharger.

Vous pouvez exporter **un dossier précis** depuis le menu contextuel de l'arborescence — l'entrée **Export folder**. C'est la même tâche, restreinte à un sous-arbre ; la progression apparaît dans un toast persistant doté d'un bouton d'annulation.

## Options

Les deux voies d'export acceptent le même jeu de paramètres :

| Paramètre | Valeurs | Ce qu'il fait |
|---|---|---|
| `scope` | `user` (par défaut) · `all` | `user` — vos notes uniquement ; `all` — tout ce que contient l'espace, y compris le point de montage de la mémoire de l'agent (`.notarium/memory`). |
| `frontmatter` | `keep` (par défaut) · `strip` | `keep` écrit le fichier tel quel ; `strip` retranche le bloc YAML — une copie propre, faite pour la lecture. |
| `folder` | chemin | Restreindre l'export à un sous-arbre (ce que fait **Export folder**). |

> [!warning] `frontmatter=strip` casse la réimportation
> Retrancher le frontmatter produit une copie avec pertes : avec le bloc YAML disparaissent aussi le `notarium-id` et les tags. Une telle archive est commode pour transmettre des notes à lire, mais vous ne pourrez plus la réimporter sans perte. Pour déplacer des données, restez sur `keep` (la valeur par défaut).

> [!important] L'export n'est pas une sauvegarde de l'instance
> Même avec `scope=all`, une archive d'export ne contient rien d'autre que les fichiers Markdown de l'espace. Aucune base de métadonnées : ni comptes, ni droits d'accès, ni historique des versions, ni état des tâches. Impossible de restaurer une instance à partir d'une telle archive. La sauvegarde est une opération distincte, lancée par une commande intégrée à l'image — voir [Sauvegarde et restauration](/docs/self-hosting/backup/).

## Sous le capot

L'export est conçu pour fonctionner en flux, afin qu'une base de connaissances de taille arbitraire ne reste jamais en mémoire :

- **Tâche asynchrone par défaut.** Quand l'hôte dispose d'une base de métadonnées (la norme en auto-hébergement), l'export est une tâche durable : un worker en arrière-plan assemble le ZIP dans le stockage d'artefacts et sert le fichier fini avec prise en charge de la reprise du téléchargement. Un onglet fermé, une connexion coupée ou un redémarrage du serveur ne font pas dérailler l'export.
- **Le téléchargement n'est pas mis en mémoire tampon.** Le navigateur écrit l'archive finie en flux, directement sur le disque, en tirant son nom de l'en-tête de réponse — une grande base de connaissances ne reste pas en mémoire dans l'onglet.
- **L'annulation arrête le travail.** Un téléchargement annulé cesse d'extraire des notes — le serveur ne continue pas à lire toute la base de connaissances pour rien.

```mermaid
flowchart LR
  notes[(Notes Markdown)] -->|lecture disque| worker[Worker en arrière-plan]
  worker -->|ZIP| artifact[Artefact de tâche]
  artifact -->|téléchargement| user([Navigateur])
```

> [!note] Export sans base de métadonnées
> Sur un hôte sans base de métadonnées (elle n'est absente qu'en mode `AUTH_MODE=none`), il n'y a pas de couche de tâches : l'export emprunte la voie synchrone en flux — le même ZIP est servi en téléchargement direct dans une seule requête, sans progression ni reprise du téléchargement. Seul le mode de livraison change ; le résultat est le même.

## Limites

- **Un espace à la fois.** Les espaces sont des dépôts isolés, dotés de leur propre contrôle d'accès ; pour en exporter plusieurs, exportez chacun séparément.
- **L'artefact a un TTL.** Le ZIP fini est conservé pendant une durée limitée (7 jours par défaut) puis supprimé par le nettoyage automatique (garbage collector) ; vous pouvez le retélécharger tant qu'il n'a pas expiré.
- **Les pièces jointes binaires ne sont pas exportées.** L'archive emporte le texte des notes — des fichiers Markdown.
- **Annuler, mais pas suspendre.** Une tâche peut être annulée ; il n'y a ni pause ni reprise.

## Et ensuite

- [Import](/docs/import-export/import/) — réintégrer une archive, ou déplacer une base de connaissances vers une autre instance.
- [Vue d'ensemble de la section](/docs/import-export/) — pourquoi le file-first rend l'import et l'export peu coûteux.