vim-visual-multi Documentation

The plugin operates in two main modes:

1. Cursor mode: Commands work as they would in standard Vim Normal mode.
2. Extend mode: Commands work as they would in standard Vim Visual mode.

Use Tab to toggle between cursor mode and extend mode.

To experience the plugin's functionality through a guided tutorial, run Vim with the provided tutorialrc file:

vim -Nu path/to/visual-multi/tutorialrc

vim-visual-multi provides multi-cursor editing capabilities primarily from Normal mode. Use the following mappings for common tasks:

• Select words: Ctrl-N (similar to Ctrl-d in VS Code).
• Vertical cursors: Ctrl-Down or Ctrl-Up to create cursors vertically.
• Character selection: Shift-Arrows to select one character at a time.
• Navigate occurrences: n for next occurrence, N for previous occurrence.
• Navigate cursors: [ for previous cursor, ] for next cursor.
• Skip/Remove cursors: q to skip the current occurrence, Q to remove the current cursor/selection.
• Enter Insert mode: i, a, I, or A to start editing at the cursors.

You can access built-in help within Vim:

• For general documentation: :help visual-multi
• For specific topics: :help vm-<topic>