How do I split a complex Vim macro into reusable subroutines?
Record worker macro in @b, call it from @a with @b
Complex macros are hard to debug and maintain when crammed into a single register.
Category: macros
How do I inspect what key sequences are stored in a macro register?
:echo strtrans(@q)
When a macro behaves unexpectedly, :echo strtrans(@q) reveals exactly what is stored in register q—including invisible control characters—as human-readable
How do I define or modify a macro directly as a string without recording it?
:let @q='commands'
Macros in Vim are stored in registers as plain text.
How do I apply a recorded macro to every line in a visual selection?
:'<,'>norm @a
Combining :normal with a visual range lets you replay a macro on each line of a selection individually — far more targeted than recursive macros or @@ repeati
How do I create a macro that runs continuously until it hits an error?
@q
A recursive macro is a macro that calls itself as its last step, causing it to loop automatically until an operation fails (such as reaching the end of the file
How do I apply a macro to every line in a specific range without running it manually each time?
:[range]normal @q
The :[range]normal @q command replays the macro in register q on every line within a given range.
How do I run a macro a specific number of times at once?
{count}@{register}
Prefix any macro execution with a count to repeat it that many times in a single command.
How do I edit a recorded macro without re-recording it from scratch?
:let @a = "content"
When a recorded macro has a typo or needs a small tweak, you don't have to re-record it entirely.
How do I define or modify a macro without recording keystrokes?
:let @q =
Instead of recording a macro with q, you can assign any string directly to a named register using :let @{register} = 'keys'.
How do I run text I've yanked or typed as a Vim macro without recording it first?
@"
Vim macros are stored in registers — and you can execute any register as a macro with @{register}.
How do I run a recorded macro across multiple files at once?
:argdo norm @a | update
Combining :argdo with :norm @a lets you apply a recorded macro to every file in Vim's argument list — a powerful pattern for bulk refactoring across a project
How do I define or fix a macro using Vimscript instead of re-recording it?
:let @q = 'commands'
Macros in Vim are just text stored in named registers.
How do I create a macro by typing it out instead of recording it interactively?
:let @q = "dwelp"
Recording macros with q works well for simple sequences, but complex macros with special keys can be hard to get right in one take.
How do I add more steps to an existing macro without re-recording it from scratch?
qQ...q
When you record a macro into register q with qq.
How do I edit a recorded macro by modifying it as text in a buffer?
:put a ... edit ... "ayy
Recorded macros are stored as plain text in registers, but editing them by re-recording is tedious for complex sequences.
How do I create a recursive macro that repeats itself until it fails?
qqqqqq{edits}@qq
A recursive macro calls itself at the end of its sequence, creating a loop that automatically repeats until a motion or command fails (such as hitting the last
How do I make a macro repeat itself until it fails?
qaq qa...@aq @a
A recursive macro calls itself at the end of its recording, causing it to repeat indefinitely until a command inside it fails (like a search hitting the end of
How do I make a macro run repeatedly until it reaches the end of the file or encounters an error?
qaqqa{actions}@aq@a
A recursive macro is a macro that calls itself at the end of its recording.
How do I combine the dot command with macros for powerful repeat workflows?
qq;.q then @q or @@
The dot command (.
How do I save and restore macros across Vim sessions?
:wviminfo / :rviminfo
Vim can persist register contents (including macros) across sessions using viminfo (Vim) or shada (Neovim).