---
title: "Introduction"
description: "Meet Deckup, an Astro-native toolkit for writing, previewing, and exporting slide decks."
---

> Documentation Index
> Fetch the complete documentation index at: https://deckup.yuku.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

Write slides in `.mdx` or `.astro`, run `deckup open`, and get a live presentation in the browser. Then ship the exact same source as an interactive web deck, a PDF, or PNG images.

A Markdown file is a deck. A horizontal rule starts a new slide. Everything the web can render is fair game.

## Why Deckup?

### As expressive as the web

Slides are not documents. They live on visual impact.

Deckup gives every slide the web as its canvas: start with simple Markdown, then reach for HTML and SVG, CSS animations, WebGL, or interactive React and Vue components when a slide deserves more.

There is no mode switching and no plugin ceiling: if Astro can render it, Deckup can put it on a slide.

Learn more in [Writing Slides](/guides/writing-slides/).

### Built for humans and AI agents

Every edit shows up in the browser instantly, thanks to Vite HMR.

Coding agents get an equivalent loop: render any slide as a PNG and review the result visually. Deckup ships Agent Skills out of the box, so your agent writes a slide, screenshots it, and refines it the same way you would.

Learn more in [Working with AI](/guides/working-with-ai/).

### One source, every output

A single `deckup build` turns the same files into whatever the moment calls for. Present from an interactive web deck. Email a PDF. Export per-slide PNGs.

What you previewed is exactly what ships, with no export-time surprises.

Learn more in the [CLI reference](/references/cli/).

### Themable

Themes define the layouts and typography of a deck, so every slide looks like it belongs to the same presentation.

Inside those layouts, the content is yours: pick a layout for structure, then fill it with anything from plain Markdown to rich visuals. Order where it matters, freedom where it counts.

Learn more in the [Theme reference](/references/theme/) and [Authoring Themes](/guides/authoring-themes/).

## Where to begin

Follow [Getting Started](/introduction/getting-started/) to create and export your first deck in minutes.

Source: https://deckup.yuku.dev/index.mdx