marimo-md-export¶
Export a marimo notebook to markdown with rendered outputs.
Usage¶
marimo-md-export [OPTIONS] {notebook} {output}
Arguments¶
| Name | Description | Required |
|---|---|---|
notebook |
Path to the marimo notebook (.py) | Yes |
output |
Where to write the resulting markdown file | Yes |
Options¶
| Name | Description | Required | Default |
|---|---|---|---|
--keep-html / --no-keep-html |
Write the intermediate HTML export to {assets-dir}/notebook.html (default: keep). Use --no-keep-html to discard it. | No | keep-html |
--self-contained / --no-self-contained |
Embed figures as base64 data URIs in the markdown instead of writing them as files under the assets directory. | No | no-self-contained |
--assets-dir PATH |
Directory for sidecar assets (figures and/or notebook.html). Defaults to {output_stem}_assets/ beside the markdown file. Relative paths are resolved against the output file's directory. | No | - |
--marimo-args TEXT |
Extra arguments forwarded to marimo export (space-separated) | No | - |
-v, --verbose |
Print progress to stdout | No | False |
--sandbox / --no-sandbox |
Run marimo export in an isolated uv environment. Without this flag, marimo's own sandbox prompt is suppressed. | No | no-sandbox |
--timeout SECONDS |
Maximum seconds to wait for each marimo export subprocess (default: no timeout). | No | - |
--overflow MODE |
Default overflow behavior for long output lines: 'wrap' (default) or 'scroll'. Can be overridden per cell with # @scroll or # @wrap. | No | wrap |
--version |
Print the version and exit. | No | False |
Commands¶
No commands available