Migrar WizNote a Obsidian sin pérdidas: reconstruir WikiLinks y recuperar adjuntos

¿Qué ocurre cuando una década de capital digital queda encerrada en un silo?

WizNote fue una plataforma de notas muy apreciada por profesionales técnicos que acumularon miles de artículos durante 5, 8 o 10 años.

Con el auge de ecosistemas de grafos de enlaces bidireccionales y local-first como Obsidian, cada vez más creadores exigen soberanía total sobre sus datos:

• Cero dependencia del proveedor: libertad frente a cambios de precio arbitrarios, API de sincronización retiradas o cierres del servicio;
• Propiedad total del sistema de archivos: cada documento es Markdown .md en texto plano, junto a recursos locales nativos, fácil de respaldar o sincronizar con Git;
• Grafos de conocimiento de alta dimensión: ideas interconectadas dinámicamente mediante WikiLinks nativos [[Note Title]].

Sin embargo, ejecutar esa transición ha supuesto históricamente un muro brutal de fricción manual.

La pesadilla de la exportación predeterminada: guardar notas de una en una

Intentar migrar con el cliente oficial de WizNote presenta obstáculos inmediatos:

1. Sin exportación por lotes real, solo guardado manual nota a nota: la interfaz oficial de escritorio no tiene un exportador por lotes real para árboles de carpetas personalizados. Los usuarios avanzados con entre 3.000 y más de 10.000 notas se enfrentan a la perspectiva de hacer clic derecho y guardar archivo por archivo: una tarea agotadora que dura semanas;
2. Documentos ausentes y archivos incompletos: las exportaciones manuales suelen omitir subcarpetas o se bloquean con carpetas grandes;
3. Encierro de formato: muchos formatos de nota (recortes web, borradores enriquecidos) no se pueden guardar como Markdown estándar desde los cuadros de diálogo de la interfaz;
4. Referencias internas rotas: los enlaces internos se convierten en protocolos GUID propietarios wiz:// muertos;
5. Desaparición de recursos multimedia: las capturas, los diagramas y los PDF incrustados se rompen por estructuras de compresión propietarias.

La solución: el flujo por lotes sin pérdidas de Shadow Shift

Para liberar bóvedas de conocimiento personal sin trabajo manual, creamos Shadow Shift, una utilidad CLI de código abierto. Su avance principal es el procesamiento automatizado por lotes de bóvedas completas:

1. Exportación automatizada por lotes de toda la bóveda (avance central)

Sin pasar por las limitaciones de la interfaz del cliente, Shadow Shift trabaja directamente con las bases de datos SQLite locales de WizNote y sus archivos contenedor:

• Procesamiento por lotes con un solo comando: extrae y convierte de forma recursiva miles de notas a la vez en minutos;
• Extracción universal de formatos: salvo las notas bloqueadas específicamente con contraseñas definidas por el usuario (que, por seguridad, primero deben descifrarse con el procedimiento estándar dentro de WizNote), prácticamente todas las demás notas —texto enriquecido, Markdown, mapas mentales y recortes web— se analizan y extraen sin pérdidas.

2. Invariabilidad de solo lectura con cero mutaciones

Shadow Shift accede a las bases de datos locales de WizNote en modo estrictamente de solo lectura. Nunca modifica, actualiza ni elimina los datos de origen. Todas las conversiones se escriben en una carpeta de destino aislada (wiznote_obsidian/).

3. Reconstrucción de WikiLinks en dos pasadas

• Primera pasada (indexación de la topología del grafo): escanea en memoria todos los GUID de documentos, los títulos canónicos y las rutas relativas para construir un mapa de referencias completo.
• Segunda pasada (reescritura de enlaces): reescribe las etiquetas internas obsoletas y las referencias relativas como WikiLinks estándar de Obsidian [[Document Title]].

4. Recuperación de recursos multimedia y flujo «5+2»

Shadow Shift estandariza la higiene de la bóveda mediante un flujo determinista:

• Modo estándar de 5 pasos: verificación de sintaxis → normalización de formato y espaciado → conversión de WikiLinks → reparación de rutas de imagen relativas → informe de auditoría de migración;
• Modo completo de 7 pasos (`--all`): amplía el flujo con la consolidación centralizada de adjuntos y la re-vinculación inteligente de recursos en una carpeta attachments/ dedicada, garantizando cero pérdida de contenido multimedia.

Guía de inicio rápido

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

Experimentar la verdadera soberanía de datos

Ejecutar un solo comando concilia decenas de miles de notas y recursos complejos en minutos.

Abrir tu nueva bóveda de Obsidian y pulsar Cmd + G para ver una década de ideas iluminarse como una constelación de nodos conectados es la sensación definitiva de liberación digital. Explora el código en GitHub.