diff --git a/VIMTOKAK b/VIMTOKAK
index 29d14d022..298e7f6a7 100644
--- a/VIMTOKAK
+++ b/VIMTOKAK
@@ -30,3 +30,13 @@ join line with next:
 delete to line end:
  * vim: d$
  * kak: alt-ld or gld
+
+some classic vim moves are not bound to the same key, this is due to Kakoune
+using shifted moves to append to selection, so moves that were bound to non
+alphabetic chars had to change.
+
+* % become m (for matching), however m will replace selection with the next
+  block, if you want to get a selection from current point to next block end,
+  you should use <space>M (<space> clears the trim to one character)
+
+* 0 and $ became alt-h and alt-l. Another binding is gh and gl.