Configuration Guide

Put deck-wide settings in the first YAML block of slides.md (headmatter). Later YAML blocks belong to individual slides. Appearance presets go under themeConfig; fields such as authors, bibFile, fontsize, and themeColors stay at the top level:

---
theme: scholarly
lang: en
footerMiddle: Conference Name 2026
authors:
  - name: Jane Smith
    institution: MIT
    email: [email protected]
  - name: John Doe
    institution: Stanford
    email: [email protected]
themeConfig:
  colorTheme: classic-blue
  fontTheme: classic
  chromeMode: dark
  sectionMode: dark
---

Essential Options

Option	Purpose	Example
theme	Enable the theme	scholarly
lang	Theorem and proof labels	en, zh
aspectRatio	Slide dimensions	16/9, 4/3 (default: 4/3)
bibFile	BibTeX source	./references.bib
bibStyle	Bibliography style	apa, ieee, chicago-author-date

Authors And Footer

Use author for a single name, or authors for structured multi-author decks:

authors:
  - name: Jane Smith
    institution: MIT
    email: [email protected]
  - name: John Doe
    institution: Stanford

Footer defaults:

Position	Default
Left	Author name(s)
Middle	Empty unless footerMiddle is set
Right	Page number

Override text with footerLeft, footerMiddle, or footerRight. Use the structured authors array to show names and affiliations on the cover.

Theme Config

Use themeConfig to control the deck's appearance and player behavior:

themeConfig:
  colorTheme: oxford-burgundy
  fontTheme: traditional
  chromeMode: dark
  sectionMode: dark
  beamerNav: false
  outlineToc: true
  outlineTocOpen: false

Option	Purpose	Default
fontTheme	Font preset id	classic
beamerNav	Footer navigation buttons in play mode	true
outlineToc	Footer TOC button and outline panel	false
outlineTocOpen	Open the outline panel on load	false
footnoteDisplay	Legacy location; prefer the top-level field described below	both

Color and surface controls:

Option	Controls	Default
colorTheme	Brand palette: primary, accent, paper tone, and base text color	classic-blue
contentMode	Slide background, text, code, tables, and content components	Follows colorMode, then Slidev dark state
chromeMode	Header, footer, page numbers, navigation, outline, and toolbars	dark
sectionMode	Default appearance for layout: section slides	dark
colorMode	Legacy alias for contentMode	Deprecated

Notes:

• Navigation buttons are hidden in overview, embedded, and print/export views.
• The footer TOC groups slides by layout: section.
• Long decks switch the TOC to a compact section-first view.
• Slides with hideInToc: true are hidden from the TOC.
• Legacy outlineSidebar and outlineSidebarOpen still work; prefer outlineToc and outlineTocOpen for new decks.

Color Surface Modes

Use contentMode for body content, chromeMode for headers and controls, and sectionMode for chapter dividers. If contentMode is unset, content follows Slidev's light/dark state, subject to the legacy colorMode fallback.

colorSchema: both
themeConfig:
  colorTheme: high-contrast
  contentMode: light
  chromeMode: dark
  sectionMode: dark

See Theme Mode and Contrast for supported values, precedence, and per-slide section overrides. For custom palette values, use top-level themeColors.

Theorem Numbering

Customize automatic theorem numbers:

theoremNumberFormat: '({number})'

Choose one format:

Format	Output
'{number}'	1, 2, 3
'({number})'	(1), (2), (3)
'[{number}]'	[1], [2], [3]
'{number}.'	1., 2., 3.

Use the number prop for one manual number, or :autoNumber="false" for an unnumbered statement.

Font Sizes

Set global font sizes:

fontsize:
  body: 18px
  h1: 48px
  h2: 36px
  h3: 28px

Override on one slide:

---
fontsize:
  body: 20px
  h1: 50px
---

# Custom Sized Slide

Values can use px, rem, or em; plain numbers are treated as pixels. Per-slide settings take precedence over the global settings.

For cover-only typography, use scoped CSS on the cover slide:

<style>
.slidev-layout.cover h1 {
  font-size: 64px;
}
</style>

Footnotes

Set a global footnote display mode:

footnoteDisplay: hover-only

Override one slide:

---
footnoteDisplay: notes-only
---

Priority order:

1. Per-slide footnoteDisplay
2. Global headmatter footnoteDisplay
3. Legacy themeConfig.footnoteDisplay
4. Default both

Modes:

Mode	Behavior
both	Bottom notes plus inline hover/click preview
hover-only	Inline preview only
notes-only	Bottom notes only

Per-Slide Metadata

Set title, subtitle, layout options, or local overrides in slide frontmatter:

---
layout: figure
title: Model Overview
subtitle: Encoder and adapter path
hideInToc: true
---

Use Layouts and Components for page-specific props and examples.