Guides
Slide mode demo
Test full-screen slides split by horizontal rules (---), including a two-column layout.
Minimal template (copy-paste)
Use YAML at the very top of the file, then split slides with --- in the body (after the closing frontmatter ---). Quick mode .md files work without MDX.
Info
The first --- … --- block is frontmatter only. Later --- lines on their own are slide breaks (horizontal rules).
---
title: My deck
description: One-line summary
slides: true
---
# First slide
Your content.
---
# Second slide
More content.
---
# Third slide
Done.
pnpm create barodoc also adds docs/en/example-slides.md with the same shape — copy or edit that file.
First slide
This is the first slide. Use the book / slides icons in the toolbar above the article to open Slide mode.
Use arrow keys to move between slides, Escape to exit.
Second slide
Here is the second slide. Slides are separated by --- in the Markdown source (renders as a horizontal rule).
Two columns on one slide
Layouts from MDX apply inside slide mode too. The whole <Columns> block stays on one slide — do not put --- between columns.
Left: image or diagram. Right: bullets or copy.
- Keep column pairs inside one slide
- Use
Columns/Columnfrom@barodoc/theme-docs
Last slide
That is it — a quick test including a column layout.