# Astlide

> Astlide is an Astro integration for slide decks: write slides in MDX, Markdown or HTML under src/content/decks/<deck>/, present them in the browser (presenter window, overview, pen), and export them to PDF, PNG or editable PowerPoint — also in a PowerPoint template's design.

Slides use `slideLayout` (not `layout`) in their frontmatter. Agents can also use the Astlide MCP server and agent skill — see the Agents guide below.

## Docs

- [Astlide](https://astlide.dev/): Slides that live in your Astro site — many decks per site, written in MDX, Markdown or HTML, presented on the web and exported as editable PowerPoint in your own template.
- [Why Astlide?](https://astlide.dev/why/): What Astlide is good at, how it compares to Slidev, Marp, reveal.js and Quarto, and when to choose something else.
- [Getting Started](https://astlide.dev/getting-started/): Create a new Astlide project or add Astlide to an existing Astro site.
- [Tutorial: Your First Deck](https://astlide.dev/tutorial/first-deck/): Build a short talk from scratch, present it, export a PDF and publish it on GitHub Pages.
- [Gallery](https://astlide.dev/gallery/): Every built-in layout and theme, rendered from the feature tour deck.

## Guides

- [Creating a Deck](https://astlide.dev/guides/decks/): Deck folders, _config.json, slide files in .mdx, .md and .html, and frontmatter.
- [Layouts & Components](https://astlide.dev/guides/layouts-and-components/): Built-in slide layouts and the components available in MDX slides.
- [React, Vue & Svelte components](https://astlide.dev/guides/frameworks/): Use components from React, Vue, Svelte, Solid or Preact in your slides — interactive in the browser, in their first state in PDF and PPTX.
- [Fragments](https://astlide.dev/guides/fragments/): Reveal content step by step with <Fragment> and <Fragments>.
- [Code](https://astlide.dev/guides/code/): Syntax highlighting, line highlighting and highlight steps.
- [Diagrams](https://astlide.dev/guides/diagrams/): Mermaid diagrams from ```mermaid code fences.
- [Presenting](https://astlide.dev/guides/presenting/): Keyboard shortcuts, the presenter window, overview, go-to-slide, pen and laser pointer, and the toolbar.
- [Themes & Plugins](https://astlide.dev/guides/themes-and-plugins/): Built-in themes, custom themes, the plugin API, slide decorators, deck metadata and fonts.
- [Export](https://astlide.dev/guides/export/): Export decks to PDF, PNG or PowerPoint.
- [Import PowerPoint & Google Slides](https://astlide.dev/guides/import/): Show a .pptx as Astlide slides, or turn it into an editable deck.
- [PowerPoint templates](https://astlide.dev/guides/templates/): Use a PowerPoint or Google Slides template as a theme, and write the slides in Markdown.
- [Render service (HTTP API)](https://astlide.dev/guides/server/): Run Astlide as an HTTP service — Markdown in, PowerPoint / PDF / PNG out — with an OpenAPI spec for Dify, n8n and other tools.
- [Coding agents](https://astlide.dev/guides/agents/): Let Claude Code, Codex or Gemini CLI write, check and export decks — the MCP server, the agent skill and llms.txt.
- [Deploying](https://astlide.dev/guides/deploy/): Build a static site and host it anywhere — including under a sub-path such as GitHub Pages.
- [Embedding a deck](https://astlide.dev/guides/embed/): Show a deck inside a blog post, a docs page or a React / Vue app with the <astlide-deck> element.

## Reference

- [Configuration](https://astlide.dev/reference/configuration/): Options for the astlide() integration and deck _config.json.
- [Slide Frontmatter](https://astlide.dev/reference/frontmatter/): Every frontmatter field a slide accepts.

## More

- [Astlide](https://astlide.dev/ja/): Astro サイトの中に置くスライド。1 つのサイトにデッキをいくつでも置け、MDX・Markdown・HTML で書いて Web で発表し、自社テンプレートの PowerPoint として編集できる形で書き出せます。

## Optional

- [All docs in one file](https://astlide.dev/llms-full.txt): every page above as Markdown
- [API reference](https://astlide.dev/api/): TypeDoc for @astlide/core
- [Live demo](https://astlide.dev/demo/tour/1/): the feature tour deck
- [Source](https://github.com/r-hashi01/astlide)