video
A video as a static, PDF-safe embed: a poster that links to the clip, a play badge, the provider's name, and a scannable QR to the same URL — never a live iframe.
Use to put a YouTube / Vimeo / TikTok / Instagram video on a slide. Because the deck renders to a static PDF (and the engine bars iframes), a video slide shows a POSTER with a play badge + provider label — the poster is a clickable link in the HTML/PDF — and, when you add the qr modifier, a scannable code the room can scan to watch. Two compositions: companion (a claim leads on the left, the clip proves it on the right) and gallery (a contained, matted exhibit). Author the URL as a bare bullet; add an optional caption and an optional poster override. Provider is auto-detected.
When to use
- A clip makes the point better than a screenshot. A product walkthrough, a customer testimonial, a demo reel — anywhere motion carries the argument. The slide shows a clean poster; the room scans the QR (or clicks it in the HTML/PDF) to watch.
- The URL is all you have to write. Paste the YouTube / Vimeo / TikTok / Instagram link as a bare bullet; the provider is detected and the QR is generated for you. Add a
posterbullet only when you want a specific still (required for Instagram, whose thumbnails aren't fetchable). - Closing / hand-off slides. A 'watch the full demo' or 'see the launch film' send-off pairs a poster with a scannable code the audience takes with them — the same pattern as the QR closing/divider variants.
When not to use
- Expecting it to autoplay in the PDF. A PDF is paper — it can't play video, and the engine bars iframes for security.
videois a poster + scannable link by design. If you need in-app playback, that's a separate interactive surface, not a boardroom deck. - A wall of caption. The caption is one line — 'Scan to watch', a title, a runtime. If you're writing a paragraph about the video, put it in a
contentslide and drop the clip in as a supportingvideo. - Instagram with no poster. Instagram's public thumbnails aren't fetchable, so an Instagram
videowith noposterbullet falls back to a plain placeholder tile. Author aposterfor a real still.
Common mistakes
- The caption or poster bullet has no trailing `
caption/poster` inline-code key. The transform only recognizes a caption/poster bullet by its trailing key — a plain bullet with no key is invisible to the payload resolver, so the caption never appears and the poster override is silently dropped. - Authoring more than one URL bullet, expecting a second clip or a contact-sheet grid. The transform stops at the FIRST bullet whose text or link a provider recognizes — any additional URL bullets are silently ignored, not turned into a second video; only one clip renders per section.
Authoring
<!-- _class: video companion -->
## Watch the 90-second product tour.
One screen, one story — the fastest way to see the product work.
- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- A guided walkthrough `caption`Slots
| Slot | Selector | Required | Description |
|---|---|---|---|
heading | h2 | no | Optional heading — the so-what of the clip, not 'Video'. |
video | .video-embed | yes | The video URL, authored as a bare bullet (- https://youtube.com/watch?v=…). Provider is auto-detected; the transform builds the poster + play badge + QR. |
caption | .video-embed figcaption | no | Optional caption bullet — a plain bullet line ending with the caption marker (see Authoring below for the full syntax). |
Variant decision rule
- default (no modifier) — A standalone video callout with no strong claim beside it — poster plus meta column, the simplest look.
companion— A specific claim leads the slide and the clip proves it — text and poster split left/right.gallery— The video is more exhibit than pitch — contained on a matte the way a diagram or screenshot would be.qr— The room should be able to open the clip on their own phones — combines with any other variant to add a scannable code beside the poster.
Variants
companion — companion
The player beside the claim it proves.
<!-- _class: video companion -->
## companion seats the player beside its pitch.
Ninety seconds, unscripted: signup to a published deck without touching support.
- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- Ree A., Head of Ops at Northwind `caption`
- video-poster.svg `poster`gallery — gallery
A contained, matted exhibit.
<!-- _class: video gallery -->
## gallery mats the player like an exhibit.
- https://vimeo.com/1084537
- The reference onboarding walkthrough, contained on its matte. `caption`
- video-poster.svg `poster`qr — qr
Adds a scannable code; combines with any look.
<!-- _class: video companion qr -->
## qr hands the video to the room’s phones.
The full 90-second tour — scan to open it on your phone.
- https://www.youtube.com/watch?v=aqz-KE-bpKQ
- Scan to watch `caption`
- video-poster.svg `poster`