[Feature Request] Admonitions / Callouts

[kiryph]

Many documentation systems have introduced special text blocks to draw the readers attention to critical information, called sometimes alerts, admonitions or callouts.

Examples:

• GitHub Docs, https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts

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.

• AsciiDoc, https://docs.asciidoctor.org/asciidoc/latest/blocks/admonitions/
• MyST, https://myst-parser.readthedocs.io/en/latest/syntax/admonitions.html
• Obsidian Notes, https://help.obsidian.md/Editing+and+formatting/Callouts
• Doxygen Github Alerts, https://www.doxygen.nl/manual/markdown.html#mddox_github_alerts
• LaTeX pkg awesomebox, https://ctan.org/pkg/awesomebox
  ...

Can something similar be added to GAPDoc?