Skip to main content
Back to Field Notes
Data Migration•7 min read

Migrating WizNote to Obsidian Without Loss: Rebuilding WikiLinks and Recovering Attachments

Liberating locked notes from tedious single-note exports and broken links. How Shadow Shift batch-exports full WizNote archives and reconstructs WikiLinks into pristine Obsidian Markdown.

#WizNote to Obsidian#Batch Markdown Export#WikiLinks Repair#Attachment Recovery#Vault Migration

What Happens When a Decade of Digital Capital Is Locked in a Silo?

WizNote served as a beloved note-taking platform for technical professionals who accumulated thousands of articles over 5, 8, or 10 years.

With the rise of local-first, bidirectional link graph ecosystems like Obsidian, builders increasingly demand total data sovereignty:

  • Zero dependency on proprietary cloud lock-in;
  • Plaintext longevity (notes stored as standard filesystem .md files);
  • Interlinked knowledge graphs powered by native WikiLinks [[Topic]].

Yet executing that leap has historically proved excruciating.

The Default Export Nightmare: Agonizing Manual Single-Note Saves

Attempting to migrate using WizNote's default client presents immediate roadblocks:

  1. No Real Batch Export, Only Manual Single-Note Clicks: The official client lacks an automated full-vault batch exporter. Many notes can only be exported one-by-one by right-clicking. For power users with 3,000 to 10,000+ notes, manual single-note export is an agonizing nightmare requiring weeks of repetitive work;
  2. Missing Notes and Incomplete Archives: Manual export is error-prone, frequently dropping articles or crashing midway;
  3. Format Lock-In: Many note categories cannot be exported at all via the standard interface;
  4. Broken Internal Links: Inter-note references collapse into dead proprietary GUID protocols;
  5. Missing Media & Attachments: Embedded screenshots and PDFs fail to extract cleanly, resulting in missing images.

The Solution: Shadow Shift's Automated Batch Lossless Pipeline

To liberate personal knowledge vaults without manual toil, we created Shadow Shift, an open-source CLI utility. Its primary breakthrough is automated full-vault batch processing:

1. Automated Full-Vault Batch Export (Core Breakthrough)

Bypassing client-side UI limitations, Shadow Shift interfaces directly with local WizNote SQLite databases and container files:

  • One-Command Batch Processing: Recursively extracts and converts thousands of notes simultaneously in minutes;
  • Universal Format Extraction: Except for notes specifically locked with user-defined passwords (which require standard decryption inside WizNote first for security reasons), virtually all other notes—rich text, Markdown, mind maps, and web clips—are fully parsed and extracted without loss.

2. Zero-Mutation Read-Only Invariance

Shadow Shift accesses local WizNote databases in strict read-only mode. It never modifies, updates, or deletes source data. All conversions output cleanly into an isolated target folder.

3. Two-Pass WikiLinks Reconstruction

  • Pass One: Builds an in-memory graph index resolving internal GUID identifiers to canonical note titles.
  • Pass Two: Rewrites deprecated internal tags into standard Obsidian [[Document Title]] WikiLinks.

4. Media Asset Recovery and Path Sanitization

Recursively extracts embedded binaries into a unified attachments/ directory, re-linking Markdown references to maintain zero media loss.

Experiencing Real Data Sovereignty

Running a single command reconciles tens of thousands of complex notes and assets in minutes.

Opening your new Obsidian vault and striking Cmd + G to watch a decade of ideas illuminate a constellation of connected nodes is the ultimate feeling of digital liberation.

More Field Notes

All Field Notes →