From 86a26499448209f465282dc06ca2a6bc91f7b460 Mon Sep 17 00:00:00 2001
From: Peter Tripp <peter@zed.dev>
Date: Wed, 17 Sep 2025 15:04:18 -0400
Subject: [PATCH] docs: Add whitespace_map (#38355)

Adds docs for settings introduced in:
- https://github.com/zed-industries/zed/pull/37704

Release Notes:

- N/A
---
 docs/src/configuring-zed.md      | 15 +++++++++++++++
 docs/src/visual-customization.md |  4 ++++
 2 files changed, 19 insertions(+)

diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 6c25d62e291f91f3faf4dc77e5a6dab3b8637ca8..58cde307662febbd99826b8b0954dddf4984cd9d 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -2626,6 +2626,7 @@ The following settings can be overridden for each specific language:
 - [`remove_trailing_whitespace_on_save`](#remove-trailing-whitespace-on-save)
 - [`show_edit_predictions`](#show-edit-predictions)
 - [`show_whitespaces`](#show-whitespaces)
+- [`whitespace_map`](#whitespace-map)
 - [`soft_wrap`](#soft-wrap)
 - [`tab_size`](#tab-size)
 - [`use_autoclose`](#use-autoclose)
@@ -3348,6 +3349,20 @@ Positive integer values
 3. `none`
 4. `boundary`
 
+## Whitespace Map
+
+- Description: Specify the characters used to render whitespace when show_whitespaces is enabled.
+- Setting: `whitespace_map`
+- Default:
+
+```json
+{
+  "whitespace_map": {
+    "space": "•",
+    "tab": "→"
+  },
+```
+
 ## Soft Wrap
 
 - Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
diff --git a/docs/src/visual-customization.md b/docs/src/visual-customization.md
index 150b701168f49980844ea37c223efe00b6dc06cc..55f2dfe9b4d40d46a640520a99952964712c640e 100644
--- a/docs/src/visual-customization.md
+++ b/docs/src/visual-customization.md
@@ -185,6 +185,10 @@ TBD: Centered layout related settings
 
   // Visually show tabs and spaces  (none, all, selection, boundary, trailing)
   "show_whitespaces": "selection",
+  "whitespace_map": { // Which characters to show when `show_whitespaces` enabled
+    "space": "•",
+    "tab": "→"
+  },
 
   "unnecessary_code_fade": 0.3, // How much to fade out unused code.