# marimo-export: Prepare notebook results. Share them anywhere.

> Prepare notebook results. Share them anywhere.

Select the states and outputs to publish from a marimo notebook. marimo-export writes a portable, verified notebook export that browser applications and agents read without a Python runtime or a copy of the notebook source.

## Table of Contents

### Introduction

- [marimo-export: Prepare notebook results. Share them anywhere.](https://marimo-team.github.io/marimo-export/index.md): Select the states and outputs to publish from a marimo notebook. marimo-export writes a portable, verified notebook export that browser applications and agents read without a Python runtime or a copy of the notebook source.
- [Overview](https://marimo-team.github.io/marimo-export/overview.md): Run selected marimo notebook states and publish their outputs for browsers, Python, and agents.
- [When to use marimo-export](https://marimo-team.github.io/marimo-export/why.md): Compare a notebook export with a live Python service and browser Python.
- [Get started](https://marimo-team.github.io/marimo-export/guide/getting-started.md): Create two deterministic notebook states, publish JSON and rendered output, verify the files, and read one state.

### Guide

- [States](https://marimo-team.github.io/marimo-export/concepts/states-and-inputs.md): See how omitted inputs get values, identical states share work, and readers select a state.
- [Outputs](https://marimo-team.github.io/marimo-export/concepts/outputs-and-representations.md): Follow a notebook result as it becomes a named output, stored value, and consumer value.
- [Reuse](https://marimo-team.github.io/marimo-export/concepts/preparation-and-reuse.md): See when notebook states run and when marimo-export can reuse earlier results.
- [Caching](https://marimo-team.github.io/marimo-export/concepts/caching.md): See what marimo-export can reuse before a notebook runs and what marimo can restore while it runs.
- [Publishing](https://marimo-team.github.io/marimo-export/concepts/exports-and-publications.md): Choose between one fixed export URL and a stable application URL that follows newer exports.
- [Verification and trust](https://marimo-team.github.io/marimo-export/concepts/integrity-and-trust.md): Learn what verification checks, how to trust a publisher, and when an output can run browser code.
- [Choose states and outputs](https://marimo-team.github.io/marimo-export/guide/choose-states.md): Inspect a notebook, declare sparse states, and publish the representations each consumer needs.
- [Build and capture](https://marimo-team.github.io/marimo-export/guide/build-and-capture.md): Choose the producer that owns the notebook, prepare missing states, and write one notebook export whose bytes were verified before commit.
- [Read an export](https://marimo-team.github.io/marimo-export/guide/consume-an-export.md): Read the same exported states and outputs from Python, a browser, an agent, or another client.
- [Browser applications](https://marimo-team.github.io/marimo-export/guide/browser-applications.md): Open a notebook export, resolve states, load outputs, and replace mounted values safely.
- [Agents and automation](https://marimo-team.github.io/marimo-export/guide/agents-and-automation.md): Give agents prepared notebook data, verify its export bytes, and retain exact state and representation evidence.
- [Prepared publications](https://marimo-team.github.io/marimo-export/guide/prepared-publications.md): Publish a prepared manifest beside an immutable notebook export, then add refresh and route-grace ownership when the application needs updates.
- [Custom representations](https://marimo-team.github.io/marimo-export/guide/custom-representations.md): Convert one notebook result to a versioned BlobAsset and validate it with a matching browser loader.
- [Repository storage](https://marimo-team.github.io/marimo-export/guide/manage-repository.md): Inspect reusable artifacts, apply retention, and manage observed notebook inputs.
- [Deployment](https://marimo-team.github.io/marimo-export/guide/deploy.md): Verify files, configure static hosting, and preserve the integrity and browser trust boundaries.
- [Troubleshooting](https://marimo-team.github.io/marimo-export/guide/troubleshooting.md): Diagnose producer, repository, integrity, browser, and mount failures from the smallest observable boundary.

### Examples

- [Market dashboard](https://marimo-team.github.io/marimo-export/guide/market-dashboard.md): Build and open the advanced Yahoo Finance example from the repository checkout.

### Reference

- [Reference](https://marimo-team.github.io/marimo-export/reference.md): Exact contracts for StateSpace, ExportSpec, notebook exports, commands, Python, browser APIs, representations, portable JSON, and project terminology.
- [StateSpace and ExportSpec reference](https://marimo-team.github.io/marimo-export/reference/export-spec.md): Exact schemas for reusable state spaces and complete export specifications.
- [Output representations](https://marimo-team.github.io/marimo-export/reference/representations.md): Stored output forms, producer choices, consumer access, peer dependencies, and custom BlobAsset pairs.
- [Export format reference](https://marimo-team.github.io/marimo-export/reference/export-format.md): Durable directory, index, state, representation, asset, integrity, and version contracts for notebook exports.
- [CLI reference](https://marimo-team.github.io/marimo-export/reference/cli.md): Command syntax, repository selection, machine output, side effects, and exit codes.
- [Python API](https://marimo-team.github.io/marimo-export/reference/python-api.md): Choose the Python API for producing, reading, serving, or integrating notebook exports.
- [Produce an export from Python](https://marimo-team.github.io/marimo-export/reference/python/produce.md): Define an ExportSpec, inspect reusable work, prepare states, and write a verified notebook export.
- [Read and verify exports from Python](https://marimo-team.github.io/marimo-export/reference/python/reader.md): Open an immutable notebook export, select an exported state, decode an output, and verify every asset.
- [Sessions and inspection](https://marimo-team.github.io/marimo-export/reference/python/sessions-and-inspection.md): Inspect saved notebooks, connect to live marimo sessions, plan against them, and capture prepared exports.
- [Repository and observations](https://marimo-team.github.io/marimo-export/reference/python/repository-and-observations.md): Configure reusable export storage, inspect retention, and record successful notebook input vectors.
- [Delivery and publications](https://marimo-team.github.io/marimo-export/reference/python/delivery-and-publications.md): Commit complete application directories, create prepared manifests, and retain changing prepared exports.
- [Advanced host integration](https://marimo-team.github.io/marimo-export/reference/python/host-integration.md): Attach input observation and cache compatibility to an application-owned marimo kernel lifecycle.
- [Format records and errors](https://marimo-team.github.io/marimo-export/reference/python/format-records-and-errors.md): Canonical JSON, export indexes, output descriptors, diagnostic records, typed failures, and narrow public compatibility types.
- [Browser API reference](https://marimo-team.github.io/marimo-export/reference/browser-api.md): Routes to the TypeScript reader, prepared publication, loader, snapshot, error, and limit contracts.
- [Browser reader](https://marimo-team.github.io/marimo-export/reference/browser/reader.md): Open, inspect, resolve, load, and verify an immutable notebook export from TypeScript.
- [Prepared publications](https://marimo-team.github.io/marimo-export/reference/browser/prepared-publications.md): Manifest wire format, parsed values, state controller, refresh lifecycle, input routing, and application ownership.
- [Output loaders](https://marimo-team.github.io/marimo-export/reference/browser/loaders.md): Built-in output results, peer runtimes, mount ownership, cancellation, custom loaders, and prepared AnyWidget graphs.
- [marimo snapshots](https://marimo-team.github.io/marimo-export/reference/browser/snapshots.md): Rendered-output and complete-cell replay records, resource closure, model lifecycle messages, and parser contracts.
- [Browser errors and limits](https://marimo-team.github.io/marimo-export/reference/browser/errors-and-limits.md): Error families, codes, byte and allocation limits, cancellation behavior, browser requirements, and recovery paths.
- [Portable JSON](https://marimo-team.github.io/marimo-export/reference/portable-json.md): The shared Python and JavaScript value domain, canonical encoding, limits, and published interfaces.
- [Compatibility](https://marimo-team.github.io/marimo-export/reference/compatibility.md): Supported Python, marimo, browser, package, and protocol boundaries.
- [Terminology](https://marimo-team.github.io/marimo-export/reference/terminology.md): Canonical names for notebook states, outputs, preparation, repository artifacts, readers, integrity, and browser publications.