Marimo

What's Changed

Version 0.6.0 includes two big new features — first-class markdown support and token-authentication — and small quality of life improvements.

Highlights

**marimo ❤️ markdown**: `marimo edit nb.md`. marimo now supports markdown as a first-class file format. This means that if you're working on notebook that's heavy on text, you can write your notebook in markdown using an editor of your choice (VSCode, vim — anything you like!). Save it as `nb.md`, then fire up the marimo editor to interact with it — `marimo edit nb.md` — or run it as an app with `marimo run nb.md`.

When working with markdown, create a notebook cell using a special fenced code block that starts with `{python}` (note the braces!).

`md
{python}
import matplotlib.pyplot as plt
plt.plot([1, 2, 3, 4])

`

Here's a full example:

`md
Hello, world!

This is a markdown powered notebook.

{python}
import random
random.randint(0, 1000)


{python, hide_code=true}
import marimo as mo

`

The markdown file format is not meant as a replacement for the Python one, but it gives you the flexibility to choose the format that's best for your workflow. You can convert markdown notebooks to Python with


marimo convert nb.md > nb.py


and export Python to markdown with


marimo convert nb.py > nb.md


`marimo export notebook.md > notebook.py`

Check out [our tutorial](https://github.com/marimo-team/marimo/blob/main/marimo/_tutorials/markdown_format.md) to learn more.

_Huge shout out to dmadisetti for contributing the markdown support! 💪🎉_

**Token-based authentication 🔑**. marimo now runs with token-based authentication by default — this makes sure that only trusted parties can access the marimo server. Most users won't notice changes to their workflow. To learn more, check out [the docs](https://docs.marimo.io/guides/authentication.html).

**Export as `ipynb` 📝**. Export marimo notebooks as Jupyter notebook files with `marimo export ipynb nb.py -o nb.ipynb`.

**Split cell hotkey ⌨️**: Split cells with our new hotkey: `Ctrl/Cmd-Shift-'`.

Breaking changes

`mo.hstack` and `mo.vstack` now require you to use keyword args (except for the list of items).


New Contributors

Welcome to the marimo family!

* robmck1995 made their first contribution in https://github.com/marimo-team/marimo/pull/1381
* hattajr made their first contribution in https://github.com/marimo-team/marimo/pull/1387
* maks-ivanov made their first contribution in https://github.com/marimo-team/marimo/pull/1373

Full changelog

* fix: mo.lazy rendering by mscolnick in https://github.com/marimo-team/marimo/pull/1355
* fix: cloning of forms in arrays/dicts by akshayka in https://github.com/marimo-team/marimo/pull/1357
* fix: isolate modules in module watcher by akshayka in https://github.com/marimo-team/marimo/pull/1358
* feat: basic-auth support and minimal login page by mscolnick in https://github.com/marimo-team/marimo/pull/1363
* fix: readme images when displayed off github by mscolnick in https://github.com/marimo-team/marimo/pull/1366
* fix: scroll to variable by mscolnick in https://github.com/marimo-team/marimo/pull/1365
* fix: circular dep in wasm controller by mscolnick in https://github.com/marimo-team/marimo/pull/1369
* improvement: wasm startup perf by mscolnick in https://github.com/marimo-team/marimo/pull/1371
* improvement: seperate worker for saving by mscolnick in https://github.com/marimo-team/marimo/pull/1375
* feat: marimo export ipynb by akshayka in https://github.com/marimo-team/marimo/pull/1367
* Merge SetUIElementRequests on the backend by akshayka in https://github.com/marimo-team/marimo/pull/1374
* fix: respect auto-instantiate while in wasm by mscolnick in https://github.com/marimo-team/marimo/pull/1378
* fix: race-condition when connecting to websocket sometimes by mscolnick in https://github.com/marimo-team/marimo/pull/1377
* refactor: lazy-load vega plugins by mscolnick in https://github.com/marimo-team/marimo/pull/1376
* feat: Hotkey for splitting cells by robmck1995 in https://github.com/marimo-team/marimo/pull/1381
* Update editor_features.md by hattajr in https://github.com/marimo-team/marimo/pull/1387
* feat: marimo edit/run markdown.md by dmadisetti in https://github.com/marimo-team/marimo/pull/1332
* Skip disabled cells in script by maks-ivanov in https://github.com/marimo-team/marimo/pull/1373
* chore: skip test_run_disabled_cells for windows by mscolnick in https://github.com/marimo-team/marimo/pull/1390
* chore: add pre-commit, migrate to biomejs by mscolnick in https://github.com/marimo-team/marimo/pull/1389
* improvement: enable markdown support in the fe by default by mscolnick in https://github.com/marimo-team/marimo/pull/1391
* improvement: add footer to sidebar and disbale some Html fluid apis (callout, batch) by mscolnick in https://github.com/marimo-team/marimo/pull/1392
* fix: enable rpcs unnamed UI elems by akshayka in https://github.com/marimo-team/marimo/pull/1393
* small playwright fix by akshayka in https://github.com/marimo-team/marimo/pull/1394
* fix: cleanup of UIElements by akshayka in https://github.com/marimo-team/marimo/pull/1395
* fix tutorial: hstack by akshayka in https://github.com/marimo-team/marimo/pull/1399
* 0.6.0 by akshayka in https://github.com/marimo-team/marimo/pull/1400


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.5.2...0.6.0

Highlights

* **`mo.sidebar`** to portal any elements into a collapsible sidebar for your application

python
mo.sidebar([
mo.md(" marimo"),
mo.nav_menu({
"home": f"{mo.icon('lucide:home')} Home",
"about": f"{mo.icon('lucide:user')} About",
"contact": f"{mo.icon('lucide:phone')} Contact",
"Links": {
"https://twitter.com/marimo_io": "Twitter",
"https://github.com/marimo-team/marimo": "GitHub",
},
}, orientation="vertical",
),
])


What's Changed
* fix: ai completion streaming by mscolnick in https://github.com/marimo-team/marimo/pull/1349
* fix: %% in export script by akshayka in https://github.com/marimo-team/marimo/pull/1350
* fix: HoloMap formatter by mscolnick in https://github.com/marimo-team/marimo/pull/1347
* feat: mo.sidebar by mscolnick in https://github.com/marimo-team/marimo/pull/1352
* fix: use theme in bokeh formatter by mscolnick in https://github.com/marimo-team/marimo/pull/1353


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.5.1...0.5.2

Highlights

🏝️ **marimo islands**: marimo islands are a way to embed marimo outputs and/or python code in your HTML that will become interactive when the page is loaded. This is useful for creating interactive blog posts, tutorials, and educational materials, all powered by marimo’s reactive runtime.

html
<marimo-island data-app-id="main" data-cell-id="MJUe" data-reactive="true">
<marimo-cell-output>
<span class="markdown">
<span class="paragraph">Hello, islands!</span>
</span>
</marimo-cell-output>
<marimo-cell-code hidden>mo.md('Hello islands 🏝️!')</marimo-cell-code>
</marimo-island>


Read more about islands: https://docs.marimo.io/guides/wasm.html#islands

**Export as Markdown**: Export your marimo app to markdown from the code editor.

**mo.nav_menu**: Navigate to different marimo notebooks, when running multiple notebooks at a time.

What's Changed
* feat: preview marimo-islands, add docs by mscolnick in https://github.com/marimo-team/marimo/pull/1335
* chore: upgrade deps, upgrade to node 20 in CI by mscolnick in https://github.com/marimo-team/marimo/pull/1331
* fix: ignore warnings when analyzing modules in watcher by akshayka in https://github.com/marimo-team/marimo/pull/1338
* fix: check for module staleness when registering a cell by akshayka in https://github.com/marimo-team/marimo/pull/1336
* feat: add export as markdown from the UI by mscolnick in https://github.com/marimo-team/marimo/pull/1339
* docs: upgrade doc deps by mscolnick in https://github.com/marimo-team/marimo/pull/1342
* docs: add links by akshayka in https://github.com/marimo-team/marimo/pull/1343
* improvement: allow renaming markdown files when enabled by mscolnick in https://github.com/marimo-team/marimo/pull/1341
* feat: add mo.nav_menu by mscolnick in https://github.com/marimo-team/marimo/pull/1344
* fix: include console outputs in HTML exports when code is shown by akshayka in https://github.com/marimo-team/marimo/pull/1345
* 0.5.1 by akshayka in https://github.com/marimo-team/marimo/pull/1346


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.5.0...0.5.1

What's Changed

Version 0.5.0 introduces a brand new **lazy runtime** which makes working with expensive notebooks much more ergonomic, and it also makes it possible to **export notebooks as markdown**.


Highlights

**Lazy runtime.** We've heard your feedback: you can now configure the marimo runtime to be lazy, **giving you full control over when cells are run**. When a cell is run, instead of automatically running affected cells, marimo's lazy runtime will **mark them as stale**. Cells are still always run with the latest inputs (stale parents of a cell are run if needed), and your notebook is still required to be a DAG, so you're **still guaranteed** that your code and outputs are consistent.

Learn more: https://docs.marimo.io/guides/runtime_configuration.html

**Export as markdown.** Export marimo notebooks as markdown with `marimo export md notebook.py -o notebook.md`, or convert markdown to marimo with `marimo convert notebook.md > notebook.py`.

Shout out to dmadisetti for contributing this feature.

What's coming
Future updates in the 0.5.x series will bring more improvements to both the runtime and using markdown -- stay tuned!

All changes

Thanks Ubehebe for making your first contribution; welcome to the marimo fam!

* feat: convert and export from markdown by dmadisetti in https://github.com/marimo-team/marimo/pull/1296
* fix: add markdown sanitization for malicious notebooks by dmadisetti in https://github.com/marimo-team/marimo/pull/1315
* fix: handle duplicate columns in pandas when inferring datatype by mscolnick in https://github.com/marimo-team/marimo/pull/1313
* fix: don't crash the table on 1 million rows by mscolnick in https://github.com/marimo-team/marimo/pull/1314
* test: consolidate some 'edit' e2e tests to a single server by mscolnick in https://github.com/marimo-team/marimo/pull/1320
* Run typos checks in makefile by akshayka in https://github.com/marimo-team/marimo/pull/1318
* fix: allow int columns in mo.ui.dataframe by mscolnick in https://github.com/marimo-team/marimo/pull/1322
* chore: improve wasm development, e2e test by mscolnick in https://github.com/marimo-team/marimo/pull/1323
* improvement: load pyodide dev version on marimo dev releases by mscolnick in https://github.com/marimo-team/marimo/pull/1324
* feat: lazy runtime by akshayka in https://github.com/marimo-team/marimo/pull/1302
* refactor: lazy-load top-level pages, reduce initial page load by mscolnick in https://github.com/marimo-team/marimo/pull/1295
* improvement: add cell actions and input/output variables to dag viewer panel by mscolnick in https://github.com/marimo-team/marimo/pull/1328
* fix: marimo config to follow_symlink in StaticFiles by Ubehebe in https://github.com/marimo-team/marimo/pull/1327
* fix: Fix playwright tests by mscolnick in https://github.com/marimo-team/marimo/pull/1329
* Persist App state + Cell state in md conversions by dmadisetti in https://github.com/marimo-team/marimo/pull/1326
* docs: lazy runtime by akshayka in https://github.com/marimo-team/marimo/pull/1333
* 0.5.0 by akshayka in https://github.com/marimo-team/marimo/pull/1334

New Contributors
* Ubehebe made their first contribution in https://github.com/marimo-team/marimo/pull/1327

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.11...0.5.0

What's Changed

This release includes a few major UX improvements to the marimo editor.

Highlights


**Improved DAG viewer.** The built-in dependency graph viewer is now much more useful: view your cells in a top-down topological order. Click on an edge to see the variables that flow on it, or double click a cell to automatically bring it into focus.

This viewer can help you understand which cells when run when a given cell runs.

<img width="995" alt="image" src="https://github.com/marimo-team/marimo/assets/1994308/33bfdd43-3620-44d4-91d4-c6a0aa487314">

**Hardware utilization meters.** The editor footer shows total RAM and CPU usage on your machine.

<img width="282" alt="image" src="https://github.com/marimo-team/marimo/assets/1994308/198131f6-9638-4374-80ea-7352275e02fc">

**Use `mo.status.progress_bar` as a context manager**:

python
with mo.status.progress_bar(total=10) as bar:
for i in range(10):
do work
bar.update(increment=1, subtitle=f"finished iteration number {i]")


All changes

Shout out to seantur for making their first contribution (thank you!), and fuenfundachtzig for continuing to make marimo better.

* 0.4.10 by mscolnick in https://github.com/marimo-team/marimo/pull/1294
* fix: sanitize stdout and stderr by mscolnick in https://github.com/marimo-team/marimo/pull/1297
* improvement: mo.lazy supports async functions by mscolnick in https://github.com/marimo-team/marimo/pull/1300
* fix: disconnect from consumer if there is a stale connection by mscolnick in https://github.com/marimo-team/marimo/pull/1301
* feat: add TB and LR tree view to the dependency viewer by mscolnick in https://github.com/marimo-team/marimo/pull/1276
* feat: show usage stats (memory, cpu) in the footer by mscolnick in https://github.com/marimo-team/marimo/pull/1303
* fix: find/replace opening by mscolnick in https://github.com/marimo-team/marimo/pull/1307
* Improvement: annotate cycles with variable names by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1304
* feat: allow status.progress_bar to be used as a context manager by seantur in https://github.com/marimo-team/marimo/pull/1308
* chore: lint by akshayka in https://github.com/marimo-team/marimo/pull/1309
* 0.4.11 by akshayka in https://github.com/marimo-team/marimo/pull/1310

New Contributors
* seantur made their first contribution in https://github.com/marimo-team/marimo/pull/1308

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.10...0.4.11

What's Changed
* Update README.md by KPCOFGS in https://github.com/marimo-team/marimo/pull/1292
* fix: self-closing iframes is not a thing by mscolnick in https://github.com/marimo-team/marimo/pull/1293

New Contributors
* KPCOFGS made their first contribution in https://github.com/marimo-team/marimo/pull/1292

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.9...0.4.10