headmatter

name	headmatter
description	Deck-wide configuration options in the first frontmatter block

Headmatter Configuration

Deck-wide configuration options in the first frontmatter block.

Theme & Appearance

---
theme: default              # Theme package or path
colorSchema: auto           # 'auto' | 'light' | 'dark'
favicon: /favicon.ico       # Favicon URL
aspectRatio: 16/9           # Slide aspect ratio
canvasWidth: 980            # Canvas width in px
---

Fonts

---
fonts:
  sans: Roboto
  serif: Roboto Slab
  mono: Fira Code
  provider: google          # 'google' | 'none'
---

Code & Highlighting

---
highlighter: shiki          # Code highlighter
lineNumbers: false          # Show line numbers
monaco: true                # Enable Monaco editor ('true' | 'dev' | 'build')
twoslash: true              # Enable TwoSlash
monacoTypesSource: local    # 'local' | 'cdn' | 'none'
---

Features

---
drawings:
  enabled: true             # Enable drawing mode
  persist: false            # Save drawings
  presenterOnly: false      # Only presenter can draw
  syncAll: true             # Sync across instances
record: dev                 # Enable recording
selectable: true            # Text selection
contextMenu: true           # Right-click menu
wakeLock: true              # Prevent screen sleep
---

Export & Build

---
download: false             # PDF download button
exportFilename: slides      # Export filename
export:
  format: pdf
  timeout: 30000
  withClicks: false
  withToc: false
---

Info & SEO

---
title: My Presentation
titleTemplate: '%s - Slidev'
author: Your Name
keywords: slidev, presentation
info: |
  ## About
  Presentation description
---

SEO Meta Tags

---
seoMeta:
  ogTitle: Presentation Title
  ogDescription: Description
  ogImage: https://example.com/og.png
  ogUrl: https://example.com
  twitterCard: summary_large_image
  twitterTitle: Title
  twitterDescription: Description
  twitterImage: https://example.com/twitter.png
---

Addons & Themes

---
theme: seriph
addons:
  - excalidraw
  - '@slidev/plugin-notes'
---

Theme Configuration

---
themeConfig:
  primary: '#5d8392'
  # Theme-specific options
---

Defaults

Set default frontmatter for all slides:

---
defaults:
  layout: default
  transition: fade
---

HTML Attributes

---
htmlAttrs:
  dir: ltr
  lang: en
---

Presenter & Browser

---
presenter: true             # 'true' | 'dev' | 'build'
browserExporter: dev        # 'true' | 'dev' | 'build'
routerMode: history         # 'history' | 'hash'
---

Remote Assets

---
remoteAssets: false         # Download remote assets locally
plantUmlServer: https://www.plantuml.com/plantuml
---

Full Template

---
theme: default
title: Presentation Title
author: Your Name
highlighter: shiki
lineNumbers: true
transition: slide-left
aspectRatio: 16/9
canvasWidth: 980
fonts:
  sans: Roboto
  mono: Fira Code
drawings:
  enabled: true
  persist: true
download: true
---