# yggdroot/indentline

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/yggdroot-indentline).**

4,121 stars · 234 forks · Vim Script · MIT · archived

## Links

- GitHub: https://github.com/Yggdroot/indentLine
- awesome-repositories: https://awesome-repositories.com/repository/yggdroot-indentline.md

## Topics

`indentline` `vim` `vim-plugin`

## Description

indentLine is a Vim plugin and text editor extension that serves as a code structure visualizer. It renders vertical indentation guides to help developers identify the start and end of nested blocks and improve code readability.

The tool provides customizable indentation line appearances, allowing users to define the characters and colors used to distinguish between different nesting levels. It also includes a visibility toggle to switch these guides on or off.

The plugin manages indentation level visualization through a virtual-text overlay that does not modify the actual text content of the file. It utilizes column-based coordinate calculations and event-driven updates to ensure lines align with the current buffer state.

## Tags

### Graphics & Multimedia

- [Indentation Guides](https://awesome-repositories.com/f/graphics-multimedia/code-structure-visualizations/indentation-guides.md) — Provides vertical guides that help developers visualize the structural nesting of code blocks in Vim.

### Development Tools & Productivity

- [Vim Plugins](https://awesome-repositories.com/f/development-tools-productivity/vim-plugins.md) — Implements a specialized extension for the Vim editor to render indentation guides.
- [Vimscript Automations](https://awesome-repositories.com/f/development-tools-productivity/vimscript-automations.md) — Utilizes Vimscript to interface directly with the editor's internal window and buffer APIs.
- [Editor Appearance Customizations](https://awesome-repositories.com/f/development-tools-productivity/editor-extensions/editor-behavior-customizations/editor-appearance-customizations.md) — Allows customization of editor appearance through configurable colors and characters for indentation lines.
- [Indentation-Based Navigation](https://awesome-repositories.com/f/development-tools-productivity/indentation-based-navigation.md) — Enhances the ability to navigate and track nested code blocks through visual indentation markers.

### Software Engineering & Architecture

- [Event-Driven UI Updates](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-ui-updates.md) — Triggers automatic redraws of indentation guides in response to text modifications or scrolling events.

### User Interface & Experience

- [Coordinate-Based Position Calculators](https://awesome-repositories.com/f/user-interface-experience/coordinate-based-position-calculators.md) — Calculates the exact horizontal coordinates for vertical guides by analyzing leading whitespace on each line.
- [Indentation Visualizers](https://awesome-repositories.com/f/user-interface-experience/indentation-visualizers.md) — Renders visual guides that represent the nesting levels of source code blocks. ([source](https://github.com/yggdroot/indentline#readme))
- [Syntax Structure Visualizers](https://awesome-repositories.com/f/user-interface-experience/syntax-structure-visualizers.md) — Uses vertical lines and color cues to represent the hierarchy and nesting of source code.
- [Indentation Level Highlighting](https://awesome-repositories.com/f/user-interface-experience/syntax-highlighters/region-based-highlighting/indentation-level-highlighting.md) — Provides customizable highlight groups and characters to distinguish between different nesting levels. ([source](https://github.com/yggdroot/indentline#readme))
- [Dynamic Color Mappings](https://awesome-repositories.com/f/user-interface-experience/terminal-text-coloring/color-specifications/dynamic-color-mappings.md) — Provides a system for mapping specific indentation depths to distinct highlight groups for visual clarity.

### Web Development

- [Editor Virtual Text Overlays](https://awesome-repositories.com/f/web-development/text-highlighting/non-destructive-text-overlays/editor-virtual-text-overlays.md) — Renders indentation guides as a non-destructive virtual-text overlay that does not alter the file content.