references/core-syntax.md

GitHub
namesyntax
descriptionCore Markdown syntax for Slidev presentations

Slidev Markdown Syntax

Core Markdown syntax for Slidev presentations.

Slide Separator

Use --- with blank lines before and after:

# Slide 1

Content

---

# Slide 2

More content

Headmatter (Deck Config)

First frontmatter block configures the entire deck:

---
theme: default
title: My Presentation
lineNumbers: true
---

# First Slide

Per-Slide Frontmatter

Each slide can have its own frontmatter:

---
layout: center
background: /image.jpg
class: text-white
---

# Centered Slide

Presenter Notes

HTML comments at end of slide become presenter notes:

# My Slide

Content here

<!--
These are presenter notes.
- Remember to mention X
- Demo the feature
-->

Code Blocks

Standard Markdown with Shiki highlighting:

```ts
const hello = 'world'
```

With features:

```ts {2,3}              // Line highlighting
```ts {1|2-3|all}        // Click-based highlighting
```ts {monaco}           // Monaco editor
```ts {monaco-run}       // Runnable code
```ts twoslash           // TypeScript types
```

LaTeX Math

Inline: $E = mc^2$

Block:

$$
\frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

Diagrams

Mermaid:

```mermaid
graph LR
  A --> B --> C
```

PlantUML:

```plantuml
@startuml
Alice -> Bob : Hello
@enduml
```

Comark Syntax

Enable with comark: true:

[styled text]{style="color:red"}
![](/image.png){width=500px}
::component{prop="value"}

Scoped CSS

Styles apply only to current slide:

# Red Title

<style>
h1 { color: red; }
</style>

Import Slides

---
src: ./pages/intro.md
---

Import specific slides:

---
src: ./other.md#2,5-7
---