Skip to content

Using Alerts in GitHub Flavored Markdown (GFM) for Enhanced Documentation

I've recently discovered that GFM (also Obsidian and MkDocs) supports alerts which are a Markdown extension that you can use to emphasize important information.

> [!NOTE]
> Test note

GFM supports five types of alerts:

  • NOTE
  • TIP
  • IMPORTANT
  • WARNING
  • CAUTION

Note

Useful information that users should know.

Tip

Helpful advice that helps user to do things better or more easily.

Important

Key information users need to know to achieve their goal.

Warning

Information that needs user attention to avoid problems.

Caution

Advises about risks or negative outcomes of certain actions.