Alerts

This preprocessor adds GitHub Flavored Markdown's Alerts (similar to Obsidian's Callouts) to the syntax.

Source code of the mdbook-alerts preprocessor.

Install

Download from releases or install manuall by running cargo install mdbook-alerts

Configuration

Add the following to book.toml:

[preprocessor.alerts]

Usage

Include lines similar to these:

 > [!NOTE]
 > Useful information that users should know, even when skimming content.

 > [!TIP]
 > Helpful advice for doing things better or more easily.

 > [!IMPORTANT]
 > Key information users need to know to achieve their goal.

 > [!WARNING]
 > Urgent info that needs immediate user attention to avoid problems.

 > [!CAUTION]
 > Advises about risks or negative outcomes of certain actions.

Result

You will see this in your book:

note

Useful information that users should know, even when skimming content.

tip

Helpful advice for doing things better or more easily.

important

Key information users need to know to achieve their goal.

warning

Urgent info that needs immediate user attention to avoid problems.

caution

Advises about risks or negative outcomes of certain actions.