Keyboard macros

Keyboard macros can be used to automate or repeat tedious editing tasks in Emacs.

Example usage

Consider the standard *scratch* buffer:

;; This buffer is for notes you don't want to save, and for Lisp evaluation.
;; If you want to create a file, visit that file with C-x C-f,
;; then enter the text in that file's own buffer.

Suppose you want to remove the first occurrence of the letter "a" in that piece of text. You could write a regular expression to do the job, but let's assume you want to use a keyboard macro this time.

1. Make sure point is at the start of the buffer.
2. Hit C-x ( to start recording your macro. Note: If you hit C-g or if an error occurs, your keyboard macro recording will stop.
3. Hit C-s followed by a to find the first "a". Now, point is right after the first "a" in the text.
4. Hit backspace to delete that "a".

The first occurrence of "a" of the first line has been deleted. Let's move point to the beginning of the next line and then stop recording.

5. Hit C-e C-f to move point to the beginning of the next line.
6. Hit C-x ) to finish the recording of our macro.

The macro you have just recorded performs the operation of removing the first occurrence of "a" it can find and then moving point to the next line.

7. Hit C-x e once to call that macro.
8. Continue hitting e to call it several times. Hit any other key to get out of the macro repetition.

Repeating a macro

To repeat a macro e.g. five times, you could hit C-x e e e e e. This could become tedious if you want to repeat it a greater amount of times, so an alternative is to provide a numeric argument to C-x e, e.g. C-u 25 C-x e.

Repeating until there's an error

Provide a 0 prefix argument to C-x e to execute a macro from point until there is an error, e.g. C-u 0 C-x e or M-0 C-x e. See prefix arguments.

Repeating a macro on every line in a region

If you've recorded a macro which you want to call on every line in a buffer, you can use C-x C-k r, which applies the macro to every line in the region.