Coming from Jupytext

If you’re familiar with Jupytext, you’ll find that marimo offers similar functionality for working with notebooks as Python files, but without the need for additional setup or synchronization issues because marimo notebooks are stored as .py files by default. However, Jupytext works with IPython notebooks, whereas marimo works with marimo notebooks, which are not based on IPython/Jupyter. Here’s a comparison to help you transition smoothly.

Notebook Format

Converting Jupyter notebooks

From .ipynb

From py:percent notebooks to marimo notebooks

If you have a Python file encoded in the py:percent format, you can convert it to a marimo notebook in two steps:

jupytext --to notebook.ipynb percent_notebook.py
marimo convert notebook.ipynb > marimo_notebook.py

To .ipynb

Editing Notebooks

Executing Notebooks

Version Control

Markdown and Code Cells

Deployment