zed/docs/src/finding-navigating.md
Katie Geer ece66be3df
docs: Big reorganize (#45276)
Release Notes:

- N/A 

Overview

Restructures the documentation navigation to be organized by user goals
rather than feature lists. Introduces a new "Working with Code" section
and reorganizes existing content into clearer groupings.

### Navigation Changes

**New top-level sections:**
- **Working with Code** — Groups editing, navigation, and execution
features by workflow
- **Reference** — Dedicated section for lookup-only content (settings,
actions, CLI)
- **Coming From...** — Migration guides grouped together

**Reorganized sections:**
- **Customization** — Renamed from "Configuration," focused on
appearance and keybindings
- **Account & Privacy** — Consolidated auth, privacy, and telemetry
pages

New Files

| File | Purpose |
|------|---------|
| `editing-code.md` | Overview page for editing features |
| `finding-navigating.md` | Overview page for navigation tools with
quick reference |
| `running-testing.md` | Overview page for tasks, debugger, and REPL |
| `reference/all-settings.md` | Settings reference (moved/renamed) |
| `reference/cli.md` | CLI reference (moved) |

### Content Moves

| Page | From | To |
|------|------|-----|
| Snippets | Customization | Working with Code → Editing Code |
| Code Completions | (flat) | Working with Code → Editing Code |
| Diagnostics | (flat) | Working with Code → Editing Code |
| Multibuffers | (flat) | Working with Code → Editing Code |
| Command Palette | (flat) | Working with Code → Finding & Navigating |
| Outline Panel | (flat) | Working with Code → Finding & Navigating |
| Tab Switcher | (flat) | Working with Code → Finding & Navigating |
| Tasks | (flat) | Working with Code → Running & Testing |
| Debugger | (flat) | Working with Code → Running & Testing |
| REPL | (flat) | Working with Code → Running & Testing |
| All Settings | Configuration | Reference |
| CLI | (various) | Reference

---------

Co-authored-by: Marshall Bowers <git@maxdeviant.com>
Co-authored-by: Zed Zippy <234243425+zed-zippy[bot]@users.noreply.github.com>
2026-01-20 13:04:27 -08:00

2.2 KiB

Finding & Navigating

Zed provides several ways to move around your codebase quickly. Here's an overview of the main navigation tools.

Command Palette

The Command Palette ({#kb command_palette::Toggle}) is your gateway to almost everything in Zed. Type a few characters to filter commands, then press Enter to execute.

Learn more about the Command Palette →

File Finder

Open any file in your project with {#kb file_finder::Toggle}. Type part of the filename or path to narrow results.

Search across all files with {#kb pane::DeploySearch}. Results appear in a multibuffer, letting you edit matches in place.

Go to Definition

Jump to where a symbol is defined with {#kb editor::GoToDefinition} (or Cmd+Click / Ctrl+Click). If there are multiple definitions, they open in a multibuffer.

Go to Symbol

  • Current file: {#kb outline::Toggle} opens an outline of symbols in the active file
  • Entire project: {#kb project_symbols::Toggle} searches symbols across all files

Outline Panel

The Outline Panel ({#kb outline_panel::ToggleFocus}) shows a persistent tree view of symbols in the current file. It's especially useful with multibuffers for navigating search results or diagnostics.

Learn more about the Outline Panel →

Tab Switcher

Quickly switch between open tabs with {#kb tab_switcher::Toggle}. Tabs are sorted by recent use—keep holding Ctrl and press Tab to cycle through them.

Learn more about the Tab Switcher →

Quick Reference

Task Keybinding
Command Palette {#kb command_palette::Toggle}
Open file {#kb file_finder::Toggle}
Project search {#kb pane::DeploySearch}
Go to definition {#kb editor::GoToDefinition}
Find references {#kb editor::FindAllReferences}
Symbol in file {#kb outline::Toggle}
Symbol in project {#kb project_symbols::Toggle}
Outline Panel {#kb outline_panel::ToggleFocus}
Tab Switcher {#kb tab_switcher::Toggle}