Knowledge Note Bridge

Local integrity layer for Markdown + Anki

Change the note. Keep the history.

Stable card IDs, a dry-run diff, backup-first sync, and explicit archive or rename handling—so an edit never quietly becomes a new learner.

Install the CLI Try the diff
  • Notes stay local
  • No telemetry
  • Never deletes cards
Three porcelain tiles forming a bridge over a glacial fissure, joined by one unbroken cobalt line

01 / A deliberate crossing

Every write earns your consent.

Knowledge Note Bridge treats scheduling data as irreplaceable. It separates inspection from mutation and turns ambiguity into a blocked plan—not a guess.

Stamp a stable ID

Add a small card block to any Markdown file. Its ID follows the idea across wording, deck, and filename changes.

Read the dry-run strata

See exact adds, in-place updates, renames, archives, and safety blocks in human or JSON output before Anki changes.

Back up, then bridge

sync --yes asks Anki to create a collection backup, applies the plan, and writes the full before-state report.

02 / Local diff lab

Make a risky edit safely.

This parser runs entirely in your browser. Change the answer, rename the ID with renamed-from, or set archived: true, then compare.

Dry-run plan Free edition

03 / One quiet binary

Install. Inspect. Sync.

Rust, MIT-licensed, and scriptable. No daemon, cloud account, runtime analytics, or interactive prompt in CI.

cargo install --git https://github.com/B-Divyesh/sf-knowledge-note-bridge
validateknb check notes/
previewknb plan notes/ --json
applyknb sync notes/ --yes

Read the source and full format guide on GitHub

04 / Safety boundaries

It refuses to improvise.

A card that disappears from Markdown is not “obviously deleted.” It is an unresolved integrity decision, so the sync stops before backup or writes.

Updates retain note IDs

Front, back, deck, and tags change on the existing Anki note. Scheduling, ease, lapses, and the review log remain attached.

Archives suspend

An explicit archive suspends the existing cards and adds a visible tag. It never deletes; your backup and report remain the escape hatch.

Failures leave evidence

If an AnkiConnect write fails, the report records what already applied, every old value, and the backup to restore.

Steward edition

Convenience for many knowledge roots.

$19 one-time purchase

The full CLI, backups, reports, JSON export, and every safety behavior remain free. Steward unlocks browser conveniences for repeat workflows.

  • Save browser demo reports on this device
  • Keep a local reference while editing notes
  • All future Steward convenience updates
Buy Steward once

Sociobot/Dodo is the merchant of record. Refunds are handled there and revoke the license automatically. See privacy and terms.

Restore a purchase

Paste the license token from your receipt. It stays on this device and is checked at most once per day.

No license stored. The free CLI is ready to use.