From 65561ed828362cceb61d80ac6ad7dcca3d9a4c58 Mon Sep 17 00:00:00 2001
From: Conrad Irwin <conrad.irwin@gmail.com>
Date: Wed, 12 Jun 2024 22:10:49 -0600
Subject: [PATCH] Docs to help people find their way back (#12958)

Release Notes:

- N/A
---
 docs/src/vim.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/src/vim.md b/docs/src/vim.md
index 53ee22ee36ea37..2f16cf4a524417 100644
--- a/docs/src/vim.md
+++ b/docs/src/vim.md
@@ -137,6 +137,26 @@ Binding `jk` to exit insert mode and go to normal mode:
 }
 ```
 
+### Restoring some sense of normality
+
+If you're using Vim mode on Linux or Windows, you may find that it has overridden keybindings
+that you can't live without. You can restore them to their defaults by copying these into your keymap:
+
+```
+{
+  "context": "Editor && !VimWaiting && !menu",
+  "bindings": {
+    "ctrl-c": "editor::Copy",          // vim default: return to normal mode
+    "ctrl-x": "editor::Cut",           // vim default: increment
+    "ctrl-v": "editor::Paste",         // vim default: visual block mode
+    "ctrl-y": "editor::Undo",          // vim default: line up
+    "ctrl-f": "buffer_search::Deploy", // vim default: page down
+    "ctrl-o": "workspace::Open",       // vim default: go back
+    "ctrl-a": "editor::SelectAll",     // vim default: increment
+  }
+},
+```
+
 ## Command palette
 
 Vim mode allows you to enable Zed’s command palette with `:`. This means that you can use vim's command palette to run any action that Zed supports.