An Introduction to Vim Mode in Zed

2026-01-24T00:00:00.000Z

Zed’s Vim mode offers a powerful and familiar experience for Vim enthusiasts, integrating classic modal editing with Zed’s modern, high-performance features. Rather than a one-to-one clone, Zed’s approach is to provide a seamless blend of Vim’s efficiency with advanced capabilities like semantic navigation, multiple cursors, and deep integration with the language server.

Core Design Philosophy

The goal of Zed’s Vim mode is to replicate the motions and commands you’re used to, while leveraging Zed’s core strengths. Here are some of the key differences and integrations:

  • Semantic Navigation: Motions are powered by Zed’s Tree-sitter integration, providing language-aware navigation for code structures like methods, classes, and functions.
  • Multiple Cursors: Visual block selections are emulated using Zed’s native multiple cursors, offering a more powerful and intuitive way to edit multiple lines at once.
  • Integrated Search: Search and replace operations use Zed’s fast, modern regex engine.
  • Language Server Power: Commands like g d (Go to Definition) and g . (Open Code Actions) are wired directly into the language server, providing intelligent, context-aware actions.

Getting Started

You can easily enable or disable Vim mode from the welcome screen or by using the toggle vim mode command in the command palette. Once enabled, you can customize the experience through your keymap.json and settings.json files to tailor it to your exact workflow.

Exploring Deeper

To help you get the most out of Zed’s Vim mode, we’ve broken down the key mappings and features into a series of detailed posts:

Stay tuned for these upcoming posts, where we’ll dive into the specifics of each mode and feature.

HQ Key Mappings

gg / G Jump to top/bottom of page
j / k Scroll page up/down
h / l Focus navigation bar and move left/right
c / Escape Remove focus from nav bar / Close modal
x / Enter Follow a focused navigation link
t / T Cycle through site themes
m / M Toggle light/dark mode
f / / Open search dialog
? Open help dialog