v0.2.0

Inline images, a Markdown-aware insert mode, and a binary you can download.

New

Images render in the note. A line holding nothing but an image reference
draws the picture under it, scaled to fit your note and never more than half the
window. Paths are relative to your notes directory, or absolute, or start with
~, and nothing is fetched over the network. Needs a terminal speaking the kitty
graphics protocol, which Ghostty and kitty do; everywhere else the line stays
text and nothing else changes.

Insert mode follows the Markdown around the cursor. Enter after a heading
leaves a blank line for body text. Starting a list, ordered or unordered or a
task, leaves a blank line after preceding prose. Enter continues the marker and
indentation, and a checked task continues as an unchecked one. Tab and Shift-Tab
nest an item and its children once it has a sibling to nest under.

gx opens the Markdown link under the cursor.

The Vim register and the system clipboard move together. Yanks, deletes,
changes and substitutes update both, and p reuses that register. Cmd+C copies
a visual selection where the terminal forwards Command keys.

A downloadable binary. Releases now carry macOS and Linux on arm64 and
amd64, and Windows on amd64, with checksums.

Fixed

• Wrapped lines keep their indentation, and editing across one behaves.
• The block cursor stops blinking in normal mode.
• Browsing forward past today returns to today rather than walking into empty
  days.
• main did not compile for a day: image.go called an accessor that had never
  existed. It does now.

Changed

The documentation moved out of the README into docs/: a guide, the keymap,
install. The README is a front page with a picture of the thing.

Install

curl -fsSL https://raw.githubusercontent.com/praxis-labs-io/zen-notes/main/install.sh | sh

macOS and Linux, arm64 and amd64, and no Go needed. Windows takes the .zip
from this page, the installer being a POSIX script. Anything else:

go install github.com/praxis-labs-io/zen-notes@v0.2.0

Install in full,
the keymap,
and the guide.

Known gaps

• No Homebrew tap.
• The installer checks the download against the release's checksums before it
  installs anything, and refuses where neither sha256sum nor shasum is on
  PATH.
• Not in yet: . repeat, named registers, marks, macros, the jumplist.

v0.1.0

One notepad per day. Run zen-notes from anywhere and you land in today's
note, already open. Two terminals on the same day stay in sync.

Install

go install github.com/praxis-labs-io/zen-notes@v0.1.0

Go 1.26 or later. No other runtime dependency.

What's in it

• One markdown file per day, in $ZEN_NOTES_DIR or ~/.zen-notes. Point that
  at a synced folder and cross-machine sync is that service's job.
• No save key. Edits reach disk within half a second, written to a temp file
  and renamed over the target. Another window writing the note you have open
  reloads yours, and keeps your unsaved edits if you have any.
• Vim modes and motions: operators with counts, text objects, visual,
  visual-line and visual-block, undo and redo, incremental / search.
• Markdown highlighted as you type.
• Hybrid line numbers and a band on the cursor's line, in a gutter that is
  always reserved so text never shifts.
• Every color comes from your terminal theme. The four computed shades are
  derived from the terminal's own background, and asked for again when the
  window regains focus, so a theme switch is picked up.
• [ and ] walk past days, \ returns to today, ? lists the bindings.

Not in yet

. repeat, named registers, marks, macros, and the jumplist.

Deferred rather than rejected: markdown rendered with glamour in normal mode,
search across days, and rolling unchecked boxes forward.