Using Callout Blocks

Callouts highlight a short note that readers should notice while following your article. Choose Info for a useful tip, Warning for a caution or check, and Danger for a serious consequence such as permanent deletion.

Callout Types

The Visual editor displays the three types with different colors. The examples below show practical messages rather than placeholder text.

Info, Warning, and Danger callouts in the Visual editor. Public styling can depend on your help center theme.

Info Callouts

Use Info for a helpful detail that makes the task easier. For example: “Use the search box to find an article by title.”

> [!info]
> Use the search box to find an article by title.

Warning Callouts

Use Warning for a check or caution the reader should consider before continuing. For example: “Check the article preview before publishing your changes.”

> [!warning]
> Check the article preview before publishing your changes.

Danger Callouts

Use Danger when the consequence is serious or cannot easily be reversed. State both the consequence and what the reader should do.

> [!danger]
> Deleting an article is permanent. Keep a copy of anything you need.

Using Callouts in Visual Mode

1. Open an article from Help Center > Articles and choose Visual above the editor.
2. Place the cursor where you want to add the callout.
3. Choose one of the three separate toolbar buttons: Info Callout, Warning Callout, or Danger Callout. They sit between the code-block and table controls.
4. Click inside the new block and type a short, specific message.
5. Save your changes and check the result in the article preview.

You do not need to open a separate callout-type menu: each type has its own toolbar button.

Using Callouts in Markdown Mode

Choose Markdown, then add the marker and message as a blockquote. Put the type marker on its own line and start each message line with >.

Leave a blank line before and after the callout to separate it from the surrounding text.

Each callout starts with its type marker, followed by the message on the next line.

Switch to Visual to check that the markers have become separate callout blocks. If a marker appears as ordinary text, compare its spelling, brackets, and leading > with the examples above.

Best Practices

• Keep each callout focused on one point. One or two sentences is usually enough.
• Use the mildest type that fits the message; reserve Danger for serious consequences.
• Put a warning before the action it warns about, so the reader sees it in time.
• Place helpful tips next to the step they clarify.
• Avoid repeating the same message in both the instructions and a callout.
• Use callouts sparingly so that important messages stand out.

For the rest of the formatting controls, see Markdown and Visual Editor Guide.