Diff
1diff --git a/plugins/vi-mode/README.md b/plugins/vi-mode/README.md
2new file mode 100644
3index 0000000000000000000000000000000000000000..03e67cca27a332e49b2d92577e1547c628744da3
4--- /dev/null
5+++ b/plugins/vi-mode/README.md
6@@ -0,0 +1,75 @@
7+vi-mode
8+=======
9+This plugin increase `vi-like` zsh functionality.
10+
11+Use `ESC` or `CTRL-[` to enter `Normal mode`.
12+
13+
14+History
15+-------
16+
17+- `ctrl-p` : Previous command in history
18+- `ctrl-n` : Next command in history
19+- `/` : Search backward in history
20+- `n` : Repeat the last `/`
21+
22+
23+Mode indicators
24+---------------
25+
26+*Normal mode* is indicated with red `<<<` mark at the right prompt, when it
27+wasn't defined by theme.
28+
29+
30+Vim edition
31+-----------
32+
33+- `v` : Edit current command line in Vim
34+
35+
36+Movement
37+--------
38+
39+- `$` : To the end of the line
40+- `^` : To the first non-blank character of the line
41+- `0` : To the first character of the line
42+- `w` : [count] words forward
43+- `W` : [count] WORDS forward
44+- `e` : Forward to the end of word [count] inclusive
45+- `E` : Forward to the end of WORD [count] inclusive
46+- `b` : [count] words backward
47+- `B` : [count] WORDS backward
48+- `t{char}` : Till before [count]'th occurrence of {char} to the right
49+- `T{char}` : Till before [count]'th occurrence of {char} to the left
50+- `f{char}` : To [count]'th occurrence of {char} to the right
51+- `F{char}` : To [count]'th occurrence of {char} to the left
52+- `;` : Repeat latest f, t, F or T [count] times
53+- `,` : Repeat latest f, t, F or T in opposite direction
54+
55+
56+Insertion
57+---------
58+
59+- `i` : Insert text before the cursor
60+- `I` : Insert text before the first character in the line
61+- `a` : Append text after the cursor
62+- `A` : Append text at the end of the line
63+- `o` : Insert new command line below the current one
64+- `O` : Insert new command line above the current one
65+
66+
67+Delete and Insert
68+-----------------
69+
70+- `ctrl-h` : While in *Insert mode*: delete character after the cursor
71+- `ctrl-w` : While in *Insert mode*: delete word after the cursor
72+- `d{motion}` : Delete text that {motion} moves over
73+- `dd` : Delete line
74+- `D` : Delete characters under the cursor until the end of the line
75+- `c{motion}` : Delete {motion} text and start insert
76+- `cc` : Delete line and start insert
77+- `C` : Delete to the end of the line and start insert
78+- `r{char}` : Replace the character under the cursor with {char}
79+- `R` : Enter replace mode: Each character replaces existing one
80+- `x` : Delete [count] characters under and after the cursor
81+- `X` : Delete [count] characters before the cursor