How do I define or edit a macro's content programmatically without re-recording it?
:let @q = 'keystrokes'
You can assign a string directly to any register using :let, turning it into a macro instantly.
Category: macros
How do I run a macro on every line in the file silently, ignoring errors on lines where the macro fails?
:silent! %normal @q
Combining :silent!, the % range, and :normal @q gives you a powerful pattern for applying a macro across an entire file while gracefully skipping lines that don
How do I use a count prefix in a custom Vim mapping where no count defaults to 1?
v:count1
The v:count1 variable holds the count typed before a command, defaulting to 1 if no count was given.
How do I run a macro on every line in a specific line number range?
:{range} normal @{reg}
The :normal command lets you execute Normal mode keystrokes over a range of lines.
How do I extract regex capture groups from a string in Vimscript?
matchlist()
matchlist({str}, {pattern}) runs a regex match and returns a list of all captured groups, making it the idiomatic way to extract structured data from strings in
How do I read a single keystroke from the user inside a Vimscript mapping or function?
getchar()
getchar() blocks and waits for the user to press a key, returning its numeric character code.
How do I edit a macro in-place using Vimscript without re-recording it?
:let @a = substitute(@a, "old", "new", "g")
When a recorded macro has a typo or wrong command buried inside it, you don't have to re-record the entire thing.
How do I edit an existing macro without re-recording it from scratch?
:let @a = '...'
When a recorded macro contains a typo or needs a small tweak, you can modify it directly via the :let command rather than re-recording the entire sequence.
How do I run normal mode commands in a script without triggering user-defined key mappings?
:normal! {cmd}
When you use :normal {cmd} in a Vimscript function, macro, or Ex command, Vim expands any keys through the user's current mappings first.
How do I edit or modify an existing Vim macro programmatically without re-recording it?
:let @q = substitute(@q, "old", "new", "g")
Vim macros are stored as plain text in registers, which means you can inspect and modify them like any other string.
How do I run a macro as many times as needed until it hits an error and stops automatically in Vim?
1000@q
Vim macros stop executing the moment any step in the macro causes an error — a failed search, a motion that cannot proceed, or a substitution with no matches.
How do I execute the contents of the system clipboard as a Vim macro?
@+
In Vim, @{register} executes the contents of any register as a macro.
How do I add more keystrokes to the end of an existing macro without re-recording the whole thing?
qQ (or any uppercase register letter)
When recording a macro with qq, you can append additional keystrokes to the existing macro by recording into the uppercase version of the same register.
How do I make a macro prompt for user input at a specific point during its execution?
<C-r>=input('Enter: ')<CR>
By embedding =input('prompt: ') inside a recorded macro, you can pause the macro at any point to ask for user input and insert the result.
How do I programmatically extend or modify a recorded macro without re-recording it?
:let @a = @a . "\<CR>extra"
Vim stores macros as plain text in registers — the same registers used for yanked text.
How do I append more commands to an existing macro without re-recording it from scratch?
qQ
Recording a macro with an uppercase register letter appends to the existing macro in the corresponding lowercase register instead of overwriting it.
How do I combine two recorded macros into one without re-recording them from scratch?
:let @q = @a . @b
Macros in Vim are stored as plain text in named registers.
How do I detect whether a macro is currently being recorded or executed in Vimscript?
reg_recording() and reg_executing()
Vim exposes two built-in functions for querying the current macro state: regrecording() and regexecuting().
How do I build a macro programmatically using Vimscript instead of recording it?
:call setreg('q', keys, 'c')
The setreg() function writes any string directly into a named register, letting you construct macro keystrokes from Vimscript expressions rather than live recor
How do I create a macro that repeats itself automatically until it can no longer proceed?
qq{actions}@qq
A recursive macro ends by calling itself, so it loops automatically without you pressing @q repeatedly.