# vim-autoformat/vim-autoformat

Provide easy code formatting in Vim by integrating existing code formatters.

Repository: https://github.com/vim-autoformat/vim-autoformat
Canonical: https://ross.abutalabs.com/products/vim-autoformat
Language: Vim Script
License: MIT
License Family: permissive
Topics: formatter, vim, vim-indent, beautify, prettify
Last push: 2026-06-25T06:10:58+00:00

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

## Adoption (not part of the score)
Stars 2269, forks 178 (observed 2026-08-28T04:06:33.003148+00:00)

## What it is
A Vim plugin that formats code with one keypress or automatically on save by integrating external code formatters. It supports many languages via default formatter definitions, custom formatter configuration, and falls back to indenting and whitespace cleanup when no formatter is available.

## Use cases
- format code in vim with one keypress
- auto-format files on save in vim
- integrate prettier or other formatters into vim
- add a custom code formatter to vim
- clean up indentation and trailing whitespace in vim

## When to choose
- you use Vim or Neovim and want lightweight, formatter-agnostic code formatting
- you want to plug in your own external formatting programs per filetype
- you want a fallback to indent/retab cleanup when no formatter exists

## When to avoid
- you use an editor other than Vim/Neovim
- you prefer built-in LSP formatting (e.g. Neovim's built-in formatting or null-ls)
- your Vim build lacks Python support

## Facets
- artifact type: plugin
- maturity: active
- function: formatter
- domain: developer-tools, text-editors
- platform: editor-plugin, cross-platform
- tags: vim-plugin, code-formatting, neovim, beautifier, editor-plugin, vim

## Member repositories
- vim-autoformat/vim-autoformat (main) score 72

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:33.003148+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-30T02:42:00.816750+00:00, confidence not recorded.
  - readme: https://github.com/vim-autoformat/vim-autoformat (fetched 2026-08-28T04:06:33.003148+00:00, sha 0fd47aee701c)
- Data as of 2026-08-30T08:39:29.467469+00:00.
