read-only markdown viewer
縁側 A quiet porch for the Markdown your AI writes.
Sit on the engawa — the veranda beside the house where your AI works — and watch the documents it generates, without touching them.
Editing is the AI's job. Reading is yours.
see it running
Light or dark.
One pane, or two.
Pick a view below to enlarge it. These are real screenshots of Engawa v0.16.0 — reading its own README and spec.
Front matter folds away · Mermaid renders inline · scroll position is kept on reload.
why a porch
Generated fast. Nowhere calm to read it.
Coding assistants write Markdown by the pageful. The terminal is a poor place to take it in, and a normal editor opens in edit mode — one stray keystroke and you've changed the AI's work. Engawa is the read-only pane you set beside the terminal. There is nothing to break.
what it does
Everything for reading. Nothing for editing.
Just what a viewing pane needs, with the lightness of a native macOS app.
Watches and reloads
When the AI rewrites a file, Engawa updates instantly and keeps your scroll position. Parent-directory watching handles atomic renames.
Safe by design
No write APIs at all. It only reads under the folders you choose. There is no command that can alter your files.
Two panes
Open a second document on the right to compare. Drag the divider to resize; Cmd-F acts on the focused pane.
GFM-style rendering
Mermaid diagrams, foldable front matter, a heading outline, syntax highlighting. Raw HTML is sanitized with DOMPurify.
Many ways in
Drag & drop a .md or a folder onto the window. Double-click a .md in Finder to open it in Engawa. Add multiple root folders with a name filter.
Themes, and memory
Light / Dark / Auto appearance. Your open files, pane widths and scroll positions are restored on launch — saved only in app data, never in your docs.
get it
Signed, notarized, ready.
Every build is signed with a Developer ID and notarized by Apple — it opens without any security warnings. For Apple Silicon Macs (M1 and later).
- Open the DMG and drag
Engawa.appto/Applications. - Launch it — no security dialogs, thanks to Apple notarization.
- Drop a .md or a folder onto the window — or use Add Folder.