From 56c03de9270f42d94d1ff883d647b009b3ae46e5 Mon Sep 17 00:00:00 2001
From: David Rosa <rosatamsen@gmail.com>
Date: Thu, 9 Mar 2023 22:36:53 -0700
Subject: [PATCH] help: Add a dedicated page on how to format LaTeX.

---
 help/format-your-message-using-markdown.md | 15 ++-------------
 help/include/latex-examples.md             | 14 ++++++++++++++
 help/include/latex-intro.md                |  4 ++++
 help/include/sidebar_index.md              |  1 +
 help/latex.md                              | 13 +++++++++++++
 5 files changed, 34 insertions(+), 13 deletions(-)
 create mode 100644 help/include/latex-examples.md
 create mode 100644 help/include/latex-intro.md
 create mode 100644 help/latex.md

diff --git a/help/format-your-message-using-markdown.md b/help/format-your-message-using-markdown.md
index f16b0d7a16..4f3f278219 100644
--- a/help/format-your-message-using-markdown.md
+++ b/help/format-your-message-using-markdown.md
@@ -58,21 +58,10 @@ whenever you need a reminder of the formatting syntax below.
 {!code-blocks-examples.md!}
 
 ## LaTeX
-~~~
-Inline: $$O(n^2)$$
 
-Displayed:
-``` math
-\int_a^b f(t)\, dt = F(b) - F(a)
-```
-~~~
+{!latex-intro.md!}
 
-![Markdown LaTeX](/static/images/help/markdown-latex.png)
-
-Zulip's LaTeX rendering is powered by [KaTeX](https://katex.org).
-Their [support table](https://katex.org/docs/support_table.html) is a
-helpful resource for checking what's supported or how to express
-something.
+{!latex-examples.md!}
 
 ## Quotes
 
diff --git a/help/include/latex-examples.md b/help/include/latex-examples.md
new file mode 100644
index 0000000000..6bddbdf3bc
--- /dev/null
+++ b/help/include/latex-examples.md
@@ -0,0 +1,14 @@
+### What you type
+
+~~~
+Inline: $$O(n^2)$$
+
+Displayed:
+``` math
+\int_a^b f(t)\, dt = F(b) - F(a)
+```
+~~~
+
+### What it looks like
+
+![Markdown LaTeX](/static/images/help/markdown-latex.png)
diff --git a/help/include/latex-intro.md b/help/include/latex-intro.md
new file mode 100644
index 0000000000..7cfe0dfa7b
--- /dev/null
+++ b/help/include/latex-intro.md
@@ -0,0 +1,4 @@
+Zulip supports math typesetting powered by [KaTeX](https://katex.org).
+Their [support table](https://katex.org/docs/support_table.html) is a
+helpful resource for checking what's supported or how to express
+something.
diff --git a/help/include/sidebar_index.md b/help/include/sidebar_index.md
index c4669f8fee..dc714b947c 100644
--- a/help/include/sidebar_index.md
+++ b/help/include/sidebar_index.md
@@ -66,6 +66,7 @@
 * [Text emphasis](/help/text-emphasis)
 * [Bulleted and numbered lists](/help/bulleted-and-numbered-lists)
 * [Code blocks](/help/code-blocks)
+* [LaTeX](/help/latex)
 * [Create a poll](/help/create-a-poll)
 * [Start a video call](/help/start-a-call)
 
diff --git a/help/latex.md b/help/latex.md
new file mode 100644
index 0000000000..791b7d357e
--- /dev/null
+++ b/help/latex.md
@@ -0,0 +1,13 @@
+# LaTeX
+
+{!latex-intro.md!}
+
+## Examples
+
+{!latex-examples.md!}
+
+## Related articles
+
+* [Message formatting](/help/format-your-message-using-markdown)
+* [Preview messages before sending](/help/preview-your-message-before-sending)
+* [Resize the compose box](/help/resize-the-compose-box)