---
url: https://marimo-team.github.io/marimo-studio/guide.md
description: >-
  Build views of a marimo notebook, place its results, share the views, and work
  with coding agents, Lens, and marimohub.
---

# Guide

New to Studio? Build a first view in [Getting started](getting-started.md) or
ask a [coding agent](coding-agents.md) for one.
[What is Studio?](../what-is-studio.md) explains the model, and
[How Studio works](../how-studio-works.md) shows how a page receives notebook
results. The [glossary](../reference/glossary.md) defines every term the guides
use.

## Build views

| I want to                                                                  | Guide                                                   |
| -------------------------------------------------------------------------- | ------------------------------------------------------- |
| Place cells, outputs, and values in a page or a PDF                        | [Place notebook results in a view](notebook-results.md) |
| Pick HTML, React, Svelte, Reveal.js, Notebook Kit, Quarto, Typst, or LaTeX | [Choose a format](formats.md)                           |
| Edit, build, create, rename, and remove views                              | [Work in Studio](work-in-studio.md)                     |
| Theme a page and the notebook output it places                             | [Style a page](styling.md)                              |
| Add a format for another framework, template, or build tool                | [Add a view provider](view-providers.md)                |

## Share views

| I want to                                                     | Guide                                                   |
| ------------------------------------------------------------- | ------------------------------------------------------- |
| Serve a view with Python, run it in the browser, or export it | [Run or export a view](run-and-share.md)                |
| Link views, share state in the URL, and keep sessions         | [Link views and keep state](navigation-and-sessions.md) |
| Host a live Python view behind authentication                 | [Deploy a live Python view](deploy.md)                  |
| Diagnose a build, runtime, or export failure                  | [Troubleshoot Studio](troubleshooting.md)               |

## Integrations

| I want to                                                            | Guide                                          |
| -------------------------------------------------------------------- | ---------------------------------------------- |
| Ask a coding agent for a notebook and its views                      | [Author with a coding agent](coding-agents.md) |
| Point at part of a view, even inside a PDF, and hand it to the agent | [Select results with Lens](lens.md)            |
| Author and serve views on a self-hosted notebook platform            | [Use Studio in marimohub](marimohub.md)        |

The [reference](../reference/index.md) defines every command, setting, and API.
