Migrando do WizNote para o Obsidian sem perdas: reconstruindo WikiLinks e recuperando anexos

O que acontece quando uma década de capital digital fica presa em um silo?

O WizNote foi uma plataforma de notas querida por profissionais técnicos que acumularam milhares de artigos ao longo de 5, 8 ou 10 anos.

Com a ascensão de ecossistemas local-first com grafos de links bidirecionais como o Obsidian, criadores passaram a exigir soberania total sobre os dados:

• Zero aprisionamento a fornecedor: liberdade diante de mudanças arbitrárias de preço, APIs de sincronização descontinuadas ou encerramento do serviço;
• Propriedade total do sistema de arquivos: cada documento é .md puro em texto simples, acompanhado de anexos locais nativos, fácil de fazer backup ou sincronizar com Git;
• Grafos de conhecimento multidimensionais: ideias interligadas conectadas dinamicamente por WikiLinks nativos [[Note Title]].

Mas executar essa transição sempre significou encarar uma muralha brutal de atrito manual.

O pesadelo da exportação padrão: salvamentos manuais nota a nota

Tentar migrar com o cliente oficial do WizNote esbarra em bloqueios imediatos:

1. Sem exportação em lote de verdade, só salvamento manual nota a nota: a interface oficial para desktop não tem um exportador em lote real para árvores de diretórios personalizadas. Usuários com 3.000 a 10.000+ notas encaram a perspectiva sombria de clicar com o botão direito e salvar arquivo por arquivo — uma tarefa manual de semanas;
2. Documentos faltando e arquivos incompletos: exportações manuais costumam perder subpastas ou travam em pastas grandes;
3. Aprisionamento de formato: muitos formatos de nota (recortes web, rascunhos ricos) não podem ser salvos como Markdown padrão por diálogos gráficos;
4. Referências entre notas quebradas: links internos colapsam em protocolos proprietários mortos wiz:// com GUID;
5. Desaparecimento de mídia: capturas incorporadas, diagramas e anexos em PDF se quebram por estruturas de compressão proprietárias.

A solução: o pipeline em lote sem perdas do Shadow Shift

Para libertar cofres de conhecimento pessoal sem trabalho manual, criamos o Shadow Shift, um utilitário CLI open source. Seu avanço principal é o processamento automatizado de todo o cofre em lote:

1. Exportação em lote do cofre inteiro (avanço central)

Contornando as limitações da interface do cliente, o Shadow Shift acessa diretamente os bancos SQLite e arquivos de contêiner locais do WizNote:

• Processamento em lote com um comando: extrai e converte milhares de notas recursivamente ao mesmo tempo, em minutos;
• Extração universal de formatos: exceto notas especificamente protegidas por senha definida pelo usuário (que precisam ser descriptografadas dentro do WizNote primeiro, por segurança), praticamente todas as outras notas — texto rico, Markdown, mapas mentais e recortes web — são totalmente interpretadas e extraídas sem perdas.

2. Invariância somente leitura sem mutação

O Shadow Shift acessa os bancos locais do WizNote em modo estritamente somente leitura. Nunca modifica, atualiza ou exclui os dados de origem. Todas as conversões são gravadas em uma pasta de destino isolada (wiznote_obsidian/).

3. Reconstrução de WikiLinks em duas passagens

• Primeira passagem (indexação da topologia do grafo): varre todos os GUIDs de documentos, títulos canônicos e caminhos relativos na memória para construir um mapa de referências abrangente.
• Segunda passagem (reescrita de links): reescreve tags internas obsoletas e referências relativas como WikiLinks padrão do Obsidian [[Document Title]].

4. Recuperação de mídia e pipeline "5+2"

O Shadow Shift padroniza a higiene do cofre com um pipeline determinístico:

• Modo padrão de 5 etapas: verificação de sintaxe → normalização de formatação e espaçamento → conversão de WikiLinks → correção de caminhos relativos de imagem → relatório de auditoria da migração;
• Modo abrangente de 7 etapas (`--all`): estende o pipeline com consolidação centralizada de anexos e religação inteligente de mídia em uma pasta dedicada attachments/, garantindo zero perda de mídia.

Guia de início 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!

Experimentando soberania real sobre os dados

Rodar um único comando reconcilia dezenas de milhares de notas e anexos complexos em minutos.

Abrir seu novo cofre no Obsidian e apertar Cmd + G para ver uma década de ideias iluminar uma constelação de nós conectados é a sensação definitiva de libertação digital. Explore o código no GitHub!