# Documentation

From your first deck to native components, effects, and the presenter workspace.

Source: https://legend.so/slides/reference/

Legend Slides: Preview.

Write a local MDX file, compose a native presentation, and keep your notes on your screen. These guides describe the current macOS development app.

Preview

Public downloads are not available yet. [Check release status](https://legend.so/slides/availability/) before planning an installation.

## [Start here](https://legend.so/slides/reference/#start-here)

[

### Getting started

Write, download, validate, and open your first deck.

](https://legend.so/slides/getting-started/)[

### Deck format

Frontmatter, native Markdown, attributes, and local files.

](https://legend.so/slides/deck-format/)

## [Tell the story](https://legend.so/slides/reference/#tell-the-story)

[

### Layouts

Groups, weighted columns, grids, and native surfaces.

](https://legend.so/slides/layouts/)[

### Steps and speaker notes

Reveals, component states, and private cues.

](https://legend.so/slides/steps-and-notes/)[

### Transitions and shared elements

Move ideas between slides and zoom into regions.

](https://legend.so/slides/transitions/)[

### Components and assets

Local React Native code, images, templates, and playback.

](https://legend.so/slides/components/)[

### Presentation runtime API

Navigation fields, native playback clocks, and component lifecycle.

](https://legend.so/slides/runtime-api/)

## [Add another dimension](https://legend.so/slides/reference/#add-another-dimension)

[

### Backgrounds and visual effects

Capture shaders, glass, native backgrounds, and GPU programs.

](https://legend.so/slides/backgrounds-and-effects/)[

### Effects gallery

Native previews and complete optional-pack examples.

](https://legend.so/slides/effects/)[

### Webviews

Embed local HTML or browser React components.

](https://legend.so/slides/webviews/)

## [Take the stage](https://legend.so/slides/reference/#take-the-stage)

[

### Editing, rehearsal, and presenting

Work with editing, notes, displays, and update locking.

](https://legend.so/slides/presenting/)[

### Author with AI

Install the skill, brief an agent, and review its output.

](https://legend.so/slides/ai-authoring/)[

### Troubleshooting

Diagnose compilation, layout, imports, timing, and displays.

](https://legend.so/slides/troubleshooting/)

## [Syntax at a glance](https://legend.so/slides/reference/#syntax-at-a-glance)

| Intent | Write |
| --- | --- |
| New slide | A top-level `---`. |
| Reveal a block | `A thought. {step=1}` |
| Reveal a list | `{steps}` on its own line before the list. |
| Hide later | `A thought. {step=1 until=3}` |
| Match a title | `# The idea {shared=title}` on both slides. |
| Group blocks | `:::group{gap=24}` … `:::`. |
| Private notes | `<!-- 1: Your opening cue. -->` |
| Style text | `## Title {class="text-cyan-300"}` |

[Download the starter deck](https://legend.so/slides/examples/first-deck.mdx) or [return to the homepage](https://legend.so/slides/).

[View Markdown](https://legend.so/slides/reference.md)[Report a documentation correction](https://github.com/LegendApp/legend-docs/issues/new?title=Docs%3A+Documentation&body=Page%3A+https%3A%2F%2Flegend.so%2Fslides%2Freference%0A%0AWhat+is+incorrect+or+missing%3F%0A%0AExpected+behavior+or+supporting+source%3A%0A)