From b8dfc31fcd29585328655a5d2b72a215273cb4bd Mon Sep 17 00:00:00 2001
From: Kunall Banerjee <hey@kimchiii.space>
Date: Fri, 16 Jan 2026 20:16:47 -0500
Subject: [PATCH] docs: Add documentation for `text_rendering_mode` (#46358)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

We added support for it in
https://github.com/zed-industries/zed/pull/45423. It’s already in
preview, but not yet in stable. So I’m going to keep this in my drafts
till then.

Release Notes:

- N/A
---
 docs/src/configuring-zed.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md
index 7d6432c2d7d011d338d46e14542f1313155b61fe..5e6d608de2ee718b4f871df112563d46432546ae 100644
--- a/docs/src/configuring-zed.md
+++ b/docs/src/configuring-zed.md
@@ -4317,6 +4317,38 @@ Example command to set the title: `echo -e "\e]2;New Title\007";`
 },
 ```
 
+## Text Rendering Mode
+
+- Description: The text rendering mode to use.
+- Setting: `text_rendering_mode`
+- Default: `platform_default`
+
+**Options**
+
+1. Use grayscale text rendering.
+
+```json [settings]
+{
+  "text_rendering_mode": "grayscale"
+}
+```
+
+2. Use subpixel (ClearType-style) text rendering.
+
+```json [settings]
+{
+  "text_rendering_mode": "subpixel"
+}
+```
+
+3. Use platform default behavior.
+
+```json [settings]
+{
+  "text_rendering_mode": "platform_default"
+}
+```
+
 ## Theme
 
 - Description: The theme setting can be specified in two forms - either as the name of a theme or as an object containing the `mode`, `dark`, and `light` themes for the Zed UI.