Skip to content

Structure Layouts

Layouts for organizing your presentation structure - title slides, sections, and endings.

cover - Title Slide

Use for: The first slide of your presentation

Cover Layout Example

markdown
---
layout: cover
authors:
  - name: Your Name
    institution: Your University
    email: [email protected]
footerMiddle: Conference Name 2025
---

# Your Presentation Title
Subtitle or description

What it shows:

  • Large title in the center
  • Author(s) with institution and email
  • Footer with author, conference, and page number

default - Standard Content

Use for: Most of your slides (this is automatic!)

Default Layout Example

markdown
---
title: My Slide Title
subtitle: Optional subtitle
---

# Main Content

- Bullet point 1
- Bullet point 2

You can add text, images, code, math formulas, etc.

What it shows:

  • Optional header with title and subtitle
  • Your content in the middle
  • Footer at the bottom

intro - Section Introduction

Use for: Starting a new section of your talk

Intro Layout Example

markdown
---
layout: intro
---

# Part 2: Methodology

Let's discuss our approach

What it shows:

  • Large, centered text
  • No header (more space for the title)
  • Footer at the bottom

section - Chapter Divider

Use for: Major transitions in your presentation

Section Layout Example

markdown
---
layout: section
sectionMode: dark  # or 'light' (optional, default: dark)
---

# Results

What it shows:

  • Very large, centered title
  • No header
  • Footer at the bottom
  • Perfect for dramatic section breaks

sectionMode Options:

ValueDescription
darkDark background with light text (default)
lightLight background with dark text

Global vs Per-slide Configuration:

You can set a global default in your headmatter:

yaml
---
theme: scholarly
themeConfig:
  sectionMode: light  # All sections default to light
---

Then override on specific slides:

yaml
---
layout: section
sectionMode: dark  # Override global setting for this slide
---

# This Section Uses Dark Mode

center - Centered Content

Use for: Short messages or key points

Center Layout Example

markdown
---
layout: center
---

# Key Takeaway

This is the most important point

What it shows:

  • All content centered horizontally and vertically
  • Great for emphasis

auto-center - Auto-Adjusting Content

Use for: Content that needs automatic font size adjustment

Auto-Center Layout Example

markdown
---
layout: auto-center
title: Title
subtitle: Subtitle
---

## Auto-Centered Content

This layout automatically adjusts font size to fit content.

What it shows:

  • Automatically adjusts font size based on content length
  • Centers content vertically
  • Keeps text left-aligned within the centered block

end - Thank You Slide

Use for: Professional closing slide with contact information

End Layout Example

markdown
---
layout: end
email: [email protected]
website: https://example.com/project
subtitle: Questions?
qrcode: https://example.com/qr.png
qrcodeLabel: Scan for paper
---

Thank you for your attention!

Props:

  • thankYou: Custom thank you text (default: "Thank You!")
  • subtitle: Subtitle text
  • email: Contact email
  • website: Project/personal website
  • qrcode: QR code image URL
  • qrcodeLabel: Label for QR code