help: Add a dedicated page on how to format paragraphs and sections.

This commit is contained in:
David Rosa 2023-03-14 21:28:01 -06:00 committed by Tim Abbott
parent d127a6d317
commit bfed711f54
5 changed files with 40 additions and 16 deletions

View File

@ -27,7 +27,7 @@ whenever you need a reminder of the formatting syntax below.
* [Global times](#global-times) * [Global times](#global-times)
* [Tables](#tables) * [Tables](#tables)
* [Collaborative to-do lists](#collaborative-to-do-lists) * [Collaborative to-do lists](#collaborative-to-do-lists)
* [Paragraphs and lines](#paragraphs-and-lines) * [Paragraph and section formatting](#paragraph-and-section-formatting)
## Text emphasis ## Text emphasis
@ -116,23 +116,11 @@ whenever you need a reminder of the formatting syntax below.
{!to-do-lists-examples.md!} {!to-do-lists-examples.md!}
## Paragraphs and lines ## Paragraph and section formatting
``` {!paragraphs-and-sections-intro.md!}
One blank space for a new paragraph
New line, same paragraph
New paragraph {!paragraphs-and-sections-examples.md!}
---, ***, or ___ for a horizontal line
Over the line
---
Under the line
```
![Markdown paragraph](/static/images/help/markdown-paragraph.png)
## Message formatting reference ## Message formatting reference

View File

@ -0,0 +1,19 @@
### What you type
```
One blank space for a new paragraph
New line, same paragraph
New paragraph
---, ***, or ___ for a horizontal line
Over the line
---
Under the line
```
### What it looks like
![Markdown paragraph](/static/images/help/markdown-paragraph.png)

View File

@ -0,0 +1,3 @@
Zulip supports Markdown formatting for paragraphs and visual section breaks,
which you can use to control the layout of your text and to visually separate
different sections of content.

View File

@ -65,6 +65,7 @@
* [Share and upload files](/help/share-and-upload-files) * [Share and upload files](/help/share-and-upload-files)
* [Add GIFs in your message](/help/animated-gifs-from-giphy) * [Add GIFs in your message](/help/animated-gifs-from-giphy)
* [Text emphasis](/help/text-emphasis) * [Text emphasis](/help/text-emphasis)
* [Paragraph and section formatting](/help/paragraph-and-section-formatting)
* [Bulleted and numbered lists](/help/bulleted-and-numbered-lists) * [Bulleted and numbered lists](/help/bulleted-and-numbered-lists)
* [Tables](/help/tables) * [Tables](/help/tables)
* [Code blocks](/help/code-blocks) * [Code blocks](/help/code-blocks)

View File

@ -0,0 +1,13 @@
# Paragraph and section formatting
{!paragraphs-and-sections-intro.md!}
## Examples
{!paragraphs-and-sections-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)