Migration de Notion vers Obsidian : Liste de contrôle Importation API vs HTML

La méthode la plus sûre pour passer de Notion à Obsidian dépend du contenu de votre espace de travail. Utilisez l’importation officielle via l’API Notion lorsque les bases de données et les formules sont primordiales. Utilisez l’importation de fichiers HTML Notion lorsque vous souhaitez une migration hors ligne, sans jeton d’accès, et que vous pouvez reconstruire vous-même les vues de bases de données.

Ne traitez pas la migration comme un simple exercice de copie de fichiers. Décidez d’abord quels flux de travail doivent survivre : notes liées, dossiers de projets, planification quotidienne, tâches récurrentes, réunions ou vues de bases de données. Importez ensuite dans un coffre-fort (vault) de test, vérifiez les workflows importants et conservez Notion à disposition jusqu’à ce que le nouveau coffre valide la liste de contrôle située à la fin de ce guide.

Décision rapide : Importation API ou HTML ?

Votre situation	Choisissez	Ce qu’elle préserve	Principal compromis
Les bases de données, propriétés et formules sont centrales	Notion (API)	Pages, entrées de bases de données, propriétés et formules converties en Markdown et Bases	Nécessite un jeton d’intégration Notion, l’accès aux pages et une connexion Internet
Vous souhaitez un processus sans jeton ou hors ligne	Notion (.zip)	Pages, pièces jointes, hiérarchie et liens issus d’une exportation HTML	Les vues et structures de bases de données ne sont pas transférées sous forme de Bases dynamiques
Vous n’avez besoin que d’un petit ensemble de notes	Importation API avec accès limité à ces pages, ou exportation HTML au niveau de la page	Les notes sélectionnées et leurs pièces jointes disponibles	Les liens vers du contenu extérieur au périmètre sélectionné nécessitent une révision
Vous avez besoin de collaboration en temps réel et de permissions	Conservez ce workflow dans Notion ou associez Obsidian à un outil d’équipe	Le contexte de connaissances peut toujours être déplacé vers Obsidian	Obsidian ne remplace pas directement les espaces de travail partagés de Notion

Ce tableau reflète la documentation actuelle de l’Importateur Obsidian. L’importateur API y est décrit comme récent ; examinez donc ses limites avant une grande migration. En particulier, seule la vue principale de chaque base de données est importée, les sources de données liées ne sont pas importées et certaines fonctions Notion ne sont pas converties.

Avant de migrer

Créez un court inventaire. Marquez chaque élément comme à préserver absolument, à reconstruire ou à abandonner.

• Les notes et pages imbriquées que vous utilisez encore.
• Les liens internes, rétroliens (backlinks) et pièces jointes importantes.
• Les bases de données, propriétés, relations, rollups, formules et vues.
• Les notes quotidiennes, tâches récurrentes, statuts de projets et suivis de réunions.
• Les pages partagées, commentaires, permissions, automatisations et intégrations.
• Le chemin de sauvegarde et de synchronisation pour le nouveau coffre local.

Utilisez cet inventaire pour choisir la voie d’importation. Un grand espace de travail riche en bases de données nécessite un plan différent de celui d’un simple dossier de notes de réunion. Si vous souhaitez une comparaison plus large avant de sauter le pas, lisez Obsidian vs Notion pour la productivité.

Créer un environnement de test sécurisé

1. Conservez l’espace de travail Notion d’origine intact.
2. Créez un nouveau coffre-fort Obsidian de test, vide.
3. Exportez ou importez d’abord un échantillon représentatif : une page ordinaire, une page imbriquée, une page liée, une pièce jointe et une base de données.
4. Notez ce qui est bien arrivé et ce qui doit être reconstruit.
5. Ne répétez l’opération dans le coffre final qu’une fois l’échantillon validé.

Le test n’est pas una garantie que chaque espace de travail se comportera de la même manière. Il met en lumière les éléments qui nécessitent une nouvelle structure avant que vous n’abandonniez l’ancien système.

Option 1 : Importer via l’API Notion

Utilisez cette option lorsque les bases de données et leurs propriétés sont importantes. Le plugin officiel Importer convertit les bases de données Notion en dossiers contenant un fichier .base et convertit les formules lorsqu’Obsidian propose une fonction équivalente.

Préparer l’intégration Notion

1. Ouvrez la page des intégrations Notion.
2. Créez une intégration interne pour l’espace de travail.
3. Copiez le secret d’intégration interne dans un gestionnaire de mots de passe sécurisé.
4. Accordez à l’intégration l’accès aux pages et bases de données que vous souhaitez importer.

Ne collez jamais un jeton dans un article, un historique de terminal, une issue ou une note partagée. Le jeton donne accès à l’ensemble du contenu partagé avec l’intégration.

Exécuter l’importation API

1. Ouvrez Paramètres → Plugins de la communauté dans Obsidian.
2. Installez et activez le plugin officiel Importer.
3. Ouvrez Importer depuis la palette de commandes ou son icône dans la barre latérale.
4. Sélectionnez Notion (API) comme format de fichier.
5. Collez le secret d’intégration et sélectionnez Charger (Load).
6. Choisissez les pages et bases de données à importer.
7. Examinez les options d’importation et lancez le processus.

Les espaces de travail volumineux peuvent prendre du temps car l’API Notion applique des limites de débit (rate limits). N’importez qu’après avoir accordé l’accès aux pages parentes correctes. Un ticket récent sur Importer concernant des pages manquantes montre pourquoi le périmètre d’accès et la hiérarchie des pages méritent une vérification lorsque la liste de sélection semble incomplète.

Limites de l’API à anticiper

La documentation officielle identifie ces limitations :

• Seule la vue principale de chaque base de données est importée.
• Les sources de données liées ne sont pas importées.
• Les fonctions People telles que name() et email() ne sont pas converties.
• Les fonctions Text telles que style() et unstyle() ne sont pas converties.
• Les formules ne disposant pas d’équivalent dans Obsidian nécessitent une révision manuelle.

Considérez le fichier .base importé comme une vue de départ, et non comme la preuve que chaque vue Notion a été conservée. Vérifiez les relations, les formules, les filtres et les enregistrements dont dépend votre travail quotidien.

Option 2 : Importer une exportation HTML Notion

Utilisez l’importation de fichiers lorsque vous souhaitez éviter l’utilisation de jetons ou lorsque votre espace de travail est principalement composé de pages et de pièces jointes. Obsidian recommande une exportation HTML pour cette méthode, car l’exportation Markdown de Notion omet des données importantes.

Exporter depuis Notion

1. Ouvrez Paramètres → Espace de travail → Général dans Notion.
2. Sélectionnez Exporter tout le contenu de l’espace de travail.
3. Choisissez HTML comme format d’exportation.
4. Sélectionnez Tout inclure.
5. Activez Créer des dossiers pour les sous-pages.
6. Demandez ou téléchargez l’archive d’exportation .zip.

La documentation d’exportation de Notion confirme que les exportations peuvent inclure des fichiers HTML, Markdown, CSV et des éléments médias. Elle précise également que les vues de bases de données et certains contenus ne s’exportent pas sous la forme d’un espace de travail entièrement récréable.

Importer le fichier .zip

1. Ouvrez le plugin officiel Importer dans Obsidian.
2. Sélectionnez Notion (.zip).
3. Choisissez le fichier exporté.
4. Sélectionnez un dossier de destination.
5. Activez Enregistrer les pages parentes dans des sous-dossiers si vous souhaitez conserver la hiérarchie.
6. Importez l’intégralité de l’archive si les liens internes à l’espace de travail sont essentiels.

Cette voie transfère vos pages et médias dans un coffre-fort Markdown local, mais elle ne conserve pas les bases de données Notion sous forme de vues de bases de données dynamiques. N’installez pas une grande quantité de plugins avant de savoir quels flux de travail nécessitent d’être reconfigurés.

Reconstruire uniquement les flux de travail utiles

Une archive importée n’est pas encore un système opérationnel. Commencez par le remplacement le plus simple pour chaque workflow actif.

Workflow Notion	Point de départ dans Obsidian	À vérifier avant de fermer Notion
Documents et pages de référence	Notes Markdown, dossiers, recherche et liens internes	Ouvrez cinq pages importantes et suivez leurs liens
Base de données de projets ou tâches	Bases importées par API, ou propriétés avec vue filtrée	Filtrez par statut, date d’échéance et sur un projet réel
Planification quotidienne	Notes quotidiennes intégrées plus un modèle	Créez la note d’aujourd’hui et validez le modèle et le dossier
Travail récurrent	Plugin Tasks ou simple convention de note récurrente	Créez, interrogez et terminez une tâche récurrente
Réunions et contacts	Notes de réunion liées aux projets et personnes	Retrouvez une action depuis son contexte de réunion et de projet
Approbations et commentaires partagés	Conservez la collaboration dans Notion ou un autre outil	Confirmez qui a encore besoin d’accès et de notifications

Pour un système local prêt à l’emploi, la gestion des tâches d’Obsibrain, la planification quotidienne, les Smart Projects et les revues périodiques couvrent les étapes de migration qui nécessitent généralement plus qu’un simple dossier de fichiers Markdown.

Si vous préférez construire votre système vous-même, commencez par la méthode PARA dans Obsidian ou une configuration de second cerveau. N’ajoutez une vue de base de données ou un plugin communautaire que lorsqu’un besoin réel reste sans réponse.

Liste de contrôle de validation de la migration

Effectuez ces vérifications avant de passer Notion en lecture seule ou de résilier votre abonnement payant.

Contenu et liens

• Chaque page essentielle existe dans le nouveau coffre-fort.
• Les pages imbriquées se trouvent dans la structure de dossiers ou de liens prévue.
• Les liens internes importants ouvrent les notes souhaitées.
• Les images, PDF et autres pièces jointes s’ouvrent localement.
• La recherche retrouve les pages et propriétés que vous utilisez chaque semaine.

Données et vues

• Les lignes de bases de données utiles au travail actuel sont présentes.
• Les propriétés possèdent les noms et types attendus.
• Les relations pointent vers les bonnes notes ou disposent d’une alternative documentée.
• Les formules et rollups ont un remplacement testé ou une limitation actée.
• La vue principale des projets, tâches ou contacts répond à son besoin réel.

Utilisation quotidienne et sortie

• Une nouvelle note quotidienne arrive dans le bon dossier avec le bon modèle.
• Une tâche peut passer de la capture à la finalisation sans doublon.
• Une action de réunion reste connectée à son contexte d’origine.
• Le coffre dispose d’une sauvegarde et d’un plan de synchronisation multi-appareils.
• Notion reste accessible jusqu’à la validation complète de la liste sur le travail quotidien.

Guide de dépannage

Symptôme	Premier contrôle	Action pratique
L’importation API n’affiche aucune page ni base	Accès de l’intégration et partage des pages parentes	Partagez la bonne page parente, rechargez la sélection et testez un petit périmètre
Une base de données arrive sans la vue attendue	Limites de la vue principale et des sources liées	Reconstruisez la vue manquante dans Bases, ou conservez ce workflow dans Notion
Une formule ne se comporte pas de la même manière	Si Obsidian possède une fonction équivalente	Conservez le résultat sous forme de propriété et documentez la formule initiale
L’importation HTML présente un formatage altéré	Format d’exportation et chemins des pièces jointes	Utilisez l’HTML, gardez l’exportation intacte et réparez les notes prioritaires en premier
Le coffre semble encombré après l’importation	Si la migration a copié une archive plutôt qu’un workflow	Archivez les anciens éléments et structurez autour des notes réutilisées

Le suivi des tickets de l’Importateur Obsidian est le meilleur endroit pour vérifier les cas particuliers actuels.

Recommandation finale

Choisissez l’importation API pour un espace de travail riche en bases de données. Choisissez l’importation HTML pour une migration axée sur les pages et sans jeton d’accès. Dans les deux cas, utilisez un coffre de test, conservez l’exportation d’origine et ne reconstruisez que les flux de travail qui vous sont encore utiles.

L’objectif n’est pas de reproduire chaque vue Notion à l’identique. L’objectif est d’obtenir un système local et connecté qui vous aide à capturer vos idées, gérer vos projets, planifier vos journées et suivre vos engagements. Si la configuration est le principal obstacle, appuyez-vous sur un système Obsidian clé en main ; si la collaboration est votre besoin majeur, conservez cette partie dans un outil conçu pour le travail d’équipe.

Sources et lectures complémentaires

• Obsidian : Importer depuis Notion
• Notion : Exporter votre contenu
• Suivi des issues de l’Importateur Obsidian
• Issue Importer : pages ou bases de données manquantes