Find and Replace plugin¶
Find and replace text in the current document, with a Notepad++-style dialog and keyboard commands that work with or without it open. Search history and options are remembered between sessions.
Where to find it¶
The Search menu:
| Command | Shortcut | What it does |
|---|---|---|
| Find… | Ctrl+F |
Opens the dialog on the Find tab. |
| Replace… | Ctrl+H (⌥⌘F on macOS) |
Opens the dialog on the Replace tab. |
| Find Next | F3 |
Jumps to the next match using the current query/options. |
| Find Previous | Shift+F3 |
Jumps to the previous match. |
| Select and Find Next | Ctrl+F3 |
Uses the current selection as the query, then finds the next match. |
| Select and Find Previous | Ctrl+Shift+F3 |
Same, searching backward. |
F3 / Shift+F3 work even when the dialog is closed.
The dialog¶
- Find what / Replace with — combo boxes with a drop-down of recent entries (Replace with appears on the Replace tab).
- Direction — Forward or Backward.
- Match case — case-sensitive search.
- Match whole word only — match only complete words.
- Wrap around — continue from the other end of the document when the search reaches the start/end (on by default).
- Search mode — see below.
- Buttons: Find Next, Find Previous, Replace (one), Replace All, Close.
Search modes¶
| Mode | Meaning |
|---|---|
| Normal | A literal substring. |
| Extended | Literal, but backslash escapes are decoded first: \n, \r, \t, \0, \\, and \xNN (a hex byte). |
| Regular expression | An ECMAScript-style regex. A "matches newline" sub-option (shown only for regex) lets . span line breaks. In Replace with, capture groups are referenced as \1–\9 or $1–$9. |
Search state is shared
The query and options are shared across the editor's search features, so a
term you type here is also what F3, Mark and
Incremental Search use.