diff --git a/docs/src/completions.md b/docs/src/completions.md
index 09019e3fae..1b28302749 100644
--- a/docs/src/completions.md
+++ b/docs/src/completions.md
@@ -40,6 +40,21 @@ But, if you haven't come across the banner, start using Zed's Edit Prediction by
 },
 ```
 
+### Switching modes
+
+Zed's Edit Prediction comes with two different display modes:
+
+1. `eager` (default): predictions are displayed inline as long as it doesn't conflict with language server completions
+2. `subtle`: predictions only appear inline when holding a modifier key (`alt` by default)
+
+Toggle between them via the `mode` key:
+
+```json
+"edit_predictions": {
+  "mode": "eager" | "subtle"
+},
+```
+
 ### Conflict With Other `tab` Actions {#edit-predictions-conflict}
 
 By default, when `tab` would normally perform a different action, Zed requires a modifier key to accept predictions:
diff --git a/docs/theme/css/general.css b/docs/theme/css/general.css
index b4ef43518c..4f8331bd6c 100644
--- a/docs/theme/css/general.css
+++ b/docs/theme/css/general.css
@@ -169,7 +169,14 @@ h6:target::before {
 }
 .content ol {
   line-height: 1.8;
-  padding-left: 1.8em;
+
+  ::marker {
+    font-size: 1.4rem;
+  }
+
+  li {
+    padding-left: 0;
+  }
 }
 .content ul {
   line-height: 1.8;