Metadata-Version: 2.4
Name: marimo-md-export
Version: 0.1.1
Summary: A minimal solution for exporting marimo notebooks to markdown *with* rendered HTML outputs, designed for mkdocs/zensical sites.
Keywords: marimo,markdown,documentation
Author: jmarshrossney
Author-email: jmarshrossney <17361029+jmarshrossney@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Documentation
Classifier: Topic :: Text Processing :: Markup :: Markdown
Requires-Dist: beautifulsoup4>=4.14.3
Requires-Dist: lxml>=6.1.0
Requires-Dist: marimo>=0.23.3
Requires-Dist: typer>=0.25.0
Requires-Python: >=3.12
Project-URL: Homepage, https://jmarshrossney.github.io/marimo-md-export
Project-URL: Repository, https://github.com/jmarshrossney/marimo-md-export
Project-URL: Documentation, https://jmarshrossney.github.io/marimo-md-export
Description-Content-Type: text/markdown

# 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](https://jmarshrossney.github.io/marimo-md-export)**

## Quick start

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

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

Then run:

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

## Installation

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

## Development

```sh
uv sync
just test
just docs
```
