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.

Clarify markdown section in Jupyter users tutorial (#8092)

Trevor Manz97c1117bd4bd
diff --git a/marimo/_tutorials/for_jupyter_users.py b/marimo/_tutorials/for_jupyter_users.py
index 3c989b21a7..17eb06c565 100644
--- a/marimo/_tutorials/for_jupyter_users.py
+++ b/marimo/_tutorials/for_jupyter_users.py
@@ -216,7 +216,15 @@ def _(mo):
mo.md(rf"""
## Markdown
- marimo only has Python cells, but you can still write Markdown: `import marimo as mo` and use `mo.md` to write Markdown.
+ marimo notebooks are stored as pure Python, but you can still write Markdown:
+ `import marimo as mo` and use `mo.md`.
+
+ /// details | What about markdown & SQL "cells"?
+
+ You may notice marimo UI has markdown and SQL cells in the editor. These are
+ conveniences that use `mo.md` and `mo.sql` under the hood, with nicer
+ ergonomics for authoring.
+ ///
""")
return
diff --git a/tests/_convert/markdown/snapshots/marimo_for_jupyter_users.md.txt b/tests/_convert/markdown/snapshots/marimo_for_jupyter_users.md.txt
index 54e509c2ff..99b62f37c6 100644
--- a/tests/_convert/markdown/snapshots/marimo_for_jupyter_users.md.txt
+++ b/tests/_convert/markdown/snapshots/marimo_for_jupyter_users.md.txt
@@ -130,7 +130,15 @@ If you run into this error, here are your options:
<!---->
## Markdown
-marimo only has Python cells, but you can still write Markdown: `import marimo as mo` and use `mo.md` to write Markdown.
+marimo notebooks are stored as pure Python, but you can still write Markdown:
+`import marimo as mo` and use `mo.md`.
+
+/// details | What about markdown & SQL "cells"?
+
+You may notice marimo UI has markdown and SQL cells in the editor. These are
+conveniences that use `mo.md` and `mo.sql` under the hood, with nicer
+ergonomics for authoring.
+///
```python {.marimo}
mo.md(