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 markdown document with tables (as GFM or HTML), console output, and other cell outputs, plus a sidecar assets directory for figures and the intermediate HTML notebook.
mo.md() cells come through as plain markdown — including f-strings, whose interpolated values are substituted and whose math stays as $...$.
Pass --self-contained to embed figures as base64 data URIs instead of writing them out.
Quick start
Write your marimo .py notebook — cell outputs are rendered by default:
fig, ax = plt.subplots()
ax.plot(x, np.sin(x))
fig
Then run:
uvx marimo-md-export notebook.py output.md
This writes output.md, plus output_assets/notebook.html and output_assets/figure-1.png (and so on).
Integrating with documentation sites
marimo-md-export is designed to produce markdown pages for static site generators like mkdocs or zensical.
Both work identically for this purpose.
1. Add as a docs dependency:
uv add --group docs marimo-md-export
2. Add a build step that converts your notebook(s) before building the site.
For example, this project uses the following just command to build the docs:
docs:
marimo-md-export examples/notebook.py docs/example.md
zensical build
This runs marimo-md-export to produce a markdown page (with cell outputs injected) and its assets directory, then builds the site.
Development
uv sync # sync packages
just # run lint, typecheck, test, build docs
1 maintainer
Metadata
1 maintainer
Release files for marimo-md-export 0.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| marimo_md_export-0.10.0.tar.gz | 17.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| marimo_md_export-0.10.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.7 kB
Release files / marimo_md_export-0.10.0.tar.gz
| Download URL | marimo_md_export-0.10.0.tar.gz |
|---|---|
| Size | 17.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3ba0ea443b57793f786ba7e55b41f86cf317f222f47ab495bc712f800b63cd8f
|
|
BLAKE2b-256 checksum How to use checksums |
483a097e26f27b2463b5923064e72107a886da122bafff17811ea22ded4028d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / marimo_md_export-0.10.0-py3-none-any.whl
| Download URL | marimo_md_export-0.10.0-py3-none-any.whl |
|---|---|
| Size | 21.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
62f326ca6ffa78ee592b5d0c9843ab287267bd3d7e8e50fd6f2ecf0a19e4d60c
|
|
BLAKE2b-256 checksum How to use checksums |
5d86f512e9c6fd5128bc171f741e924ee7fa98c42972ddd2562afc3a290db1fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for marimo-md-export 0.10.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
