u/Disastrous-Ad5518

snorg -- a Go tool that converts Supernote notes into plaintext/SVG, VCS-friendly

snorg -- a Go tool that converts Supernote notes into plaintext/SVG, VCS-friendly

Hey,

This week I got snorg (SuperNoteORGanizer) stable enough to share.

The problem it solves: Supernote's .note files are a binary format -- you can't sensibly keep them in a VCS (git diffs the whole file on every change), can't search them, and can't feed them to an LLM for analysis.

What snorg does:

  • Ingests .note files (via supernote-tool) into a flat, machine-readable archive
  • Renders pages to SVG and metadata to JSON -- so git only registers actual changes to a note, not a rewritten binary blob
  • Has an optional AI pass (analyze) that transcribes pages through a vision LLM, skipping unchanged pages (content-addressable, so you're not re-paying to re-analyze pages that haven't changed)
  • Exports through configurable templates (e.g. to Markdown/org-mode via pandoc)

I also included snorg.el (under examples/emacs/) -- an Emacs/denote integration that creates one org-note per notebook page with links between notes, and lets me open a note's page as SVG side-by-side with my org-note plus an optional AI analysis. That's just one example use case, not fully polished, but the archive format (the JSON structure) has stabilized enough that I wanted to share it and get feedback.

github.com
u/Disastrous-Ad5518 — 18 hours ago