andymass/vim-matchup
Vim Matchup
Vim-matchup is a plugin for the Vim and Neovim text editors that provides advanced structural code navigation and manipulation. It functions as an extension to standard editor motions, enabling users to jump between, select, and modify matching language constructs and nested code blocks with high precision.
The plugin distinguishes itself by utilizing language-specific syntax trees to track and identify corresponding delimiters and keywords. By integrating with syntax-aware engines, it maintains structural accuracy even in complex source files, while offering a fallback pattern-matching mechanism for environments where advanced syntax analysis is unavailable.
Beyond basic navigation, the tool supports comprehensive code block manipulation, allowing for the deletion, selection, or restructuring of entire scopes. It provides real-time visual feedback through pair highlighting and status line integration, and allows users to define custom text objects and matching rules to suit specific language requirements.
Features
- Vim Plugins - Provides advanced structural code navigation and manipulation for Vim and Neovim by extending standard editor motions and syntax-aware pair matching.
- Matching Tag Navigation - Allows jumping between corresponding opening and closing language constructs using directional motions.
- Pair Matching Logic - Uses language-specific syntax trees to identify and navigate between corresponding code delimiters with high structural accuracy.
- Command Key Bindings - Extends editor primitives with custom key bindings for manipulating code blocks and delimiters.
- Structural Block Selections - Enables users to highlight the contents or entire scope of nested code blocks for bulk operations.
- Search Match Highlighting - Provides real-time visual identification of corresponding delimiters and keywords.
- Visual Code Manipulation - Streamlines the selection, deletion, and modification of nested code structures through intuitive commands.
- Structural Code Navigation - Displays breadcrumb-style navigation paths by identifying successive matching words within nested code structures.
- Syntax-Aware Navigation - Utilizes language-specific syntax trees to automatically track and analyze matching pairs across various programming languages.
- Custom Text-Object Definitions - Enables users to define custom text objects for selecting or modifying specific blocks of code.
- Surround Management - Provides operator commands to delete, change, or restructure entire code blocks and their surrounding delimiters.
- Programming Language Detectors - Automatically identifies and tracks corresponding keywords and delimiters in various programming languages.
- Editor Motion Mappings - Provides keyboard-driven commands for jumping between and modifying nested code blocks using standard editor motions.
- Tree-Sitter Parsers - Leverages language-specific syntax trees to accurately jump between and highlight matching code constructs.
- Syntax Traversal - Navigates nested code structures by traversing syntax trees to locate parent or sibling nodes.
