marimo-md-export 0.2.0

A minimal solution for exporting marimo notebooks to markdown *with* rendered HTML outputs, designed for mkdocs/zensical sites.

marimo-md-export

A uv tool that wraps marimo export, extracts rendered outputs from the HTML export, and injects them into the markdown export. The result is a self-contained markdown document with embedded figures (as base64 <img> tags) and tables (as GFM or HTML).

Full documentation

Quick start

Mark cells in your marimo .py notebook with # @output: <label>:

# @output: my_figure
fig, ax = plt.subplots()
ax.plot(x, np.sin(x))
fig

Then run:

uvx marimo-md-export notebook.py output.md

Installation

uv tool install marimo-md-export   # or: pipx install marimo-md-export

Development

uv sync  # sync packages
just  # run lint, typecheck, test, build docs