Ream — docs & guide

Your files

Ream edits plain Markdown in a folder you choose — your vault. Click the vault name (top-left) to open another folder, or Import from Scrivener, Ulysses, or Bear. The same folder opens in Obsidian or any editor; nothing is locked away.

Writing

Click any paragraph to edit it directly. Hover between paragraphs to reveal the + insert bar — add headings, callouts, dividers, and images (or drag/paste an image straight in). View ▾ → Source shows the raw Markdown whenever you want it.

Hover a block to reveal its delete button; Alt ↑/↓ moves a paragraph, and ⌘ Z undoes inserts, deletes, moves, and AI rewrites.

Saving & versions

Autosave keeps your draft live (the dot toggles it). Save lays down a restorable version. Open Tools ▾ → Version history to diff or roll back, and name checkpoints you want to find again.

AI help

Highlight text → Ask your editor, or use one-click Rewrite / Shorten / Grammar / Tone — each previews before applying. The right-hand panel chats about the highlighted passage; + starts a general chat. Pick a single editor or a whole panel of them, each with its own voice, plus Newt, the neutral one. The AI is included — no key to wire, no bill to watch.

Voice DNA

An editor trained on your writing rather than a house style. Open Editors → Your voices → Train an editor on your voice and give Ream a few pieces you have already written — paste them in, add a link, or drop in a .docx. It reads them and builds a style profile: rhythm, diction, how you open a sentence, how you use asides. Voices are yours, not a project's — a voice you train follows you into every book.

Calibrating

Calibrate is where it gets sharp. Each round shows two versions of a passage from your own work, identical except for one style dimension, and you pick the one that sounds like you — or Neither, which reopens the dimension rather than forcing a preference you do not hold. Every pick writes a plain-English rule onto the style card (“Use em-dashes for asides, not parentheses”) that you can read, edit, or delete. Twelve dimensions in all, and progress reads as dimensions resolved, not clicks.

Ream will happily give you notes in a voice from the moment it is trained. It will not generate prose in your name until the six core dimensions are calibrated — a weak note costs you a moment, but off-voice prose accepted into a manuscript quietly sands your voice down, which is the thing this feature exists to prevent.

Using a voice

Once a voice is trained, highlight a passage and Rewrite in your voice, continue a sentence in it, or expand rough notes with it. Check voice reads a passage against your profile and lists exactly where it drifts, quoting the phrase and suggesting a fix that sounds like you. Set the voice a project is written in on the title page, and every in-voice action uses it by default.

Story Bible

Under Tools ▾, add characters, places, and facts; the AI reads them to keep your prose consistent. Suggest names finds them automatically, Find in book shows every mention, and AI: check consistency flags contradictions before your readers do.

Find & checks

Find & replace spans the whole book (⌘ F). The consistency check scans for wrong character/type pairings, broken links, and unfinished template text.

Notes

Highlight → Comment for private margin notes (shown in green). The composer opens right at the passage; resolve or delete notes from Tools ▾ → Comments. Saved chats are amber, the open chat is blue.

Look & output

View ▾ → Theme offers 35 presets plus a custom palette. Export the whole book to Markdown, standalone HTML, or Print / PDF.

Shortcuts

⌘ K command palette · ⌘ S save a version · ⌘ F find · ⌘ Z undo · Alt ↑/↓ move a paragraph · click an image to set its alt text.

First run lets you open, create, or import a vault — a folder of Markdown you choose. Everything stays on your disk.

Need a hand? Email hello@ream.page.