Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

docs: admonition (#9903)

Akshay Agrawalc99b55eca375
diff --git a/docs/guides/outputs.md b/docs/guides/outputs.md
index b55d7aa43a..43f7568874 100644
--- a/docs/guides/outputs.md
+++ b/docs/guides/outputs.md
@@ -103,7 +103,7 @@ Here's some additional context.
#### Admonitions
-Highlight text using admonitions:
+Highlight text using *admonitions*:
```markdown
/// attention | This is important.
@@ -112,10 +112,16 @@ Pay attention to this text!
///
```
+An admonition, also known as an alert or a callout, is a Markdown extension
+for visually highlighting important information. In marimo, admonitions
+are displayed with special colors to convey significance.
+
/// marimo-embed-file
filepath: examples/markdown/admonitions.py
///
+For a programmatic alternative to admonitions, use [`mo.callout`][marimo.callout].
+
#### Emoji
Use `:emoji:` syntax to add emojis; for example, `:rocket:` creates 🚀.