docs(website): change recommended syntax for math equations (#11784)

Author: slorber

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>
 

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>
 

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>
 

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>
 

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>
 

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>
 

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>
 

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>
 

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>
 

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>