Repository navigation
Releases
inkpot v0.18.0
Added
- Highlighting in your own editor.
ink lspnow highlights.inkfiles
(semantic tokens): headings and scenes, metadata, comments, insertions and
deletions with their attribution, links, citations, interpolation, and bold
and italic, all from the same parser the app uses. Comments are colored out
of the box; the README has a short Neovim snippet linking the rest to your
theme (#141).
inkpot v0.17.0
Added
- The
inkCLI ships with every release. Download the archive for your
platform (macOS, Linux and Windows) from the release, or on macOS and Linux
brew install thombruce/tap/inkpot-cli. It includes the language server, and
ink --version/ink --helpare new (#137). - A language server for your own editor.
ink lspspeaks the Language
Server Protocol, so Neovim (and other LSP editors) get inkpot's outline as
document symbols, folding by heading, and formatting to house style, and
reports its name and release version to the editor. See the README for the
Neovim setup (#141).
Fixed
- Formatting no longer turns prose into metadata. Normalizing a document
(ink fmt, or the app when you leave a document) dropped the blank line after
a heading with no metadata (or at the very top of a file), so a first line like
Note: call Samwas read back as metadata and vanished from the manuscript.
The blank line is now kept.
inkpot v0.16.1
Fixed
- Edits made outside inkpot are no longer overwritten. Editing the open file
in another editor (Neovim, VS Code), or having a sync client orgitchange it,
could be silently lost the next time inkpot autosaved. inkpot now reloads the
file when you come back to it. If you also had unsaved changes in inkpot, it
keeps both: yours stay in the file, and the other version is saved beside it
asname.conflict-<date-time>.ink, with a note in the status bar (#135). - No more "Discard unsaved changes?" for files that autosave. Opening another
file (from the tree, Recent, Open, Open Folder, New, or a codex link) now saves
the current one first instead of asking, so answering the prompt can no longer
throw away your last second of typing. Only an untitled document still asks —
as does a file that couldn't be saved, and then the prompt says why (#143).
inkpot v0.16.0
Added
- View shortcuts and a status bar.
Ctrl+1…Ctrl+8(Cmdon macOS)
switch views in the view menu's order, and the menu is highlighted while you're
away from the editor. The file name and word count moved out of the toolbar
into a status bar along the bottom (#95). - Notes panel. A new view lists every note-to-self in the document —
/line
comments,{/inline comments}(showing who left them, if attributed), and
TK placeholders (TK, orTKTK, as a whole word) — with a count of what's
left to do. Click an entry to jump to it (#41). - Fold all / unfold all.
Ctrl-KthenCtrl-0collapses the editor to its
top-level sections;Ctrl-KthenCtrl-Junfolds everything (Cmdon macOS),
as in VS Code (#18).
Fixed
- On macOS,
Ctrl-NandCtrl-Oin the editor (cursor down and split line)
no longer also start a new file or open the file dialog.
inkpot v0.15.0
Added
- Attributed CriticMarkup. Any CriticMarkup span can say who suggested it,
and optionally when:{+new words|@Ada Lovelace|2026-10-04}. It changes
nothing in print; the editor shows the attribution muted. The groundwork for
reviewing edit suggestions from editors and proofreaders (#116, epic #111).
Changed
- Soft line breaks. A single line break inside a paragraph now prints as a
space in every view (preview, manuscript, PDF), Markdown-style. You can wrap
lines freely or write one sentence per line. End a line with\for a hard
line break (a\ending a paragraph does nothing and never prints; write
\\for a literal one). Format change: verse or other text that relied
on single line breaks printing as breaks needs a trailing\on each line
that should break (#112).
inkpot v0.14.0
Added
- Autocomplete for references in the editor. Typing
{&/[[suggests
wikilink targets (codex entity titles);{@/[@suggests citation keys
(sourceids). Accepting one fills the target and closes the brace. Draws from
the current file's%entities (#40, #91). - Auto-normalize to house style on save. When you leave a document (switch
window, close, jump to another file, or hit Save) the editor rewrites borrowed
[[ ]]/[@ ]/{{ }}to the house{&}/{@}/{=}forms — paste in Obsidian
or Pandoc markup and it converts itself. It also tidies formatting (collapsing
runs of blank lines to one), like a format-on-save. The typing autosave stays
raw, so text never reflows mid-sentence, and the caret is preserved across the
conversion (#105).
inkpot v0.13.0
Added
- One inline vocabulary, in braces. The reference/substitution forms now have
a canonical house spelling that reads as one family with CriticMarkup:{&link}
(wikilink),{@cite}(citation),{=interp}(interpolation), beside
{+ } {- } {~ } {/ }. The borrowed forms still parse — paste in Obsidian
[[ ]], Pandoc[@ ], or Mustache{{ }}freely — but the house forms are
what you get back:ink fmt [--write] <file.ink>normalizes a document to
them, and both spellings render identically. The normalizer is idempotent and
meaning-preserving (escaped markers included). (#99, #101; auto-normalize-on-save
in the app is a follow-up, #105.) - Inline markup works in headings, not just body prose: emphasis, links,
citations, interpolation, and CriticMarkup all render in a title — e.g.
# The **Great** {~War~Conflict},# About [[alice]], or a tracked title
revision. Headings resolve like prose in every view; a heading with markup stays
linkable by its plain-text title (#100).
inkpot v0.12.0
Changed
- Toolbar no longer crowds off-frame in small windows: the bar now wraps to a
second row instead of pushing buttons out of view, and the six view buttons
(Codex/Characters/Map/Timeline/Bibliography/Preview) are folded into one view
picker dropdown — pick which panel the main area shows (#96). - Citations & wikilinks resolve project-wide in the manuscript, preview, PDF
export, and bibliography — not just per-file. A[@key]or[[link]]now finds
its source/entity in any project file, so sources can live in a separate
research file and still render author-date and appear in the bibliography (a
cross-file reference in the bibliography jumps to the file it's defined in). The
codex was already cross-file (#28); this brings the text views in line (#89).
Added
- Inline citations + bibliography (
.inkas an essay/paper tool): cite a source
with[@key]or[@key, p. 42], or group several in one parenthetical with;
([@smith2020; @jones2019]→(Smith, 2020; Jones, 2019)), where the key is a
%codex entity'sidor title. Citations render as Harvard author-date —
(Ferber, 2011, p. 42)— in the manuscript, preview, and PDF export, and each
cited source earns a codex backlink. A new Bibliography view collates the
cited sources into a sorted, Harvard-formatted reference list from their
author/year/title/edition/place/publishermetadata. Enterauthor
surname-first (Ferber, E.). Resolution spans the whole project (sources can
live in a separate references file). (#84, #89, #90) - Cross-file codex: in a multi-file project the codex now spans every file —
a[[wikilink]]or metadata reference resolves to a%entity in any file,
and an entity's "Referenced by" list gathers referrers project-wide. Clicking a
cross-file backlink opens that file before scrolling.id:handles resolve
project-globally; a same-named entity in the referrer's own file still wins, so
single-file behaviour is unchanged (#28).
inkpot v0.11.0
[0.11.0] - 2026-09-05
Added
-
Whole-project Shunn PDF: in a multi-file project, Export PDF now offers to
bind every file, in tree order, into one Shunn book — chapters flow file after
file, each starting on a new page, under a single title page and running header.
The work's title-page metadata comes from theInkpotmarker's front matter
(title:/author:/byline:/contact:), falling back to the first file if the
marker declares none; the word count sums the whole work. Single-file export is
unchanged (#23). -
Shunn manuscript PDF export: export the active document as a submission-ready
Shunn Proper Manuscript Format PDF — title page
(contact block, title, byline, rounded word count), a runningSurname / KEYWORD / page#header, double-spaced Courier prose with 0.5″ indents, chapters starting on
a new page, and centered#scene breaks. Set the work's front matter at the top
of the file —title:,author:,byline:, and a multilinecontact:. The PDF
is generated in Rust (bundled Courier Prime, fully offline) so output is identical
on every platform. Also available headless:ink export --out=book.pdf [--trim=WxH] file.ink(#23). -
Outline follows the caret: the outline rail highlights the section your
cursor sits in and scrolls it into view, so you always see where you are —
updating live as the caret moves, and pairing with the existing click-to-jump
(#19). -
Concatenated project export: in a multi-file project, Export offers to stitch
every.inkfile's manuscript — in tree order (dirs-before-files by name) — into
one continuous work, so a novel kept one-file-per-chapter exports as a single
manuscript. Single-file export is unchanged; the choice appears only when a
project has more than one file. App-layer concatenation over per-file renders —
ink-corestays file-agnostic (#74).
Changed
- Heading size follows visible depth: manuscript/preview headings now size by
their visible position, not raw marker count — a#/~/%-hidden ancestor no
longer shrinks the visible headings beneath it. The shallowest printed heading is
<h1>(#in Markdown), its printed children<h2>, and so on (#25).
Unsigned builds — macOS and Windows will warn on first open (this is expected for an unsigned app); see the README for how to open them.
Download the installer for your OS below.
inkpot v0.10.0
Unsigned builds — macOS and Windows will warn on first open (this is expected for an unsigned app); see the README for how to open them.
Download the installer for your OS below.