Quick Start
This guide will help you get started with using marimo inside MkDocs quickly. We'll cover the basics of writing interactive Python code in your documentation.
Prerequisites
Before you begin, make sure you have:
- Installed the marimo plugin for MkDocs (see Installation)
- Added the plugin to your
mkdocs.yml
file
Writing Your First marimo Cell
marimo cells are special Python code blocks that can be executed interactively. Here's how to create one:
By default, marimo executes the code and displays the result. On page load, marimo re-hydrates the cell state and executes the code again using WebAssembly.
Creating Interactive Elements
Let's create a more interesting example with user input:
```python {marimo}
import marimo as mo
name = mo.ui.text(placeholder="Enter your name", debounce=False)
name
```
```python {marimo}
mo.md(f"Hello, **{name.value or '__'}**!")
```
This produces:
Working with Data
marimo integrates seamlessly with data analysis libraries. Here's an example using pandas:
```python {marimo}
import marimo as mo
import pandas as pd
data = pd.read_csv("https://huggingface.co/datasets/scikit-learn/Fish/resolve/main/Fish.csv")
mo.ui.table(data, selection=None)
```
Leveraging Reactivity
marimo's reactivity allows cells to update automatically when inputs or code changes. Here's a visualization example: