Diff
1diff --git a/plugins/vi-mode/README.md b/plugins/vi-mode/README.md
2index 6e781f29690f5031b60d9a66c812caa39dd922f8..bc78cfa3d4f2d7c436fae2a4d6b8926677f32135 100644
3--- a/plugins/vi-mode/README.md
4+++ b/plugins/vi-mode/README.md
5@@ -46,7 +46,7 @@ hasn't been defined by theme, *Insert mode* is not displayed by default.
6
7 You can change these indicators by setting the `MODE_INDICATOR` (*Normal mode*) and
8 `INSERT_MODE_INDICATORS` (*Insert mode*) variables.
9-This settings support Prompt Expansion sequences. For example:
10+These settings support Prompt Expansion sequences. For example:
11
12 ```zsh
13 MODE_INDICATOR="%F{white}+%f"
14@@ -157,6 +157,27 @@ NOTE: delete/kill commands (`dd`, `D`, `c{motion}`, `C`, `x`,`X`) and yank comma
15 (`y`, `Y`) will copy to the clipboard. Contents can then be put back using paste commands
16 (`P`, `p`).
17
18+## Text objects
19+
20+Standard text objects are supported with `i` ("inside") and `a` ("around"), e.g., for words; thus, you can select the word the cursor is in with `viw`, or delete the current word, including surrounding spaces, with `daw`.
21+
22+For other text objects, you can rely on the built-in functionality of Zsh and enable it accordingly.
23+For example, for quoted strings, you can copy the commented snippet of <https://sourceforge.net/p/zsh/code/ci/master/tree/Functions/Zle/select-quoted>: place this in your `.zsrhc` file, e.g., after sourcing oh-my-zsh:
24+
25+```sh
26+autoload -U select-quoted
27+zle -N select-quoted
28+for m in visual viopp; do
29+ for c in {a,i}{\',\",\`}; do
30+ bindkey -M $m $c select-quoted
31+ done
32+done
33+```
34+
35+Now, in normal mode, you can select everything inside a double-quoted string with `vi"`.
36+Note that this works even if you're not already inside a quoted string.
37+For example, you can replace everything inside a single-quoted string in the current line, from wherever the cursor is, with `ci'`.
38+
39 ## Known issues
40
41 ### Low `$KEYTIMEOUT`