From ce555ae9761c1bf8680e8da3a257cab5f72c51f6 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 21 Jul 2025 10:52:40 -0700
Subject: [PATCH 1/2] clarify diff setup

---
 code.mdx | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/code.mdx b/code.mdx
index 474cad172..439dea26b 100644
--- a/code.mdx
+++ b/code.mdx
@@ -302,7 +302,19 @@ sayHello();
 
 ### Diff
 
-Add single line comments with `[!code ++]` and `[!code --]` to mark added and removed lines. You can also mark multiple lines with a single comment, such as `[!code ++:3]` or `[!code --:5]`.
+Show a visual diff of added or removed lines in your code blocks. Added lines are highlighted in green and removed lines are highlighted in red.
+
+To create diffs, add these special comments at the end of lines in your code block:
+
+- `// [!code ++]`: Mark a line as added (green highlight).
+- `// [!code --]`: Mark a line as removed (red highlight).
+
+For multiple consecutive lines, specify the number of lines after a colon:
+
+- `// [!code ++:3]`: Mark the current line plus the next two lines as added.
+- `// [!code --:5]`: Mark the current line plus the next four lines as removed.
+
+The comment syntax must match your programming language (for example, `//` for JavaScript or `#` for Python).
 
 ```js Diff Example icon="code" lines
 const greeting = "Hello, World!"; // [!code ++]

From ca1ff8ea5957b85b782c85356bd93d0312206082 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 21 Jul 2025 10:53:09 -0700
Subject: [PATCH 2/2] update example to `text`

---
 code.mdx | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/code.mdx b/code.mdx
index 439dea26b..8be187ba9 100644
--- a/code.mdx
+++ b/code.mdx
@@ -325,12 +325,12 @@ function sayHello() {
 sayHello();
 ```
 
-````mdx
+````text
 ```js Diff Example icon="code" lines
-const greeting = "Hello, World!"; // [\!code ++]
+const greeting = "Hello, World!"; // [!code ++]
 function sayHello() {
-  console.log("Hello, World!"); // [\!code --]
-  console.log(greeting); // [\!code ++]
+  console.log("Hello, World!"); // [!code --]
+  console.log(greeting); // [!code ++]
 }
 sayHello();
 ```