# preservim/vim-pencil

Rethinking Vim as a tool for writing

Repository: https://github.com/preservim/vim-pencil
Canonical: https://ross.abutalabs.com/products/vim-pencil
Language: Vim Script
License: NOASSERTION
License Family: other
Topics: vim, writing, markdown, textile, asciidoc, restructured-text, vim-plugin, prose
Last push: 2023-04-03T18:16:21+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4624, "days_push": 1248, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1905, forks 42 (observed 2026-08-28T04:05:51.889029+00:00)

## What it is
A Vim plugin that adapts Vim for writing prose rather than code, with tweaks for wrap modes, navigation, undo points, and markup concealment. It supports prose file types like Markdown, text, RST, TeX, Textile, and AsciiDoc.

## Use cases
- write prose in vim
- use vim as a word processor for markdown
- soft wrap long lines while writing
- hide markdown markup symbols while editing
- autoformat text while typing in vim
- write rst or asciidoc documents in vim

## When to choose
- you already use Vim and want it tuned for writing prose
- you edit Markdown, RST, TeX, Textile, or AsciiDoc documents
- you want both soft wrap and hard line break workflows with automatic detection

## When to avoid
- you want a distraction-free writing app with spell-check and previews built in
- you don't use Vim or a modal editor
- you need rich text or proprietary word processor formats

## Facets
- artifact type: plugin
- maturity: maintenance
- function: editor, markdown
- domain: text-editors, documentation, developer-tools
- platform: editor-plugin, cli, cross-platform
- tags: vim-plugin, prose-writing, vimscript, word-processing, text-editors

## Member repositories
- preservim/vim-pencil (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.889029+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:43.962154+00:00, confidence not recorded.
  - readme: https://github.com/preservim/vim-pencil (fetched 2026-08-28T04:05:51.889029+00:00, sha a83d93f23bef)
- Data as of 2026-08-30T08:39:29.467469+00:00.