Zum Hauptinhalt springen
Zurück zu den Praxisnotizen
Datenmigration•8 Min. Lesezeit

WizNote verlustfrei nach Obsidian migrieren: WikiLinks neu aufbauen und Anhänge retten

Notizen aus mühsamen Einzel-Exporten und kaputten Links befreien. Wie Shadow Shift komplette WizNote-Archive im Batch exportiert, WikiLinks in zwei Durchgängen neu aufbaut und Medienanhänge für Obsidian repariert.

#WizNote zu Obsidian#Batch-Markdown-Export#WikiLinks-Reparatur#Anhang-Rettung#Vault-Migration#Local-First-CLI

Was passiert, wenn ein Jahrzehnt digitalen Kapitals in einem Silo eingeschlossen ist?

WizNote war für technische Fachleute eine geliebte Notizplattform; über 5, 8 oder 10 Jahre sammelten sie dort Tausende Artikel an.

Mit dem Aufstieg lokaler, bidirektionaler Link-Graph-Ökosysteme wie Obsidian verlangen Builder zunehmend vollständige Datensouveränität:

  • Kein Vendor-Lock-in: Freiheit von willkürlichen Preisänderungen, eingestellten Sync-APIs oder Service-Abschaltungen;
  • Volle Dateisystem-Hoheit: Jedes Dokument ist reines Klartext-.md mit nativen lokalen Assets, leicht zu sichern oder per Git zu synchronisieren;
  • Hochdimensionale Wissensgraphen: Verknüpfte Ideen, dynamisch verbunden über native WikiLinks [[Note Title]].

Doch dieser Wechsel war historisch eine brutale Wand manueller Reibung.

Der Albtraum des Standardexports: mühsames manuelles Einzelspeichern

Der Versuch, mit dem offiziellen WizNote-Client zu migrieren, stößt sofort auf Hindernisse:

  1. Kein echter Batch-Export, nur manuelles Einzelspeichern: Die offizielle Desktop-Oberfläche bietet keinen echten Batch-Exporter für eigene Verzeichnisbäume. Power-User mit 3.000 bis 10.000+ Notizen stehen vor der düsteren Aussicht, Datei für Datei per Rechtsklick zu speichern – eine seelenzehrende Handarbeit über Wochen;
  2. Fehlende Dokumente und unvollständige Archive: Manuelle Exporte übersehen regelmäßig Unterordner oder frieren bei großen Ordnern ein;
  3. Format-Lock-in: Viele Notizformate (Web-Clips, Rich-Drafts) lassen sich über GUI-Dialoge nicht als Standard-Markdown speichern;
  4. Kaputte Querverweise: Interne Links zerfallen zu toten proprietären wiz://-GUID-Protokollen;
  5. Verschwindende Medien-Assets: Eingebettete Screenshots, Diagramme und PDF-Anhänge brechen aufgrund proprietärer Kompressionsstrukturen.

Die Lösung: die automatisierte verlustfreie Batch-Pipeline von Shadow Shift

Um persönliche Wissensspeicher ohne Handarbeit zu befreien, haben wir Shadow Shift geschaffen, ein quelloffenes CLI-Werkzeug. Sein zentraler Durchbruch ist die automatisierte Batch-Verarbeitung des gesamten Vaults:

1. Automatisierter vollständiger Batch-Export (zentraler Durchbruch)

Unter Umgehung der UI-Grenzen des Clients greift Shadow Shift direkt auf lokale WizNote-SQLite-Datenbanken und Container-Dateien zu:

  • Batch-Verarbeitung mit einem Befehl: Extrahiert und konvertiert Tausende Notizen gleichzeitig in Minuten;
  • Universelle Formatextraktion: Außer Notizen, die ausdrücklich mit nutzerdefinierten Passwörtern gesperrt sind (aus Sicherheitsgründen müssen diese zuerst in WizNote regulär entschlüsselt werden), werden praktisch alle anderen Notizen – Rich Text, Markdown, Mindmaps und Web-Clips – vollständig verlustfrei geparst und extrahiert.

2. Unveränderliche Nur-Lese-Garantie

Shadow Shift greift strikt im Nur-Lese-Modus auf lokale WizNote-Datenbanken zu. Es verändert, aktualisiert oder löscht keine Quelldaten. Alle Konvertierungen werden sauber in einen isolierten Zielordner (wiznote_obsidian/) ausgegeben.

3. WikiLinks-Rekonstruktion in zwei Durchgängen

  • Erster Durchgang (Indizierung der Graphen-Topologie): Scannt alle Dokument-GUIDs, kanonischen Titel und relativen Pfade im Speicher, um eine vollständige Referenzkarte aufzubauen.
  • Zweiter Durchgang (Link-Umschreibung): Schreibt veraltete interne Tags und relative Verweise in standardisierte Obsidian-WikiLinks [[Document Title]] um.

4. Medien-Rettung und die „5+2“-Pipeline

Shadow Shift standardisiert die Vault-Hygiene über eine deterministische Pipeline:

  • Standardmodus mit 5 Schritten: Syntaxprüfung → Normalisierung von Formatierung und Abständen → WikiLinks-Konvertierung → Reparatur relativer Bildpfade → Migrationsprüfbericht;
  • Umfassender Modus mit 7 Schritten (`--all`): Erweitert die Pipeline um zentrale Zusammenführung der Anhänge und intelligente Neuverknüpfung der Assets in einen eigenen Ordner attachments/ – garantiert ohne Medienverlust.

Schnellstart

bash
# 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!

Echte Datensouveränität erleben

Ein einziger Befehl bringt Zehntausende komplexe Notizen und Assets in Minuten in Einklang.

Öffne deinen neuen Obsidian-Vault, drücke Cmd + G und sieh zu, wie ein Jahrzehnt Ideen als Sternbild verbundener Knoten aufleuchtet – das ist das ultimative Gefühl digitaler Befreiung. Erkunde den Code auf GitHub!

Weitere Praxisnotizen

Alle Praxisnotizen →