explaingit

junegunn/goyo.vim

4,675Vim Script
This is a quick first-pass explanation. The richer sections — use-cases, tech stack, setup, prompts — are still being generated.

TLDR

Goyo is a Vim plugin that creates a focused, distraction-free writing environment inside the Vim text editor.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

In plain English

Goyo is a Vim plugin that creates a focused, distraction-free writing environment inside the Vim text editor. When you activate it with the :Goyo command, it hides all the surrounding chrome, status bars, and line decorations, and centers your text in a clean window so you can concentrate on writing. Typing :Goyo again toggles it off and restores your normal editing environment. The name comes from a Korean word meaning quietness or stillness. The README recommends pairing it with another plugin called limelight.vim, which dims all text except the paragraph you are currently working on. You can control the size and position of the writing window using a dimension expression. This lets you specify width, height, and offsets either as fixed character counts or as percentages. For example, you can set the writing area to 120 characters wide, or center it at 50 percent of the screen width with a 25 percent offset. Several popular Vim plugins that add status bars or gutter indicators are automatically hidden while Goyo is active, including vim-airline, lightline.vim, vim-gitgutter, and vim-signify. For anything not handled automatically, Goyo provides two callback events, GoyoEnter and GoyoLeave, that let you run custom Vim script when the mode turns on and off. The README also includes a FAQ addressing a common issue: if you have custom color tweaks in your Vim config, exiting Goyo can reset them. The solution is to apply your color customizations inside a ColorScheme autocmd rather than directly in the config file. The plugin is licensed under MIT.

Open on GitHub → Explain another repo

← junegunn on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.