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.