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: add entry on `jupyter-book-marimo` plugin (#9802)

Péter Gyarmati21de75b6017f
diff --git a/docs/guides/exporting/index.md b/docs/guides/exporting/index.md
index e893d52e96..4497d6f2ef 100644
--- a/docs/guides/exporting/index.md
+++ b/docs/guides/exporting/index.md
@@ -22,3 +22,10 @@ For sharing interactive notebooks on the public web, consider using [molab](../m
| [Markdown](markdown.md) | `marimo export md` | Markdown with code blocks |
| [WebAssembly HTML](webassembly_html.md) | `marimo export html-wasm` | Self-contained, interactive HTML powered by WebAssembly |
| [Session snapshot](sessions.md) | `marimo export session` | Serialized session snapshot (JSON) |
+
+## Publishing plugins
+
+| Tool | Description |
+|------|-------------|
+| [Quarto](quarto.md) | Publish marimo Markdown with the Quarto extension |
+| [Jupyter Book](jupyter_book.md) | Embed marimo cells in Jupyter Book |
diff --git a/docs/guides/exporting/jupyter_book.md b/docs/guides/exporting/jupyter_book.md
new file mode 100644
index 0000000000..b5e30c0f29
--- /dev/null
+++ b/docs/guides/exporting/jupyter_book.md
@@ -0,0 +1,23 @@
+# Publishing with Jupyter Book
+
+[Jupyter Book](https://jupyterbook.org/) is an open-source publishing system for
+computational books, documentation, and course materials built from MyST Markdown
+and notebooks.
+
+marimo's [`jupyter-book-marimo`](https://github.com/marimo-team/jupyter-book-marimo)
+plugin lets Jupyter Book render MyST-native `{marimo}` directives as hydrated
+marimo islands. Use it when you want marimo cells and outputs inside a Jupyter
+Book site.
+
+Write a marimo cell with an explicit language:
+
+````markdown
+```{marimo} python
+import marimo as mo
+
+mo.md("hello")
+```
+````
+
+For installation, page-level configuration, and supported directive options, see
+the [jupyter-book-marimo docs](https://marimo-team.github.io/jupyter-book-marimo/).
diff --git a/mkdocs.yml b/mkdocs.yml
index b8804e6d2e..3b8a39dc88 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -142,6 +142,7 @@ nav:
- PDF: guides/exporting/pdf.md
- Jupyter notebook: guides/exporting/jupyter_notebook.md
- Quarto: guides/exporting/quarto.md
+ - Jupyter Book: guides/exporting/jupyter_book.md
- Python script: guides/exporting/python_script.md
- Markdown: guides/exporting/markdown.md
- WebAssembly HTML: guides/exporting/webassembly_html.md