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, and every file resumes where you left it — view mode, caret and scroll included. It also watches the open file, so edits made outside textli (an agent applying your comments, a git checkout) reload in place without a restart. A faint whisper status in the card's corner keeps you oriented — mode, word count, and session delta while writing; the section you're in, progress, minutes left, and open review items while reading. 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 / section)
`f`	Focus reading mode — caret-locked centre line + gradient spotlight (reading view)
`⌘T`	Typewriter scrolling (the caret line stays put; persists)
`c` / `s`	Comment / suggest a change on the selection (reading view)
`a` / `x`	Accept / reject the suggestion under the caret
`go`	Open another file — fuzzy history + per-segment path completion
`↵`	Follow the link under the caret — `.md` opens in place, web in the browser, `#heading` jumps (reading view)
`gb` / `⌫`	Back to the document the last link was followed from (reading view)
`gl`	Links overview — jump-list of every link (reading view)
`/`	Fuzzy in-document search (`n`/`N` next/previous hit; `⇥` to replace)
`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 — JetBrains Mono, Caveat and Literata — are licensed under the SIL Open Font License (JetBrains Mono, Caveat, Literata).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

textli_editor-0.3.0.tar.gz (3.1 MB view details)

Uploaded Jul 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

textli_editor-0.3.0-py3-none-any.whl (3.1 MB view details)

Uploaded Jul 12, 2026 Python 3

File details

Details for the file textli_editor-0.3.0.tar.gz.

File metadata

Download URL: textli_editor-0.3.0.tar.gz
Upload date: Jul 12, 2026
Size: 3.1 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for textli_editor-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`47b2f783fd8828ecdf0f7ebb114557af10d467dddbed07bbd20788dd401cc94e`
MD5	`f1478a16773c73027a617f5e4f4384d6`
BLAKE2b-256	`d8fcfc01a39bc600d883cee4fa8d54e82311b7b2c375414cea5002d4072decd2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for textli_editor-0.3.0.tar.gz:

Publisher: release.yml on MisterGC/textli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: textli_editor-0.3.0.tar.gz
- Subject digest: 47b2f783fd8828ecdf0f7ebb114557af10d467dddbed07bbd20788dd401cc94e
- Sigstore transparency entry: 2152525733
- Sigstore integration time: Jul 12, 2026
Source repository:
- Permalink: MisterGC/textli@4daf295b4b0d1311b0b9559299256f4a6d35e79e
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/MisterGC
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@4daf295b4b0d1311b0b9559299256f4a6d35e79e
- Trigger Event: release