diff --git a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
index 0fd9543d8ef0..ad9f4e5a4f33 100644
--- a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
@@ -35,7 +35,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -45,9 +53,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-2.x/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.x/guides/markdown-features/markdown-features-math-equations.mdx
index cb218c280cc4..74141aa9be86 100644
--- a/website/versioned_docs/version-2.x/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.x/guides/markdown-features/markdown-features-math-equations.mdx
@@ -31,9 +31,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 </BrowserWindow>
 
-### Blocks {#blocks}
+For equation block or display mode, use <code>```math</code> fenced code blocks.
 
-For equation block or display mode, use line breaks and `$$`:
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +49,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.0.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.0.1/guides/markdown-features/markdown-features-math-equations.mdx
index efed943a5f89..04592e753881 100644
--- a/website/versioned_docs/version-3.0.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.0.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.1.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.1.1/guides/markdown-features/markdown-features-math-equations.mdx
index efed943a5f89..04592e753881 100644
--- a/website/versioned_docs/version-3.1.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.1.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.2.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.2.1/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.2.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.2.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.3.2/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.3.2/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.3.2/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.3.2/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.4.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.4.0/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.4.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.4.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.5.2/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.5.2/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.5.2/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.5.2/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx
index 178ef2fd9a3e..838e6b467a3d 100644
--- a/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -33,7 +33,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -43,9 +51,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.8.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.8.1/guides/markdown-features/markdown-features-math-equations.mdx
index 0fd9543d8ef0..ad9f4e5a4f33 100644
--- a/website/versioned_docs/version-3.8.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.8.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -35,7 +35,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -45,9 +53,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>
 
diff --git a/website/versioned_docs/version-3.9.2/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.9.2/guides/markdown-features/markdown-features-math-equations.mdx
index 0fd9543d8ef0..ad9f4e5a4f33 100644
--- a/website/versioned_docs/version-3.9.2/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.9.2/guides/markdown-features/markdown-features-math-equations.mdx
@@ -35,7 +35,15 @@ Let $f\colon[a,b] \to \R$ be Riemann integrable. Let $F\colon[a,b]\to\R$ be $F(x
 
 ### Blocks {#blocks}
 
-For equation block or display mode, use line breaks and `$$`:
+For equation block or display mode, use <code>```math</code> fenced code blocks.
+
+````latex
+```math
+I = \int_0^{2\pi} \sin(x)\,dx
+```
+````
+
+You can also use line breaks and `$$`, although this syntax relies on a [Markdown syntax extension](https://github.com/micromark/micromark-extension-math) and is less portable:
 
 ```latex
 $$
@@ -45,9 +53,9 @@ $$
 
 <BrowserWindow>
 
-$$
+```math
 I = \int_0^{2\pi} \sin(x)\,dx
-$$
+```
 
 </BrowserWindow>