gog slides create-from-markdown accepts both vanilla and slidey-flavored
markdown. Slidey conventions are documented here.
Each slide may begin with a YAML frontmatter block. Recognized keys:
| Key | Values | Behavior |
|---|---|---|
layout |
title, hero, statement, center, default, two-cols, three-cols |
Picks the slide's visual treatment. Unknown values fall back to default. |
content |
wide, narrow |
Parsed but not yet applied (Slides has fixed text-box widths). |
---
layout: hero
---
# univrs
Unfolding Nested Intent · Valid · Reliable · Safe
A bare --- line is a slide separator unless it opens a contiguous YAML
header: key-value lines followed by a closing --- before any blank/body line.
A trailing ## Notes (or ### Notes) section becomes the slide's speaker
notes. The heading and everything after it are removed from the body. FA
icon shortcodes inside notes are stripped to plain text.
## Topic
body
## Notes
- speaker hint one
- speaker hint two
Inline shortcodes :fa-name:, :fas-name:, :far-name:, :fab-name:,
:fal-name:, :fad-name: resolve to FA Free SVGs fetched from
cdn.jsdelivr.net, rasterized locally with rsvg-convert or ImageMagick, and
inserted as PNG images. If no SVG rasterizer is available, icons are skipped
with a warning; --strict makes that fatal. Style derivation:
| Prefix | Resolved style |
|---|---|
fa- |
--fa-style (default solid) |
fas- |
solid |
far- |
regular |
fab- |
brands |
fal-, fad- |
solid (FA Free has no light/duotone) |
Icons placed at the start of a bullet item render as a small inline image to the left of the bullet text. Mid-paragraph icons are dropped.
Fenced code blocks tagged mermaid are rendered to PNG via the local
mmdc binary (configurable with --mmdc) and inserted as a full-width
image. If mmdc is missing, the diagram is skipped with a warning;
--strict makes it fatal.
::cols::
left column markdown
::col2::
middle / right column markdown
::col3::
third column markdown
::/cols::
::right:: is accepted as a synonym for ::col2:: (slidey-style).
In layout: two-cols and layout: three-cols slides, ::col2::,
::col3::, and ::right:: may also be used without an opening ::cols::;
the content after the slide title becomes the first column.
::boxes::
:fa-rectangle-ad: Campaigns
:fa-headset: Support Tickets
::/boxes::
::arrows::
### Step One
### Step Two
::/arrows::
Both render as bulleted lists in the body. Boxes use bullet glyphs;
arrows use →.