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

help/format-a-quote.md

@@ -0,0 +1,12 @@
+# Format a quote
+
+{!quotes-intro.md!}
+
+## Examples
+
+{!quotes-examples.md!}
+
+## Related articles
+
+* [Message formatting](/help/format-your-message-using-markdown)
+* [Quote and reply](/help/quote-and-reply)

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

@@ -65,20 +65,14 @@ whenever you need a reminder of the formatting syntax below.
 
 ## Quotes
 
-~~~
+{!quotes-intro.md!}
-> a multi-line
-quote on two lines
 
-normal text
+{!quotes-examples.md!}
 
-```quote
+!!! tip ""
-A multi-paragraph
 
-quote in two paragraphs
+    There is a handy option to [quote and reply](/help/quote-and-reply) to a
-```
+    message in Zulip.
-~~~
-
-![Markdown quotes](/static/images/help/markdown-quotes.png)
 
 ## Spoilers
 

help/include/quotes-examples.md

@@ -0,0 +1,18 @@
+### What you type
+
+~~~
+> a multi-line
+quote on two lines
+
+normal text
+
+```quote
+A multi-paragraph
+
+quote in two paragraphs
+```
+~~~
+
+### What it looks like
+
+![Markdown quotes](/static/images/help/markdown-quotes.png)

help/include/quotes-intro.md

@@ -0,0 +1,2 @@
+You can format quotes one line at a time, or create a block of text that will be
+formatted as a quote.

help/include/sidebar_index.md

@@ -58,6 +58,7 @@
 ## Writing messages
 * [Message formatting](/help/format-your-message-using-markdown)
 * [Mention a user or group](/help/mention-a-user-or-group)
+* [Format a quote](/help/format-a-quote)
 * [Quote and reply](/help/quote-and-reply)
 * [Emoji and emoticons](/help/emoji-and-emoticons)
 * [Insert a link](/help/insert-a-link)

help/quote-and-reply.md

@@ -10,7 +10,7 @@ to avoid unnecessarily mentioning someone twice.
 
 !!! tip ""
 
-    You can use [quote blocks](/help/format-your-message-using-markdown#quotes)
+    You can use [quote blocks](/help/format-a-quote)
     when quoting emails or other non-Zulip content.
 
 ## Quote and reply
@@ -54,7 +54,7 @@ to avoid unnecessarily mentioning someone twice.
 
 ## Related articles
 
-* [Format your message using markdown](/help/format-your-message-using-markdown)
+* [Format a quote](/help/format-a-quote)
 * [Link to a message or conversation][link-to-message]
 * [Mention a user or group](/help/mention-a-user-or-group)