textli-editor 0.1.0

A lightweight text editor with focused writing and reading in mind

textli

A lightweight text editor with focused writing and reading in mind.

textli is a full-window, distraction-free Markdown editor: one warm paper-toned column of text, vim keybindings, and nothing else on screen. ⌘R flips the source into a rendered reading view made for proof-reading and review — navigate with vim motions, leave inline comments, and propose suggestions (track changes) that the author accepts or rejects with a keystroke. All annotations are stored inline as CriticMarkup, so they travel with the file and diff cleanly in git — no sidecar files.

textli started life as the editor inside grafli, the keyboard-driven diagram tool, and is now its own package — usable standalone or embeddable in any PySide6 application.

Install

uv tool install textli-editor   # or: pipx / pip install textli-editor

The package publishes as textli-editor (plain textli is too close to an existing PyPI name), but everywhere else it's just textli: the command is textli, the import is import textli.

Use

textli notes.md                     # open (created on first save)
textli notes.md#design-decisions    # jump straight to a heading
textli -r review.md                 # start in the reading view

The editor opens ready to type (vim NORMAL mode) and autosaves while you work. Press F1 inside the editor for the complete key reference, or see the documentation.

The short version

Key	Action
⌘R	Toggle write ↔ reading view
Esc	Save & close (⇧Esc cancels)
⌘↵	Full-window width
⌘.	Section focus (dim all but the current paragraph)
c / s	Comment / suggest a change on the selection (reading view)
a / x	Accept / reject the suggestion under the caret
F1	Full help

Embed

from textli import ZenMarkdownEditor, InlineVimEditor

ZenMarkdownEditor is the full-window editor (parent it into any widget); InlineVimEditor is a small vim-capable QPlainTextEdit for editing a single piece of text in place. See the embedding guide.

Develop

uv venv && uv pip install -e '.[dev]'
QT_QPA_PLATFORM=offscreen .venv/bin/pytest -q

License

MIT — see LICENSE. Bundled fonts are licensed under the SIL Open Font License.