SKILL.md
Slidev - Presentation Slides for Developers
Web-based slides maker built on Vite, Vue, and Markdown.
When to Use
- Technical presentations or slidedecks with live code examples
- Syntax-highlighted code snippets with animations
- Interactive demos (Monaco editor, runnable code)
- Mathematical equations (LaTeX) or diagrams (Mermaid, PlantUML)
- Record presentations with presenter notes
- Export to PDF, PPTX, or host as SPA
- Code walkthroughs for developer talks or workshops
Quick Start
pnpm create slidev # Create project
pnpm run dev # Start dev server (opens http://localhost:3030)
pnpm run build # Build static SPA
pnpm run export # Export to PDF (requires playwright-chromium)
Verify: After pnpm run dev, confirm slides load at http://localhost:3030. After pnpm run export, check the output PDF exists in the project root.
Basic Syntax
---
theme: default
title: My Presentation
---
# First Slide
Content here
---
# Second Slide
More content
<!--
Presenter notes go here
-->
---separates slides
- First frontmatter = headmatter (deck config)
- HTML comments = presenter notes
Core References
Topic
Description
Reference
Markdown Syntax
Slide separators, frontmatter, notes, code blocks
Animations
v-click, v-clicks, motion, transitions
Headmatter
Deck-wide configuration options
Frontmatter
Per-slide configuration options
CLI Commands
Dev, build, export, theme commands
Components
Built-in Vue components
Layouts
Built-in slide layouts
Exporting
PDF, PPTX, PNG export options
Hosting
Build and deploy to various platforms
Global Context
$nav, $slidev, composables API
Feature Reference
Code & Editor
Feature
Usage
Reference
Line highlighting
[code-line-highlighting](https://github.com/antfu/skills/blob/HEAD/skills/slidev/references/code-line-highlighting.md)
Click-based highlighting
Line numbers
lineNumbers: true or {lines:true}
Scrollable code
{maxHeight:'100px'}
Code tabs
::code-group (requires comark: true)
Monaco editor
[editor-monaco](https://github.com/antfu/skills/blob/HEAD/skills/slidev/references/editor-monaco.md)
Run code
Edit files
<<< ./file.ts {monaco-write}
Code animations
[code-magic-move](https://github.com/antfu/skills/blob/HEAD/skills/slidev/references/code-magic-move.md)
TypeScript types
Import code
<<< @/snippets/file.js
Diagrams & Math
Feature
Usage
Reference
Mermaid diagrams
[diagram-mermaid](https://github.com/antfu/skills/blob/HEAD/skills/slidev/references/diagram-mermaid.md)
PlantUML diagrams
LaTeX math
$inline$ or $$block$$
Layout & Styling
Feature
Usage
Reference
Canvas size
canvasWidth, aspectRatio
Zoom slide
zoom: 0.8
Scale elements
<Transform :scale="0.5">
Layout slots
::right::, ::default::
Scoped CSS
<style> in slide
Global layers
global-top.vue, global-bottom.vue
Draggable elements
v-drag, <v-drag>
Icons
<mdi-icon-name />
Animation & Interaction
Feature
Usage
Reference
Click animations
v-click, <v-clicks>
Rough markers
v-mark.underline, v-mark.circle
Drawing mode
Press C or config drawings:
Direction styles
forward:delay-300
Note highlighting
[click] in notes
Syntax Extensions
Feature
Usage
Reference
Comark syntax
comark: true + {style="color:red"}
Block frontmatter