help: Add a dedicated page on how to format tables.

help/format-your-message-using-markdown.md

@@ -106,18 +106,9 @@ whenever you need a reminder of the formatting syntax below.
 
 ## Tables
 
-The initial pipes (`|`) are optional if every entry in the first column is non-empty.
+{!tables-intro.md!}
-The header separators (`---`) must be at least three dashes long.
 
-```
+{!tables-examples.md!}
-|| yes | no | maybe
-|---|---|:---:|------:
-| A | left-aligned | centered | right-aligned
-| B |     extra      spaces      |  are |  ok
-| C | **bold** *italic* ~~strikethrough~~  :smile:  ||
-```
-
-![Markdown table](/static/images/help/markdown-table.png)
 
 ## To-do lists
 

help/include/sidebar_index.md

@@ -66,6 +66,7 @@
 * [Add GIFs in your message](/help/animated-gifs-from-giphy)
 * [Text emphasis](/help/text-emphasis)
 * [Bulleted and numbered lists](/help/bulleted-and-numbered-lists)
+* [Tables](/help/tables)
 * [Code blocks](/help/code-blocks)
 * [LaTeX](/help/latex)
 * [Spoilers](/help/spoilers)

help/include/tables-examples.md

@@ -0,0 +1,19 @@
+### What you type
+
+```
+|| yes | no | maybe
+|---|---|:---:|------:
+| A | left-aligned | centered | right-aligned
+| B |     extra      spaces      |  are |  ok
+| C | **bold** *italic* ~~strikethrough~~  :smile:  ||
+```
+
+!!! tip ""
+
+    The initial pipes (`|`) are optional if every entry in the first column is
+    non-empty.
+    The header separators (`---`) must be at least three dashes long.
+
+### What it looks like
+
+![Markdown table](/static/images/help/markdown-table.png)

help/include/tables-intro.md

@@ -0,0 +1 @@
+Zulip supports Markdown formatting for tables.

help/tables.md

@@ -0,0 +1,13 @@
+# Tables
+
+{!tables-intro.md!}
+
+## Examples
+
+{!tables-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)