Guides

These guides cover marimo’s core concepts.

Learn by doing!

Prefer a hands-on learning experience? marimo comes packaged with interactive tutorials that you can launch with marimo tutorial at the command line.

Guide	Description
Overview	An overview of basic concepts
Reactive execution	How marimo runs cells
Interactive elements	Using interactive UI elements
Cell outputs	Creating markdown, plots, and other visual outputs
Expensive notebooks	Tips for working with expensive notebooks
Working with data	Using SQL cells, no-code dataframe tools, and reactive plots
Editor features	View variables, dataframe schemas, docstrings, and more
Configuration	Configure various settings
Run as an app	Running notebooks as apps
Run as a script	Running notebooks as scripts
Coming from other tools	Transitioning from Jupyter and other tools
Integrating with marimo	Rich displays of objects, custom UI plugins
Reactive state	Advanced: mutable reactive state
Online playground	Create notebooks in our online playground
Exporting	Exporting notebooks to HTML and flat scripts
Deploying	Deploying marimo notebooks and apps
Best practices	Best practices to help you get the most out of marimo
Troubleshooting	Troubleshooting notebooks