This plugin allows you to embed interactive marimo notebooks in your MkDocs documentation.

# pip
pip install mkdocs-marimo
# uv
uv pip install mkdocs-marimo
# pixi
pixi add mkdocs-marimo

Create reactive and interactive Python blocks in your markdown files using marimo.

This uses code fences to embed marimo components as marimo islands.

```python {marimo}
import marimo as mo
name = mo.ui.text(placeholder="Enter your name")
name
```
```python {marimo}
mo.md(f"Hello, **{name.value or '__'}**!")
```

For an easy way to embed marimo notebooks or applications, we recommend embedding the marimo playground. This feature uses pymdownx.blocks to embed marimo notebooks in your MkDocs documentation, creating iframes that render the marimo playground.

/// marimo-embed
    height: 400px
    mode: run
```python
@app.cell
def __():
    import matplotlib.pyplot as plt
    import numpy as np
    x = np.linspace(0, 10, 100)
    y = np.sin(x)
    plt.figure(figsize=(8, 4))
    plt.plot(x, y)
    plt.title('Sine Wave')
    plt.xlabel('x')
    plt.ylabel('sin(x)')
    plt.grid(True)
    plt.gca()
    return
```
///

Available options for marimo-embed:

• height: Named sizes (small, medium, large, xlarge, xxlarge) or custom pixel values (e.g. 500px) (default: medium)
• mode: read, edit (default: read)
• app_width: wide, full, compact (default: wide)

You can also embed marimo files directly:

/// marimo-embed-file
    filepath: path/to/your/file.py
    height: 400px
    mode: read
    show_source: true
///

Additional options for marimo-embed-file:

• filepath: path to the marimo file to embed (required)
• show_source: true, false (default: true) - whether to show the source code below the embed

Checkout the documentation for more examples.

Feel free to ask questions, enhancements and to contribute to this project!

See CONTRIBUTING.md for more details.

• Repo template from mkdocs-static-i18n