From e944cfa2fe622a7a15041b9dfc7770933792857c Mon Sep 17 00:00:00 2001 From: Dino Date: Wed, 18 Nov 2026 10:47:36 +0000 Subject: [PATCH] docs: Mention system clipboard register in Helix's core differences (#67140) ## Summary After the discussion on https://github.com/zed-industries/zed/issues/66782, update the Helix mode's documentation, specifically in the "Core Differences" section to mention that, by default, the system clipboard register is used for yanking, deleting and pasting and instructing users how to set `vim.use_system_clipboard` to make it behave just like Helix and use the internal register by default instead. ## Testing Tested manually by running `mdbook serve docs` and reading that section of the documentation. ## Self-review - [x] I've reviewed my diff for quality, security, reliability, and performance. - [x] UI changes follow the [checklist](https://zed.dev/docs/development/ui-checklist). - [x] Tests cover the new or changed behavior. Release Notes: - N/A --- docs/src/helix.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/src/helix.md b/docs/src/helix.md index cec150f00aa..705a15bd492 100644 --- a/docs/src/helix.md +++ b/docs/src/helix.md @@ -17,6 +17,16 @@ For a detailed list of Helix's default keybindings, please visit the [official H ## Core differences +By default, Zed's Helix mode uses the system clipboard for yanking, deleting, and pasting. To match Helix's behavior and use internal registers instead, set `vim.use_system_clipboard` to `"never"`. You can always access the system clipboard by explicitly using `+` as the register. + +```json [settings] +{ + "vim": { + "use_system_clipboard": "never" + } +} +``` + Any text object that works with `m i` or `m a` also works with `]` and `[`, so for example `] (` selects the next pair of parentheses after the cursor. In Helix mode, some text object keys follow Helix's meanings instead of Vim's: `m i m` and `m a m` select the closest surrounding pair of any kind (brackets, quotes, backticks, or vertical bars), `t` is the type/class text object, `c` is the comment text object, and `x` is the (X)HTML element text object.