@commte/mdbrowse 0.1.1 → 0.2.0

package/README.ja.md

@@ -2,22 +2,21 @@
 
 # mdbrowse
 
-編集中の Markdown を、自分の CSS でブラウザに表示する。シェルコマンドを実行できるエディタなら何でも使える
+編集中の Markdown を、自分の CSS でブラウザに表示する。エディタは何でもいい
 
-サーバーもポートも常駐プロセスも要らない。ショートカットを押すと現在のファイルが固定パスの HTML に変換され、開いたままのブラウザのタブがそれを拾う
+`mdb` を1回実行するとタブが開き、以後はどのプロジェクトのどの Markdown を保存しても、そのタブに出る。設定は要らない。サーバーもポートも無い
 
 ![ライトテーマ](docs/preview-light.png)
 
 ## 何のために作ったか
 
-エディタ内蔵のプレビューは、エディタの中で描画されるので見た目に手を入れられない。サーバーを立てるツールなら自由になるが、常駐とポートを引き受けることになる。これはどちらでもない。pandoc の上に乗せたシェルスクリプトと、スタイルを収めた HTML が1枚あるだけ
+エディタ内蔵のプレビューは、エディタの中で描画されるので見た目に手を入れられない。サーバーを立てるツールなら自由になるが、常駐とポートを引き受けることになる。これは pandoc の上に乗せたシェルスクリプトと、スタイルを収めた HTML が1枚あるだけで、固定パスに書き出してタブが自分で読み直す
 
 出力先が常に同じなので、ファイルを切り替えてもタブは増えない。すでに開いているタブの中身が入れ替わる
 
 ## 必要なもの
 
 - [pandoc](https://pandoc.org/) macOS は `brew install pandoc`、Debian/Ubuntu は `apt install pandoc`
-- 現在開いているファイルのパスを渡してシェルコマンドを実行できるエディタ
 
 ## インストール
 
@@ -52,28 +51,32 @@ cd mdbrowse
 
 </details>
 
-プレビュー用のタブを1回だけ開いて、そのままにしておく
+あとは1回実行する
 
 ```sh
-mdb --open
+mdb
 ```
 
-必要なのは最初の1回だけ。以後は変換するたびに、そのタブの中身が入れ替わる。開き直すのは、タブを閉じたときとブラウザを再起動したときだけ
+プレビュー用のタブが開き、小さな背景プロセスが動きだす。以後どの Markdown を保存しても、どのプロジェクトのものでも、そのタブに出る。止めるときは `mdb --stop`、再開はまた `mdb`
 
 ## 使い方
 
 ```sh
-mdb file.md   # 変換する（出力 HTML を上書きする）
-mdb --open    # プレビュー用のタブを開く
-mdb --path    # 出力先の HTML のパスを表示する
+mdb              # タブを開いて、以後ずっと追従させる
+mdb --stop       # 背景の追従を止める
+mdb --status     # いま何が出ているかを表示する
+mdb file.md      # そのファイルを1回だけ変換する
+mdb -w file.md   # 1つのファイルだけを前面で監視する（Ctrl-C で終了）
+mdb --path       # 出力先の HTML のパスを表示する
 ```
 
-ファイルの監視はしない。保存しただけでは何も起きず、`mdb <file>` が走ったときにタブが切り替わる。エディタ側でキーに割り当てるか、保存時に走らせる
+### どうやって保存したファイルを見つけているか
 
-| 環境変数 | 既定値 | |
-|---|---|---|
-| `MDBROWSE_OUT` | `/tmp/mdbrowse.html` | 出力先の HTML |
-| `MDBROWSE_HEAD` | `~/.config/mdbrowse/head.html` | スタイルとブラウザ側のスクリプト |
+Spotlight（`mdfind`）に「直近に保存された Markdown」を尋ねて、それを変換している。ディスクを歩き回らないので軽い。隠しディレクトリ、`node_modules`、`~/Library` の下は無視する。Spotlight が使えない環境では、`mdb` を実行したディレクトリを見る動きに落ちる
+
+いま開いているファイルは毎秒そのまま見ているので、続けて保存したぶんはすぐ出る。別のファイルに移ったときだけ、Spotlight が気づくまで数秒かかる
+
+最後に保存されたものを追うので、別のプログラムが Markdown を書くとプレビューが持っていかれる。1つのファイルに固定したいときは `mdb -w そのファイル.md` を使う。指定したものだけを見て、`Ctrl-C` で止まる
 
 ## ページ内の操作
 
@@ -85,6 +88,8 @@ mdb --path    # 出力先の HTML のパスを表示する
 
 ## エディタの設定
 
+`mdb` が保存を追いかけるので、以下は要らない。背景で何も動かさず、キーを押して出したい場合はこちらを設定する。どれも1回だけ変換する `mdb <file>` を呼んでいる
+
 ### Zed
 
 `install.sh` が `~/.config/zed/tasks.json` を作る。既存のファイルがある場合は上書きせず、貼り付ける内容を表示する。あとは `~/.config/zed/keymap.json` にキーを追加する
@@ -169,7 +174,7 @@ mdb sample.md
 ## 仕組み
 
 ```
-エディタのショートカット → mdb <file> → pandoc → /tmp/mdbrowse.html
+ファイルを保存 → mdb（またはエディタのショートカット） → pandoc → /tmp/mdbrowse.html
                                                       → /tmp/mdbrowse-stamp.js
                                                               ↑
                                        ブラウザがスタンプを見て、変化したときだけ再読み込み
@@ -181,6 +186,8 @@ YAML の frontmatter は本文に出さない。ファイル側の `title` が
 
 元ファイルからの相対パス（画像や隣のファイルへのリンク）は、変換時に絶対 `file://` へ書き換える。HTML が `/tmp` にあっても画像が表示されるのはこのため。書き換えるのは `img` や `a` などタグの属性だけなので、本文に `src="foo.png"` と書いても表示はそのまま。絶対パス、スキーム付きのもの（`http(s)`、`data:`、`mailto:` など）、`//` 始まり、ページ内アンカーには触らない。パスに `&` や `#`、空白が入っていても壊れない
 
+監視は同じ変換を繰り返しているだけ。背景プロセスは、開いているファイルの更新時刻とサイズを1秒ごとに、直近に保存された Markdown を2秒ごとに見て、変わったら変換し直す。待ち受けるものは無くポートも持たない。`mdb --stop` で終わり、`ps` に見えるシェルのプロセスが1つあるだけ
+
 ページは静的なので、待ち受けているものは何も無く、終了させる必要もない
 
 ## ライセンス

package/README.md

@@ -2,22 +2,21 @@ English | [日本語](README.ja.md)
 
 # mdbrowse
 
-Preview the Markdown file you are editing in a real browser, with your own CSS, from any editor that can run a shell command.
+Preview the Markdown file you are editing in a real browser, with your own CSS, from any editor.
 
-No server. No port. No daemon. One shortcut renders the current file to a fixed HTML path, and the browser tab you already have open picks it up.
+Run `mdb` once. It opens a tab, and from then on whatever Markdown file you save — in any project, from any editor — appears in it. No configuration, no server, no port.
 
 ![Light theme](docs/preview-light.png)
 
 ## Why
 
-Editors render Markdown previews inside their own window and give you little control over the result. Server-based previewers give you control but ask you to keep a process and a port around. This does neither: it is a shell script on top of `pandoc`, plus one HTML file holding the styles.
+Editors render Markdown previews inside their own window and give you little control over the result. Server-based previewers give you control but ask you to keep a process and a port around. This is a shell script on top of `pandoc` plus one HTML file holding the styles: it renders to a fixed path and the tab reloads itself.
 
 Because the output path never changes, switching between files does not open new tabs. The tab you already have simply shows the new file.
 
 ## Requirements
 
 - [pandoc](https://pandoc.org/) — macOS: `brew install pandoc`, Debian/Ubuntu: `apt install pandoc`
-- An editor that can run a shell command with the path of the active file
 
 ## Install
 
@@ -52,28 +51,32 @@ This installs `mdb` (and the longer `mdbrowse`) into `~/.local/bin`, and the sty
 
 </details>
 
-Open the preview tab once and leave it open:
+Then run it once:
 
 ```sh
-mdb --open
+mdb
 ```
 
-Once is enough: from then on every render swaps the contents of that tab. You only open it again after closing the tab or restarting the browser.
+That opens the preview tab and starts a small background process. Save any Markdown file from here on and it shows up in that tab, whichever project it lives in. `mdb --stop` ends it; `mdb` starts it again.
 
 ## Usage
 
 ```sh
-mdb file.md   # render (overwrites the output HTML)
-mdb --open    # open the preview tab
-mdb --path    # print the output HTML path
+mdb              # open the tab and keep it in sync
+mdb --stop       # stop the background sync
+mdb --status     # show what is being previewed
+mdb file.md      # render one file, once
+mdb -w file.md   # follow one file in the foreground (Ctrl-C to stop)
+mdb --path       # print the output HTML path
 ```
 
-Nothing watches the filesystem. Saving a file does not update the preview by itself — the tab changes when `mdb <file>` runs, so bind it to a key or to save in your editor.
+### How the sync finds your file
 
-| Variable | Default | |
-|---|---|---|
-| `MDBROWSE_OUT` | `/tmp/mdbrowse.html` | output HTML path |
-| `MDBROWSE_HEAD` | `~/.config/mdbrowse/head.html` | stylesheet and browser script |
+It asks Spotlight (`mdfind`) which Markdown file was saved most recently, twice a second-and-a-bit, and renders that one. Walking your disk is never involved, so it stays cheap. Files under hidden directories, `node_modules` and `~/Library` are ignored. Without Spotlight it falls back to watching the directory you started `mdb` in.
+
+The file you are editing right now is checked every second directly, so repeated saves show up immediately; moving to a different file takes a couple of seconds longer, while Spotlight notices it.
+
+Because it follows whatever was saved last, another program writing a Markdown file can pull the preview away. If you want the tab pinned to one file, run `mdb -w that-file.md` instead — that watches only what you name, and stops when you press `Ctrl-C`.
 
 ## In-page controls
 
@@ -85,6 +88,8 @@ The table of contents is built from the headings of the current file and follows
 
 ## Editor setup
 
+None of this is needed — `mdb` already follows what you save. Set one of these up if you would rather press a key and have nothing running in the background. They all call `mdb <file>`, the render-once mode.
+
 ### Zed
 
 `install.sh` writes `~/.config/zed/tasks.json` for you — it will not overwrite an existing one; it prints the entries to paste instead. Then bind a key in `~/.config/zed/keymap.json`:
@@ -169,7 +174,7 @@ mdb sample.md
 ## How it works
 
 ```
-editor shortcut → mdb <file> → pandoc → /tmp/mdbrowse.html
+save a file → mdb (or an editor shortcut) → pandoc → /tmp/mdbrowse.html
                                              → /tmp/mdbrowse-stamp.js
                                                       ↑
                               browser polls the stamp, reloads only on change
@@ -179,6 +184,8 @@ YAML front matter is consumed rather than printed: the file's own `title` does n
 
 Each render also writes a one-line stamp file. The page polls that stamp instead of reloading blindly, so it refreshes only when you actually preview something new — no periodic flicker on pages with images. Polling pauses while you scroll, while you print, and while the pointer is on the bar. Image dimensions are remembered per session, so a refresh does not shift the layout while images load.
 
+Watching is the same render in a loop. The background process compares the file's timestamp and size once a second, asks Spotlight for the newest Markdown file every other second, and renders again when either changes. It listens on nothing and has no port; `mdb --stop` ends it, and it is a single shell process you can see in `ps`.
+
 The page is static, so nothing is listening and nothing needs to be shut down.
 
 ## License

package/bin/mdbrowse

@@ -3,7 +3,7 @@
 # browser tab can stay open and just swap its contents.
 set -euo pipefail
 
-VERSION="0.1.1"
+VERSION="0.2.0"
 PROG="$(basename "$0")"
 OUT="${MDBROWSE_OUT:-/tmp/mdbrowse.html}"
 CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/mdbrowse"
@@ -36,11 +36,22 @@ usage() {
 mdb — render Markdown to a fixed HTML file for browser preview
 
 Usage:
-  mdb <file.md>   render the file (overwrites the output HTML)
-  mdb --open      open the preview tab in the default browser
-  mdb --eject     copy the bundled stylesheet into your config directory
-  mdb --path      print the output HTML path
-  mdb --version   print the version
+  mdb                    open the preview tab and keep it in sync from then on
+  mdb <file.md>          render that file once
+  mdb --stop             stop the background sync
+  mdb --status           show what is being previewed
+  mdb -w <file|dir>      watch in the foreground instead (Ctrl-C to stop)
+  mdb --eject            copy the bundled stylesheet into your config directory
+  mdb --path             print the output HTML path
+  mdb --version          print the version
+
+With no arguments, mdb opens the preview tab and starts a small background
+process. From then on, whatever Markdown file you save — in any project, from
+any editor — shows up in that tab. Nothing else to set up. `mdb --stop` ends it.
+
+Finding the file you just saved uses Spotlight (mdfind). Files under hidden
+directories, node_modules and ~/Library are ignored. Without Spotlight, mdb
+falls back to watching the directory you started it in.
 
 The same command is also installed under its full name, `mdbrowse`.
 
@@ -61,10 +72,57 @@ open_url() {
   fi
 }
 
+open_tab() {
+  [ -f "$OUT" ] || printf '<!doctype html><meta charset="utf-8"><p>No preview yet.' > "$OUT"
+  [ -f "${OUT%.html}-stamp.js" ] || printf 'window.__mdbrowseStamp="0";\n' > "${OUT%.html}-stamp.js"
+  open_url
+}
+
+PIDFILE="${OUT%.html}-sync.pid"
+
+running_pid() {
+  [ -f "$PIDFILE" ] || return 1
+  local pid; pid="$(cat "$PIDFILE" 2>/dev/null)"
+  [ -n "$pid" ] || return 1
+  kill -0 "$pid" 2>/dev/null || return 1
+  echo "$pid"
+}
+
+stop_sync() {
+  local pid
+  if pid="$(running_pid)"; then
+    kill "$pid" 2>/dev/null || true
+    rm -f "$PIDFILE"
+    echo "$PROG: stopped"
+  else
+    rm -f "$PIDFILE"
+    echo "$PROG: not running"
+  fi
+}
+
+start_sync() {
+  if running_pid >/dev/null; then
+    echo "$PROG: already in sync (mdb --stop to end it)"
+    return 0
+  fi
+  nohup "$0" --sync-daemon "$PWD" >/dev/null 2>&1 &
+  echo $! > "$PIDFILE"
+  echo "$PROG: in sync — save any .md and it shows up here (mdb --stop to end it)"
+}
+
 case "${1:-}" in
   -h|--help) usage; exit 0 ;;
   -v|--version) echo "mdbrowse $VERSION"; exit 0 ;;
   --path) echo "$OUT"; exit 0 ;;
+  --stop) stop_sync; exit 0 ;;
+  --status)
+    if running_pid >/dev/null; then
+      echo "$PROG: in sync (pid $(running_pid))"
+    else
+      echo "$PROG: not running"
+    fi
+    [ -f "$OUT" ] && echo "showing: $(grep -o '<title>[^<]*' "$OUT" 2>/dev/null | sed 's/<title>//')"
+    exit 0 ;;
   --eject)
     mkdir -p "$CONFIG_DIR"
     if [ -f "$CONFIG_DIR/head.html" ] && [ "${2:-}" != "--force" ]; then
@@ -74,20 +132,54 @@ case "${1:-}" in
     cp "$BUNDLED_HEAD" "$CONFIG_DIR/head.html"
     echo "$CONFIG_DIR/head.html"
     exit 0 ;;
-  --open)
-    [ -f "$OUT" ] || printf '<!doctype html><meta charset="utf-8"><p>No preview yet.' > "$OUT"
-    [ -f "${OUT%.html}-stamp.js" ] || printf 'window.__mdbrowseStamp="0";\n' > "${OUT%.html}-stamp.js"
-    open_url; exit 0 ;;
-  "") usage; exit 2 ;;
 esac
 
-src="$1"
+# 残りは「オプション＋ファイル」
+watch=0
+do_open=0
+daemon=0
+sync_cwd=""
+src=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -w|--watch) watch=1 ;;
+    -o|--open) do_open=1 ;;
+    --sync-daemon) daemon=1; shift; sync_cwd="${1:-$PWD}" ;;
+    --) shift; [ $# -gt 0 ] && src="$1"; break ;;
+    -*) echo "$PROG: unknown option: $1" >&2; exit 2 ;;
+    *) src="$1" ;;
+  esac
+  shift
+done
+
+# 引数なし（または --open だけ）が既定の使い方。タブを開いて、以後は勝手に追従する
+if [ -z "$src" ] && [ "$watch" -eq 0 ] && [ "$daemon" -eq 0 ]; then
+  if ! command -v pandoc >/dev/null 2>&1; then
+    echo "$PROG: pandoc not found. Install it first (macOS: brew install pandoc)" >&2
+    exit 127
+  fi
+  open_tab
+  start_sync
+  exit 0
+fi
+
+# -w だけならカレントディレクトリを見る
+[ -z "$src" ] && [ "$watch" -eq 1 ] && src="."
 
 if ! command -v pandoc >/dev/null 2>&1; then
   echo "$PROG: pandoc not found. Install it first (macOS: brew install pandoc)" >&2
   exit 127
 fi
-if [ ! -f "$src" ]; then
+root=""
+if [ "$daemon" -eq 1 ]; then
+  :
+elif [ -d "$src" ]; then
+  if [ "$watch" -eq 0 ]; then
+    echo "$PROG: $src is a directory (pass -w to watch it)" >&2
+    exit 2
+  fi
+  root="$src"
+elif [ ! -f "$src" ]; then
   echo "$PROG: no such file: $src" >&2
   exit 66
 fi
@@ -108,26 +200,27 @@ else
   if [ "$use_shiki" -eq 1 ]; then hl=(--no-highlight); else hl=(--highlight-style breezedark); fi
 fi
 
-args=(--standalone --from gfm "${hl[@]}" --variable "pagetitle=$(basename "$src")" --output "$OUT")
-[ -f "$HEAD" ] && args+=(--include-in-header "$HEAD")
+render() {
+  local args=(--standalone --from gfm "${hl[@]}" --variable "pagetitle=$(basename "$src")" --output "$OUT")
+  [ -f "$HEAD" ] && args+=(--include-in-header "$HEAD")
 
-pandoc "$src" "${args[@]}"
+  pandoc "$src" "${args[@]}"
 
-# コードブロックを Shiki で色付けし直す。失敗しても変換自体は成立させる
-if [ "$use_shiki" -eq 1 ]; then
-  node "$HIGHLIGHTER" "$OUT" || true
-fi
+  # コードブロックを Shiki で色付けし直す。失敗しても変換自体は成立させる
+  if [ "$use_shiki" -eq 1 ]; then
+    node "$HIGHLIGHTER" "$OUT" || true
+  fi
 
-# frontmatter の title を pandoc が拾うと本文の先頭に見出しが増えるので落とす。
-# ブラウザのタブ名には pagetitle を使っている
-perl -0pi -e 's#<header id="title-block-header">.*?</header>\n?##s' "$OUT"
+  # frontmatter の title を pandoc が拾うと本文の先頭に見出しが増えるので落とす。
+  # ブラウザのタブ名には pagetitle を使っている
+  perl -0pi -e 's#<header id="title-block-header">.*?</header>\n?##s' "$OUT"
 
-# 出力先が /tmp なので、元ファイルからの相対パス（画像・ローカルリンク）が
-# そのままでは解決できない。ソースのあるディレクトリ基準の file:// に書き換える。
-# 書き換えるのはタグの属性だけ。本文中の src="..." のようなインラインコードは触らない。
-# スキーム付き（http(s) data: mailto: など）／絶対パス／ページ内アンカーはそのまま残す
-src_dir="$(cd "$(dirname "$src")" && pwd)"
-MDBROWSE_SRC_DIR="$src_dir" perl -0pi -e '
+  # 出力先が /tmp なので、元ファイルからの相対パス（画像・ローカルリンク）が
+  # そのままでは解決できない。ソースのあるディレクトリ基準の file:// に書き換える。
+  # 書き換えるのはタグの属性だけ。本文中の src="..." のようなインラインコードは触らない。
+  # スキーム付き（http(s) data: mailto: など）／絶対パス／ページ内アンカーはそのまま残す
+  local src_dir="$(cd "$(dirname "$src")" && pwd)"
+  MDBROWSE_SRC_DIR="$src_dir" perl -0pi -e '
   BEGIN {
     $base = $ENV{MDBROWSE_SRC_DIR};
     # file:// の中で意味を持つ文字は先に逃がす（% は必ず最初）
@@ -144,5 +237,107 @@ MDBROWSE_SRC_DIR="$src_dir" perl -0pi -e '
   }gse;
 ' "$OUT"
 
-# 更新の目印。ブラウザはこれを見て、中身が変わったときだけ読み直す
-printf 'window.__mdbrowseStamp="%s";\n' "$(date +%s)-$RANDOM" > "${OUT%.html}-stamp.js"
+  # 更新の目印。ブラウザはこれを見て、中身が変わったときだけ読み直す
+  printf 'window.__mdbrowseStamp="%s";\n' "$(date +%s)-$RANDOM" > "${OUT%.html}-stamp.js"
+}
+
+# ファイルの更新時刻とサイズ。同じ秒内の2回目の保存も拾えるようにサイズも見る
+if stat -f %m . >/dev/null 2>&1; then
+  fingerprint() { stat -f '%m %z' "$1" 2>/dev/null; }
+  stat_time_name() { xargs -0 stat -f '%m %N' 2>/dev/null; }
+else
+  fingerprint() { stat -c '%Y %s' "$1" 2>/dev/null; }
+  stat_time_name() { xargs -0 stat -c '%Y %n' 2>/dev/null; }
+fi
+
+# ディレクトリの中でいちばん最近保存された Markdown
+newest_md() {
+  find "$1" \( -name .git -o -name node_modules -o -name .venv \) -prune \
+       -o -type f -name '*.md' -print0 2>/dev/null \
+    | stat_time_name | sort -rn | head -1 | cut -d' ' -f2-
+}
+
+# Spotlight で「家じゅうで直近に保存された Markdown」を引く。木を歩かないので速い
+newest_global() {
+  mdfind 'kMDItemFSName == "*.md"c && kMDItemContentModificationDate >= $time.now(-1800)' 2>/dev/null \
+    | grep -v -e '/\.' -e '/node_modules/' -e '/Library/' \
+    | tr '\n' '\0' | stat_time_name | sort -rn | head -1 | cut -d' ' -f2-
+}
+
+# 背景で動く本体。保存された Markdown を追いかけて変換し続ける
+if [ "$daemon" -eq 1 ]; then
+  trap 'rm -f "$PIDFILE"' EXIT
+  use_spotlight=0
+  command -v mdfind >/dev/null 2>&1 && use_spotlight=1
+  [ "$use_spotlight" -eq 0 ] && root="$sync_cwd"
+
+  pick() {
+    if [ "$use_spotlight" -eq 1 ]; then newest_global; else newest_md "$root"; fi
+  }
+
+  src="$(pick)"
+  if [ -n "$src" ] && [ -f "$src" ]; then render || true; fi
+  last="$src $(fingerprint "$src") $(fingerprint "$HEAD")"
+  # 開いているファイルの保存は毎秒見る。別ファイルへの切り替えの検出は2秒ごと
+  tick=0
+  while sleep 1; do
+    tick=$(( tick + 1 ))
+    if [ $(( tick % 2 )) -eq 0 ]; then
+      cand="$(pick)"
+      [ -n "$cand" ] && src="$cand"
+    fi
+    [ -f "$src" ] || continue
+    now="$src $(fingerprint "$src") $(fingerprint "$HEAD")"
+    [ "$now" = "$last" ] && continue
+    last="$now"
+    render || true
+  done
+  exit 0
+fi
+
+if [ -n "$root" ]; then
+  src="$(newest_md "$root")"
+  if [ -z "$src" ]; then
+    echo "$PROG: no Markdown file under $root" >&2
+    exit 66
+  fi
+fi
+
+[ "$do_open" -eq 1 ] && open_tab
+
+render
+
+# 監視。保存のたびに変換し直す。スタイルシートを直したときも作り直す
+if [ "$watch" -eq 1 ]; then
+  # ディレクトリを見る場合、木が大きいと走査が重い。1回の走査時間から
+  # 待ち時間を決めて、CPU を食い潰さないようにする
+  interval=1
+  if [ -n "$root" ]; then
+    t0="$(perl -MTime::HiRes=time -e 'printf "%d", time*1000')"
+    newest_md "$root" >/dev/null
+    t1="$(perl -MTime::HiRes=time -e 'printf "%d", time*1000')"
+    scan=$(( t1 - t0 ))
+    interval=$(( (scan * 5 + 999) / 1000 ))
+    [ "$interval" -lt 1 ] && interval=1
+    [ "$interval" -gt 10 ] && interval=10
+    if [ "$interval" -gt 1 ]; then
+      echo "$PROG: watching $root — save any .md under it (checking every ${interval}s; a smaller directory reacts faster) (Ctrl-C to stop)" >&2
+    else
+      echo "$PROG: watching $root — save any .md under it (Ctrl-C to stop)" >&2
+    fi
+  else
+    echo "$PROG: watching $src (Ctrl-C to stop)" >&2
+  fi
+  last="$src $(fingerprint "$src") $(fingerprint "$HEAD")"
+  while sleep "$interval"; do
+    if [ -n "$root" ]; then
+      cand="$(newest_md "$root")"
+      [ -n "$cand" ] && src="$cand"
+    fi
+    now="$src $(fingerprint "$src") $(fingerprint "$HEAD")"
+    [ "$now" = "$last" ] && continue
+    last="$now"
+    [ -f "$src" ] || continue
+    render || echo "$PROG: render failed" >&2
+  done
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commte/mdbrowse",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Preview the Markdown file you are editing in a real browser, with your own CSS, from any editor that can run a shell command. No server, no port.",
   "bin": {
     "mdbrowse": "bin/mdbrowse",