Migrer WizNote vers Obsidian sans perte : reconstruire les WikiLinks et récupérer les pièces jointes

Que se passe-t-il quand une décennie de capital numérique est enfermée dans un silo ?

WizNote a été une plateforme de prise de notes appréciée des professionnels techniques, qui y ont accumulé des milliers de notes sur 5, 8 ou 10 ans.

Avec l'essor des écosystèmes de graphes de liens bidirectionnels et locaux d'abord comme Obsidian, les créateurs réclament de plus en plus une souveraineté totale sur leurs données :

• Zéro dépendance à un fournisseur : plus de hausses de prix arbitraires, d'API de synchronisation abandonnées ou d'arrêts de service ;
• Propriété totale du système de fichiers : chaque document est un fichier .md en texte brut, accompagné de ressources locales natives, facile à sauvegarder ou à synchroniser avec Git ;
• Graphes de connaissances riches : des idées reliées dynamiquement par des WikiLinks natifs [[Note Title]].

Pourtant, opérer cette transition a longtemps dressé un mur de frictions manuelles.

Le cauchemar de l'export par défaut : des sauvegardes manuelles une par une

Tenter de migrer avec le client officiel de WizNote se heurte immédiatement à des obstacles :

1. Aucun véritable export par lot, seulement des sauvegardes manuelles note par note : l'interface officielle de bureau n'offre pas d'exportateur par lot pour des arborescences personnalisées. Les utilisateurs avancés qui ont de 3 000 à plus de 10 000 notes doivent cliquer droit et enregistrer les fichiers un par un — une corvée manuelle épuisante qui s'étale sur des semaines ;
2. Documents manquants et archives incomplètes : les exports manuels oublient régulièrement des sous-dossiers ou se bloquent sur les dossiers volumineux ;
3. Enfermement de format : de nombreux formats de notes (clips web, brouillons enrichis) ne peuvent pas être enregistrés en markdown standard via les boîtes de dialogue ;
4. Références internes brisées : les liens internes se réduisent à des protocoles GUID propriétaires wiz:// morts ;
5. Disparition des ressources média : les captures, schémas et pièces jointes PDF intégrés se corrompent à cause de structures de compression propriétaires.

La solution : le pipeline par lots sans perte de Shadow Shift

Pour libérer les coffres de connaissances personnels sans labeur manuel, nous avons créé Shadow Shift, un utilitaire CLI open source. Sa percée principale : le traitement par lots automatisé de tout le coffre :

1. Export par lots automatisé de tout le coffre (percée centrale)

Contournant les limites de l'interface client, Shadow Shift communique directement avec les bases SQLite et les fichiers conteneurs locaux de WizNote :

• Traitement par lots en une commande : extrait et convertit récursivement des milliers de notes en quelques minutes ;
• Extraction universelle des formats : à l'exception des notes verrouillées par un mot de passe défini par l'utilisateur (qui doivent d'abord être déchiffrées dans WizNote pour des raisons de sécurité), la quasi-totalité des autres notes — texte enrichi, Markdown, cartes mentales et clips web — est entièrement analysée et extraite sans perte.

2. Invariance en lecture seule, sans aucune modification

Shadow Shift accède aux bases WizNote locales en mode lecture seule strict. Il ne modifie, ne met à jour et ne supprime jamais les données sources. Toutes les conversions sont écrites dans un dossier cible isolé (wiznote_obsidian/).

3. Reconstruction des WikiLinks en deux passes

• Première passe (indexation de la topologie du graphe) : parcourt en mémoire tous les GUID de documents, les titres canoniques et les chemins relatifs pour construire une carte de références complète.
• Seconde passe (réécriture des liens) : réécrit les balises internes obsolètes et les références relatives en WikiLinks Obsidian standard [[Document Title]].

4. Récupération des ressources média et pipeline « 5+2 »

Shadow Shift normalise l'hygiène du coffre grâce à un pipeline déterministe :

• Mode standard en 5 étapes : vérification de la syntaxe → normalisation du formatage et des espacements → conversion des WikiLinks → réparation des chemins d'images relatifs → rapport d'audit de migration ;
• Mode complet en 7 étapes (`--all`) : étend le pipeline avec la centralisation des pièces jointes et la re-liaison intelligente des ressources dans un dossier dédié attachments/, garantissant zéro perte média.

Démarrage rapide

# 1. Clone repository and install dependencies
git clone https://github.com/WardLu/shadow-shift.git
cd shadow-shift
pip3 install -r requirements.txt

# 2. Download and extract local database
python3 tools/wiznote_downloader.py

# 3. Format and rebuild links (all 7 steps)
python3 tools/obsidian_formatter.py --all

# 4. Open the generated wiznote_obsidian folder in Obsidian!

Vivre une véritable souveraineté des données

Une seule commande réconcilie des dizaines de milliers de notes et de ressources complexes en quelques minutes.

Ouvrir votre nouveau coffre Obsidian et appuyer sur Cmd + G pour voir une décennie d'idées s'illuminer en constellation de nœuds connectés procure le sentiment ultime de libération numérique. Découvrez le code sur GitHub !