diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index 1f0e2b34f2..51410182b2 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -1,3 +1,8 @@
+---
+title: AI Coding Agent - Zed Agent Panel
+description: Use Zed's AI coding agent to generate, refactor, and debug code with tool calling, checkpoints, and multi-model support.
+---
+
 # Agent Panel
 
 The Agent Panel is where you interact with AI agents that can read, write, and run code in your project. Use it for code generation, refactoring, debugging, documentation, and general questions.
diff --git a/docs/src/ai/agent-settings.md b/docs/src/ai/agent-settings.md
index db3195f2c7..52e6de2710 100644
--- a/docs/src/ai/agent-settings.md
+++ b/docs/src/ai/agent-settings.md
@@ -1,3 +1,8 @@
+---
+title: AI Agent Settings - Zed
+description: Customize Zed's AI agent: default models, temperature, tool approval, auto-run commands, notifications, and panel options.
+---
+
 # Agent Settings
 
 Settings for Zed's Agent Panel, including model selection, UI preferences, and tool permissions.
diff --git a/docs/src/ai/ai-improvement.md b/docs/src/ai/ai-improvement.md
index 1942a406e9..6ae4832377 100644
--- a/docs/src/ai/ai-improvement.md
+++ b/docs/src/ai/ai-improvement.md
@@ -1,3 +1,8 @@
+---
+title: AI Improvement and Data Collection - Zed
+description: Zed's opt-in approach to AI data collection for improving the agent panel and edit predictions.
+---
+
 # Zed AI Improvement
 
 ## Agent Panel
diff --git a/docs/src/ai/billing.md b/docs/src/ai/billing.md
index f9d9b6343a..4d83a232b8 100644
--- a/docs/src/ai/billing.md
+++ b/docs/src/ai/billing.md
@@ -1,3 +1,8 @@
+---
+title: Billing - Zed AI
+description: Manage Zed AI billing, payment methods, invoices, threshold billing, and sales tax information.
+---
+
 # Billing
 
 We use Stripe as our payments provider, and Orb for invoicing and metering. All Pro plans require payment via credit card or other supported payment method.
diff --git a/docs/src/ai/configuration.md b/docs/src/ai/configuration.md
index 8b213c3c0e..e02f6cc49c 100644
--- a/docs/src/ai/configuration.md
+++ b/docs/src/ai/configuration.md
@@ -1,3 +1,8 @@
+---
+title: Configure AI in Zed - Providers, Models, and Settings
+description: Set up AI in Zed with hosted models, your own API keys, or external agents. Includes how to disable AI entirely.
+---
+
 # Configuration
 
 When using AI in Zed, you can configure multiple dimensions:
diff --git a/docs/src/ai/edit-prediction.md b/docs/src/ai/edit-prediction.md
index 4775853545..53f7927efb 100644
--- a/docs/src/ai/edit-prediction.md
+++ b/docs/src/ai/edit-prediction.md
@@ -1,3 +1,8 @@
+---
+title: AI Code Completion in Zed - Zeta, Copilot, Supermaven
+description: Set up AI code completions in Zed with Zeta (built-in), GitHub Copilot, Supermaven, or Codestral. Multi-line predictions on every keystroke.
+---
+
 # Edit Prediction
 
 Edit Prediction is Zed's LLM mechanism for predicting the code you want to write.
diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md
index a256e86a25..b80aa8bcdb 100644
--- a/docs/src/ai/external-agents.md
+++ b/docs/src/ai/external-agents.md
@@ -1,3 +1,8 @@
+---
+title: Use Claude Code, Gemini CLI, and Codex in Zed
+description: Run Claude Code, Gemini CLI, Codex, and other AI coding agents directly in Zed via the Agent Client Protocol (ACP).
+---
+
 # External Agents
 
 Zed supports many external agents, including CLI-based ones, through the [Agent Client Protocol (ACP)](https://agentclientprotocol.com).
diff --git a/docs/src/ai/inline-assistant.md b/docs/src/ai/inline-assistant.md
index e4278b411b..8c9463351a 100644
--- a/docs/src/ai/inline-assistant.md
+++ b/docs/src/ai/inline-assistant.md
@@ -1,3 +1,8 @@
+---
+title: Inline AI Code Editing - Zed
+description: Transform code inline with AI in Zed. Send selections to any LLM for refactoring, generation, or editing with multi-cursor support.
+---
+
 # Inline Assistant
 
 ## Usage Overview
diff --git a/docs/src/ai/llm-providers.md b/docs/src/ai/llm-providers.md
index f224890b5d..bd353defa2 100644
--- a/docs/src/ai/llm-providers.md
+++ b/docs/src/ai/llm-providers.md
@@ -1,3 +1,8 @@
+---
+title: LLM Providers - Use Your Own API Keys in Zed
+description: Bring your own API keys to Zed. Set up Anthropic, OpenAI, Google AI, Ollama, DeepSeek, Mistral, OpenRouter, and more.
+---
+
 # LLM Providers
 
 To use AI in Zed, you need to have at least one large language model provider set up.
diff --git a/docs/src/ai/mcp.md b/docs/src/ai/mcp.md
index fa5bc37b08..4ea040290b 100644
--- a/docs/src/ai/mcp.md
+++ b/docs/src/ai/mcp.md
@@ -1,3 +1,8 @@
+---
+title: Model Context Protocol (MCP) in Zed
+description: Install and configure MCP servers in Zed to extend your AI agent with external tools, data sources, and integrations.
+---
+
 # Model Context Protocol
 
 Zed uses the [Model Context Protocol](https://modelcontextprotocol.io/) to interact with context servers.
diff --git a/docs/src/ai/models.md b/docs/src/ai/models.md
index 2c9922ae97..ebfb9e3f90 100644
--- a/docs/src/ai/models.md
+++ b/docs/src/ai/models.md
@@ -1,3 +1,8 @@
+---
+title: AI Models and Pricing - Zed
+description: AI models available via Zed Pro including Claude, GPT-5, Gemini, and Grok. Pricing, context windows, and tool call support.
+---
+
 # Models
 
 Zed's plans offer hosted versions of major LLMs with higher rate limits than direct API access. Model availability is updated regularly.
diff --git a/docs/src/ai/overview.md b/docs/src/ai/overview.md
index 77906fc49c..8fb9801fe2 100644
--- a/docs/src/ai/overview.md
+++ b/docs/src/ai/overview.md
@@ -1,3 +1,8 @@
+---
+title: AI Code Editor Documentation - Zed
+description: Docs for AI in Zed, the open-source AI code editor. Agentic coding, inline edits, AI code completion, and multi-model support.
+---
+
 # AI
 
 Zed integrates AI throughout the editor: agentic coding, inline transformations, edit prediction, and direct model conversations.
diff --git a/docs/src/ai/plans-and-usage.md b/docs/src/ai/plans-and-usage.md
index fb17429856..bebc4c4fb3 100644
--- a/docs/src/ai/plans-and-usage.md
+++ b/docs/src/ai/plans-and-usage.md
@@ -1,3 +1,8 @@
+---
+title: Plans and Usage - Zed AI
+description: Understand Zed's AI plans, token-based usage metering, spend limits, and trial details.
+---
+
 # Plans and Usage
 
 ## Available Plans {#plans}
diff --git a/docs/src/ai/privacy-and-security.md b/docs/src/ai/privacy-and-security.md
index f8b72e230e..de0baf1795 100644
--- a/docs/src/ai/privacy-and-security.md
+++ b/docs/src/ai/privacy-and-security.md
@@ -1,3 +1,8 @@
+---
+title: AI Privacy and Security - Zed
+description: Zed's approach to AI privacy: opt-in data sharing by default, zero-data retention with providers, and full open-source transparency.
+---
+
 # Privacy and Security
 
 ## Philosophy
diff --git a/docs/src/ai/rules.md b/docs/src/ai/rules.md
index 7611bde638..a3de54daac 100644
--- a/docs/src/ai/rules.md
+++ b/docs/src/ai/rules.md
@@ -1,3 +1,8 @@
+---
+title: AI Rules in Zed - .rules, .cursorrules, CLAUDE.md
+description: Configure AI behavior in Zed with .rules files, .cursorrules, CLAUDE.md, AGENTS.md, and the Rules Library for project-level instructions.
+---
+
 # Using Rules {#using-rules}
 
 Rules are prompts inserted at the beginning of each agent interaction. Add them via files in your worktree (`.rules`, etc.) or through the Rules Library for reuse across projects and threads.
diff --git a/docs/src/ai/subscription.md b/docs/src/ai/subscription.md
index 03893ede3c..0c4896fdbc 100644
--- a/docs/src/ai/subscription.md
+++ b/docs/src/ai/subscription.md
@@ -1,3 +1,8 @@
+---
+title: Zed AI Subscription
+description: Learn about Zed Pro and Business plans for hosted AI models with higher rate limits and premium features.
+---
+
 # Subscription
 
 Zed's hosted models are offered via subscription to Zed Pro or Zed Business.
diff --git a/docs/src/ai/text-threads.md b/docs/src/ai/text-threads.md
index ea72f1dfae..220392690e 100644
--- a/docs/src/ai/text-threads.md
+++ b/docs/src/ai/text-threads.md
@@ -1,3 +1,8 @@
+---
+title: AI Chat in Your Editor - Zed Text Threads
+description: Chat with LLMs directly in your editor with Zed's text threads. Full control over context, message roles, and slash commands.
+---
+
 # Text Threads
 
 ## Overview {#overview}
diff --git a/docs/src/ai/tools.md b/docs/src/ai/tools.md
index 5897cdc5b3..6bc16fc5db 100644
--- a/docs/src/ai/tools.md
+++ b/docs/src/ai/tools.md
@@ -1,3 +1,8 @@
+---
+title: AI Agent Tools - Zed
+description: Built-in tools for Zed's AI agent including file editing, code search, terminal commands, web search, and diagnostics.
+---
+
 # Tools
 
 Zed's built-in agent has access to these tools for reading, searching, and editing your codebase.
diff --git a/docs/src/appearance.md b/docs/src/appearance.md
index 835e56229f..fdf5e239cc 100644
--- a/docs/src/appearance.md
+++ b/docs/src/appearance.md
@@ -1,3 +1,8 @@
+---
+title: Appearance and Visual Customization - Zed
+description: Customize Zed's themes, fonts, icons, UI density, and other visual settings to match your preferences.
+---
+
 # Appearance
 
 Customize Zed's visual appearance to match your preferences. This guide covers themes, fonts, icons, and other visual settings.
diff --git a/docs/src/command-palette.md b/docs/src/command-palette.md
index b573fc6a5f..703cce561b 100644
--- a/docs/src/command-palette.md
+++ b/docs/src/command-palette.md
@@ -1,3 +1,8 @@
+---
+title: Command Palette - Zed
+description: Access any Zed action from the command palette. Fuzzy search commands, key bindings, and editor actions.
+---
+
 # Command Palette
 
 The Command Palette is the main way to access pretty much any functionality that's available in Zed. Its keybinding is the first one you should make yourself familiar with. To open it, hit: {#kb command_palette::Toggle}.
diff --git a/docs/src/completions.md b/docs/src/completions.md
index 7b35ec2d09..9962fd5f24 100644
--- a/docs/src/completions.md
+++ b/docs/src/completions.md
@@ -1,3 +1,8 @@
+---
+title: Code Completions - Zed
+description: Zed's code completions from language servers and edit predictions. Configure autocomplete behavior, snippets, and documentation display.
+---
+
 # Completions
 
 Zed supports two sources for completions:
diff --git a/docs/src/configuring-languages.md b/docs/src/configuring-languages.md
index 06e5f9b77b..90fec03c0b 100644
--- a/docs/src/configuring-languages.md
+++ b/docs/src/configuring-languages.md
@@ -1,3 +1,8 @@
+---
+title: Language Server and Tree-sitter Config - Zed
+description: Configure language support in Zed with Tree-sitter for syntax highlighting and LSP for diagnostics, completion, and formatting.
+---
+
 # Configuring Supported Languages
 
 Zed's language support is built on two technologies:
diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 9bec490e5a..5b0fdca397 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -1,3 +1,8 @@
+---
+title: Configuring Zed - Settings and Preferences
+description: Configure Zed with the Settings Editor, JSON files, and project-specific overrides. Covers all settings options.
+---
+
 # Configuring Zed
 
 This guide explains how Zed's settings system works, including the Settings Editor, JSON configuration files, and project-specific settings.
diff --git a/docs/src/debugger.md b/docs/src/debugger.md
index 55315d1b49..04e4ca7271 100644
--- a/docs/src/debugger.md
+++ b/docs/src/debugger.md
@@ -1,3 +1,8 @@
+---
+title: Debugger - Zed
+description: Debug code in Zed with the Debug Adapter Protocol (DAP). Breakpoints, stepping, variable inspection across multiple languages.
+---
+
 # Debugger
 
 Zed uses the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/) to provide debugging functionality across multiple programming languages.
diff --git a/docs/src/dev-containers.md b/docs/src/dev-containers.md
index 54a167ff3e..eabb969425 100644
--- a/docs/src/dev-containers.md
+++ b/docs/src/dev-containers.md
@@ -1,3 +1,8 @@
+---
+title: Dev Containers - Zed
+description: Open projects in dev containers with Zed. Reproducible development environments using devcontainer.json configuration.
+---
+
 # Dev Containers
 
 Dev Containers provide a consistent, reproducible development environment by defining your project's dependencies, tools, and settings in a container configuration.
diff --git a/docs/src/diagnostics.md b/docs/src/diagnostics.md
index 47cc586008..5c019ecac3 100644
--- a/docs/src/diagnostics.md
+++ b/docs/src/diagnostics.md
@@ -1,3 +1,8 @@
+---
+title: Diagnostics - Errors and Warnings in Zed
+description: View and navigate errors, warnings, and code diagnostics from language servers in Zed.
+---
+
 # Diagnostics
 
 Zed gets its diagnostics from the language servers and supports both push and pull variants of the LSP which makes it compatible with all existing language servers.
diff --git a/docs/src/editing-code.md b/docs/src/editing-code.md
index d0e57c9374..fdc4611578 100644
--- a/docs/src/editing-code.md
+++ b/docs/src/editing-code.md
@@ -1,3 +1,8 @@
+---
+title: Editing Code in Zed
+description: Core code editing features in Zed including multi-cursor, refactoring, code actions, and language server integration.
+---
+
 # Editing Code
 
 Zed provides tools to help you write and modify code efficiently. This section covers the core editing features that work alongside your language server.
diff --git a/docs/src/environment.md b/docs/src/environment.md
index 11af40c91d..3749292f03 100644
--- a/docs/src/environment.md
+++ b/docs/src/environment.md
@@ -1,3 +1,8 @@
+---
+title: Environment Variables - Zed
+description: How Zed detects and uses environment variables. Shell integration, dotenv support, and troubleshooting.
+---
+
 # Environment Variables
 
 _**Note**: The following only applies to Zed 0.152.0 and later._
diff --git a/docs/src/finding-navigating.md b/docs/src/finding-navigating.md
index 78bc6905c5..051c21262a 100644
--- a/docs/src/finding-navigating.md
+++ b/docs/src/finding-navigating.md
@@ -1,3 +1,8 @@
+---
+title: Finding and Navigating Code - Zed
+description: Navigate your codebase in Zed with file finder, project search, go to definition, symbol search, and the command palette.
+---
+
 # Finding & Navigating
 
 Zed provides several ways to move around your codebase quickly. Here's an overview of the main navigation tools.
diff --git a/docs/src/getting-started.md b/docs/src/getting-started.md
index 78fbdf7cd3..294801d326 100644
--- a/docs/src/getting-started.md
+++ b/docs/src/getting-started.md
@@ -1,3 +1,8 @@
+---
+title: Getting Started with Zed
+description: Get started with Zed, the fast open-source code editor. Essential commands, environment setup, and navigation basics.
+---
+
 # Getting Started
 
 Welcome to Zed! We are excited to have you. Zed is a powerful multiplayer code editor designed to stay out of your way and help you build what's next.
diff --git a/docs/src/globs.md b/docs/src/globs.md
index 14b7f91da2..94c866394b 100644
--- a/docs/src/globs.md
+++ b/docs/src/globs.md
@@ -1,3 +1,8 @@
+---
+title: Glob Patterns - Zed
+description: How glob patterns work in Zed for file matching, search filtering, and configuration. Syntax reference and examples.
+---
+
 # Globs
 
 Zed supports the use of [glob](<https://en.wikipedia.org/wiki/Glob_(programming)>) patterns that are the formal name for Unix shell-style path matching wildcards like `*.md` or `docs/src/**/*.md` supported by sh, bash, zsh, etc. A glob is similar but distinct from a [regex (regular expression)](https://en.wikipedia.org/wiki/Regular_expression). You may be In Zed these are commonly used when matching filenames.
diff --git a/docs/src/helix.md b/docs/src/helix.md
index 467a2fac7c..354e3a1ddc 100644
--- a/docs/src/helix.md
+++ b/docs/src/helix.md
@@ -1,3 +1,8 @@
+---
+title: Helix Mode - Zed
+description: Helix-style keybindings and modal editing in Zed. Selection-first editing built on top of Vim mode.
+---
+
 # Helix Mode
 
 _Work in progress! Not all Helix keybindings are implemented yet._
diff --git a/docs/src/installation.md b/docs/src/installation.md
index ffba532cd2..2c003da755 100644
--- a/docs/src/installation.md
+++ b/docs/src/installation.md
@@ -1,3 +1,8 @@
+---
+title: Install Zed - macOS, Linux, Windows
+description: Download and install Zed on macOS, Linux, or Windows. Includes Homebrew, direct download, and package manager options.
+---
+
 # Installing Zed
 
 ## Download Zed
diff --git a/docs/src/key-bindings.md b/docs/src/key-bindings.md
index 47826af610..45b7d29e48 100644
--- a/docs/src/key-bindings.md
+++ b/docs/src/key-bindings.md
@@ -1,3 +1,8 @@
+---
+title: Key Bindings and Shortcuts - Zed
+description: Customize Zed's keyboard shortcuts. Rebind actions, create key sequences, and set context-specific bindings.
+---
+
 # Key bindings
 
 Zed's key binding system is fully customizable. You can rebind any action, create key sequences, and define context-specific bindings.
diff --git a/docs/src/multibuffers.md b/docs/src/multibuffers.md
index b95e85ad89..5408c44597 100644
--- a/docs/src/multibuffers.md
+++ b/docs/src/multibuffers.md
@@ -1,3 +1,8 @@
+---
+title: Multibuffers - Edit Multiple Files at Once in Zed
+description: Edit multiple files simultaneously in Zed using multibuffers. Combine with multi-cursor for fast cross-file refactoring.
+---
+
 # Multibuffers
 
 One of the superpowers Zed gives you is the ability to edit multiple files simultaneously. When combined with multiple cursors, this makes wide-ranging refactors significantly faster.
diff --git a/docs/src/outline-panel.md b/docs/src/outline-panel.md
index bc743596d6..e5f1f911a4 100644
--- a/docs/src/outline-panel.md
+++ b/docs/src/outline-panel.md
@@ -1,3 +1,8 @@
+---
+title: Outline Panel - Zed
+description: Navigate code structure with Zed's outline panel. View symbols, jump to definitions, and browse file outlines.
+---
+
 # Outline Panel
 
 In addition to the modal outline (`cmd-shift-o`), Zed offers an outline panel. The outline panel can be deployed via `cmd-shift-b` (`outline panel: toggle focus` via the command palette), or by clicking the `Outline Panel` button in the status bar.
diff --git a/docs/src/remote-development.md b/docs/src/remote-development.md
index f05eb16d40..8124184dc9 100644
--- a/docs/src/remote-development.md
+++ b/docs/src/remote-development.md
@@ -1,3 +1,8 @@
+---
+title: Remote Development - Zed
+description: Edit code on remote servers with Zed. Local UI performance with remote language servers, terminals, and tasks over SSH.
+---
+
 # Remote Development
 
 Remote Development lets you edit code on a remote server while running Zed locally. The UI stays responsive because it runs on your machine, while language servers, tasks, and terminals run on the server.
diff --git a/docs/src/repl.md b/docs/src/repl.md
index 692093007c..7e8b590153 100644
--- a/docs/src/repl.md
+++ b/docs/src/repl.md
@@ -1,3 +1,8 @@
+---
+title: REPL - Jupyter Kernels in Zed
+description: Run code interactively in Zed with built-in Jupyter kernel support. Execute Python, TypeScript, R, and more inline.
+---
+
 # REPL
 
 ## Getting started
diff --git a/docs/src/running-testing.md b/docs/src/running-testing.md
index 249639a071..93ca354d3e 100644
--- a/docs/src/running-testing.md
+++ b/docs/src/running-testing.md
@@ -1,3 +1,8 @@
+---
+title: Running and Testing Code - Zed
+description: Run, test, and debug your code without leaving Zed. Tasks, REPL, and debugger integration.
+---
+
 # Running & Testing
 
 This section covers how to run, test, and debug your code without leaving Zed.
diff --git a/docs/src/semantic-tokens.md b/docs/src/semantic-tokens.md
index 5118f93023..ab30525c50 100644
--- a/docs/src/semantic-tokens.md
+++ b/docs/src/semantic-tokens.md
@@ -1,3 +1,8 @@
+---
+title: Semantic Tokens and Syntax Highlighting - Zed
+description: Enable and configure semantic token highlighting in Zed for richer, language-server-aware syntax coloring.
+---
+
 # Semantic Tokens
 
 Semantic tokens provide richer syntax highlighting by using information from language servers. Unlike tree-sitter highlighting, which is based purely on syntax, semantic tokens understand the meaning of your code—distinguishing between local variables and parameters, or between a class definition and a class reference.
diff --git a/docs/src/snippets.md b/docs/src/snippets.md
index e84210d0fa..b659269ba6 100644
--- a/docs/src/snippets.md
+++ b/docs/src/snippets.md
@@ -1,3 +1,8 @@
+---
+title: Snippets - Zed
+description: Create and use code snippets in Zed with tab stops, placeholders, variables, and language-scoped triggers.
+---
+
 # Snippets
 
 Use the {#action snippets::ConfigureSnippets} action to create a new snippets file or edit an existing snippets file for a specified [scope](#scopes).
diff --git a/docs/src/tasks.md b/docs/src/tasks.md
index 095f051699..ee2ce07601 100644
--- a/docs/src/tasks.md
+++ b/docs/src/tasks.md
@@ -1,3 +1,8 @@
+---
+title: Tasks - Run Commands in Zed
+description: Run and rerun shell commands from Zed with task definitions. Supports variables, templates, and language-specific tasks.
+---
+
 # Tasks
 
 Zed supports ways to spawn (and rerun) commands using its integrated [terminal](./terminal.md) to output the results. These commands can read a limited subset of Zed state (such as a path to the file currently being edited or selected text).
diff --git a/docs/src/terminal.md b/docs/src/terminal.md
index 6f6f7aac88..b6017c3720 100644
--- a/docs/src/terminal.md
+++ b/docs/src/terminal.md
@@ -1,3 +1,8 @@
+---
+title: Built-in Terminal - Zed
+description: Zed's integrated terminal with multiple instances, custom shells, and deep editor integration.
+---
+
 # Terminal
 
 Zed includes a built-in terminal emulator that supports multiple terminal instances, custom shells, and deep integration with the editor.
diff --git a/docs/src/themes.md b/docs/src/themes.md
index 615cd2c7b3..b121061f49 100644
--- a/docs/src/themes.md
+++ b/docs/src/themes.md
@@ -1,3 +1,8 @@
+---
+title: Themes - Zed
+description: Browse, install, and create themes for Zed. Includes built-in themes and community theme extensions.
+---
+
 # Themes
 
 Zed comes with a number of built-in themes, with more themes available as extensions.
diff --git a/docs/src/vim.md b/docs/src/vim.md
index 203faead79..4ce3f7f533 100644
--- a/docs/src/vim.md
+++ b/docs/src/vim.md
@@ -1,3 +1,8 @@
+---
+title: Vim Mode - Zed
+description: Full Vim emulation in Zed with motions, text objects, visual mode, macros, and Zed-specific extensions.
+---
+
 # Vim Mode
 
 Zed includes a Vim emulation layer. This page covers enabling and disabling vim mode, key bindings, Zed-specific features, and configuration options.