zulip/help/format-your-message-using-m...

4.0 KiB

Message formatting

Zulip uses Markdown to allow you to easily format your messages. Even if you've never heard of Markdown, you are probably familiar with basic Markdown formatting, such as using * at the start of a line in a bulleted list, or around text to indicate emphasis.

This page provides an overview of all the formatting available in Zulip. There is a convenient message formatting reference in the Zulip app that you can use whenever you need a reminder of the formatting syntax below.

Text emphasis

{!emphasis.md!}

!!! tip "" You can also use buttons or keyboard shortcuts (Ctrl + B or Ctrl + I) to make text bold or italic. Learn more.

{!format-lists.md!}

{!links-intro.md!}

{!links-examples.md!}

!!! tip "" You can also use a button or a keyboard shortcut (Ctrl + Shift + L) to insert a link. Learn more.

Code blocks

{!code-blocks-intro.md!}

{!code-blocks-examples.md!}

LaTeX

{!latex-intro.md!}

{!latex-examples.md!}

Quotes

{!quotes-intro.md!}

{!quotes-examples.md!}

!!! tip ""

There is a handy option to [quote and reply](/help/quote-and-reply) to a
message in Zulip.

Spoilers

{!spoilers-intro.md!}

{!spoilers-examples.md!}

Emoji and emoticons

{!emoji-and-emoticons-intro.md!}

{!emoji-and-emoticons-examples.md!}

Mention a user or group

{!mentions-intro.md!}

{!mentions-examples.md!}

/me action messages

{!me-action-messages-intro.md!}

{!me-action-messages-examples.md!}

Global times

{!global-times-intro.md!}

{!global-times-examples.md!}

Tables

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.

|| yes | no | maybe
|---|---|:---:|------:
| A | left-aligned | centered | right-aligned
| B |     extra      spaces      |  are |  ok
| C | **bold** *italic* ~~strikethrough~~  :smile:  ||

Markdown table

To-do lists

Sending a message with the text /todo creates a simple collaborative to-do list. Any user who can access the message can add tasks by entering the task's title and description and clicking "Add task". Once created, task titles and descriptions cannot be edited.

Tasks can be marked (and unmarked) as completed by clicking the checkboxes on the left.

Markdown todo-lists

Paragraphs and lines

One blank space for a new paragraph
New line, same paragraph

New paragraph

---, ***, or ___ for a horizontal line
Over the line

---

Under the line

Markdown paragraph

Message formatting reference

A summary of the formatting syntax above is available in the Zulip app.

{start_tabs}

{!start-composing.md!}

  1. Click the question mark () icon at the bottom of the compose box.

{end_tabs}