@aivorynet/slaide 1.0.0

package/skills/slaide/examples/branded-deck.slaide

@@ -0,0 +1,198 @@
+---
+master: ./vela.slaide.yaml
+title: Vela
+company: Vela, Inc.
+date: "2026"
+author: Vela team
+~transition: fade
+---
+layout: cover
+---
+:: brand ::
+```svg
+<svg width="150" height="42" viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>
+```
+
+:: title ::
+[Smart Route]{.grad}
+
+:: sub ::
+The spot market for AI compute
+
+:: diagram ::
+![Routing diagram](assets/diagram.svg)
+
+---
+layout: team
+chrome: header
+---
+:: title ::
+[Hi!]{.teal} We are
+
+:: lname ::
+![Alex Rivera](assets/avatar-a.svg){.round anchor:"24% 22% 18% 32%"}
+[Alex]{.blue}<br>Rivera
+
+:: lbio ::
+Built developer tooling and inference platforms for a decade. Shipped APIs used by thousands of teams.
+
+Background across the full stack, from kernels to billing.
+
+:: rname ::
+![Sam Chen](assets/avatar-b.svg){.round anchor:"73.5% 22% 18% 32%"}
+[Sam]{.teal}<br>Chen
+
+:: rbio ::
+Software engineer and product lead. Specializes in user experience and turning messy infra into simple products.
+
+M.Sc. in distributed systems.
+
+:: logos ::
+**We worked with** &nbsp;&nbsp; ![Acme](assets/clients/acme.svg){.logo height=30px} &nbsp; ![Globex](assets/clients/globex.svg){.logo height=30px} &nbsp; ![Hooli](assets/clients/hooli.svg){.logo height=30px} &nbsp; ![Initech](assets/clients/initech.svg){.logo height=30px} &nbsp; ![Umbra](assets/clients/umbra.svg){.logo height=30px} &nbsp; ![Vandel](assets/clients/vandel.svg){.logo height=30px}
+
+---
+layout: content-aside
+footer: "We want to be **the router for compute**"
+---
+:: title ::
+We offer: [Developer Tooling In The Age of AI]{.purple}
+
+:: body ::
+| Product | Traction | Status |
+|---|---|---|
+| **Route** — smart inference | [2,000+]{.blue.lg} teams | Paying customers |
+| **Forge** — spot brokering | [300+]{.green.lg} clusters | Paid pilots |
+| **Atlas** — capacity float | [18,000+]{.purple.lg} GPUs | Paying customers |
+
+:: aside ::
+We test the market and improve the offering. So far, all organic growth.
+
+**Zero ad spend.**
+
+---
+layout: statement
+footer: "Everyone is building supply. **Nobody is routing demand.**"
+---
+:: title ::
+$765 billion in GPUs. [½ sit idle.]{.blue}
+
+:: s1 ::
+[40-80%]{.grad-purple.huge}
+
+### Capacity Idle
+
+[Inference workloads dip to 15–30% off-peak. A rack of GPUs costs $4M. At 40% utilization, half that investment earns nothing.]{.sm .muted}
+
+:: s2 ::
+[10x]{.grad-teal.huge}
+
+### Price Spread
+
+[Same GPU, same hour: $1.49 to $10.00. Up to 14.5× on spot.]{.sm .muted}
+
+:: s3 ::
+[60+]{.grad-blue.huge}
+
+### Providers
+
+[Tracked and growing. No aggregated spot market exists yet.]{.sm .muted}
+
+---
+layout: two-col
+footer: "We take a cut of the spread. **Everybody wins.**"
+---
+:: title ::
+Route the [tokens.]{.orange} Or rent the [GPU.]{.orange}
+
+:: left ::
+**Smart inference routing**
+
+Drop-in OpenAI-compatible API. **Change one line of code.** Every request scored and routed to the cheapest healthy provider, with auto-failover.
+
+**GPU spot brokering**
+
+We find and provision the **cheapest spot GPU** for your model. Same scoring, same reliability layer, automatic migration. Up to **80%+ discount**.
+
+:: right ::
+| GPU | Pool | $/hr | Trend |
+|---|---|---|---|
+| **B300** · 2100 GB | bolt | **$2.99** | ▲ 20% |
+| **B200** · 1440 GB | bolt | **$2.44** | ▲ 13% |
+| **H200** · 1128 GB | drift | **$0.60** | ▼ 5% |
+| **A100** · 640 GB | bolt | **$0.71** | ▲ 10% |
+| **H100** · 640 GB | bolt | **$1.30** | ▲ 23% |
+| **L40S** · 384 GB | bolt | **$0.55** | ▲ 37% |
+
+---
+layout: two-col
+footer: "One line of code. **Every provider.**"
+---
+:: title ::
+How [Smart Route]{.grad} works
+
+:: left ::
+```mermaid
+flowchart TD
+  C([Your app]) -->|OpenAI-compatible API| R{Smart Route}
+  R -->|cheapest healthy| A[Provider A]
+  R -->|auto-failover| B[Provider B]
+  R -->|spot broker| S[(Spot GPU pool)]
+  A --> O([Cheapest healthy token])
+  B --> O
+  S --> O
+```
+
+:: right ::
+**Drop-in.** Change one line of code. Every request is scored on **price and health**, then routed to the cheapest healthy provider.
+
+**Resilient.** Automatic failover and live migration across **60+ providers** — no lock-in, no babysitting.
+
+---
+layout: title-content
+footer: "Same GPU, same hour — **up to 10× apart.**"
+---
+:: title ::
+Spot price by GPU [($/hr)]{.muted}
+
+:: body ::
+```echart
+{
+  "grid": { "left": 64, "right": 28, "top": 28, "bottom": 48 },
+  "xAxis": { "type": "category", "data": ["L40S", "H200", "A100", "H100", "B200", "B300"] },
+  "yAxis": { "type": "value" },
+  "series": [
+    {
+      "type": "bar",
+      "data": [0.55, 0.60, 0.71, 1.30, 2.44, 2.99],
+      "barWidth": "52%",
+      "itemStyle": { "borderRadius": [10, 10, 0, 0] }
+    }
+  ]
+}
+```
+
+---
+layout: media-split
+footer: "Everyone is building supply."
+---
+:: media ::
+![Rows of servers in a data center](assets/datacenter.jpg)
+
+:: copy ::
+## $765B in racks — [half of it idle.]{.blue}
+
+The world is racing to build compute. We make the idle half **earn its keep.**
+
+[Photo by Taylor Vick on Unsplash]{.sm .muted}
+
+---
+layout: closing
+---
+:: card ::
+```svg
+<svg width="160" height="46" viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>
+```
+
+#### The router for AI compute
+
+**Vela, Inc.** · hello@vela.dev · vela.dev

package/skills/slaide/examples/branded-theme.slaide.yaml

@@ -0,0 +1,187 @@
+# yaml-language-server: $schema=https://getslaide.com/schema/v1.json
+schema: slaide/1
+name: vela
+description: A dark pitch-deck theme — Open Sans, navy ground, multi-accent gradient highlights.
+
+canvas: { aspect: "16:9", width: 1920, height: 1080 }
+
+fonts:
+  sans:    { family: "Open Sans",      provider: google, weights: [300, 400, 600, 700] }
+  display: { family: "Open Sans",      provider: google, weights: [800] }
+  mono:    { family: "IBM Plex Mono",  provider: google, weights: [400, 600] }
+
+typeScale:
+  base: "24px"
+  ratio: 1.2
+  steps:
+    stat:    "110px"
+    hero:    "80px"
+    h1:      "72px"
+    h2:      "44px"
+    h3:      "36px"
+    h4:      "28px"
+    body:    "24px"
+    caption: "22px"
+    small:   "18px"
+
+colors:
+  palette:
+    navy:   "#0B1220"
+    panel:  "#121A2B"
+    ink:    "#050810"
+    white:  "#F8FAFC"
+    muted:  "#8B93A7"
+    blue:   "#5B8CFF"
+    purple: "#A855F7"
+    teal:   "#2DD4BF"
+    green:  "#34D399"
+    orange: "#FB923C"
+    pink:   "#EC4899"
+  roles:
+    background: "{palette.navy}"
+    surface:    "{palette.panel}"
+    text:       "{palette.white}"
+    heading:    "{palette.white}"
+    accent:     "{palette.blue}"
+    link:       "{palette.blue}"
+    muted:      "{palette.muted}"
+
+gradients:
+  brand:  "linear-gradient(100deg, #5B8CFF 0%, #A855F7 50%, #2DD4BF 100%)"
+  purple: "linear-gradient(120deg, #A855F7, #EC4899)"
+  teal:   "linear-gradient(120deg, #2DD4BF, #5B8CFF)"
+  blue:   "linear-gradient(120deg, #5B8CFF, #818CF8)"
+
+tokens:
+  "--slide-padding": "120px"
+  "--chrome-pad": "120px"
+  "--chrome-top": "44px"
+  "--chrome-bottom": "44px"
+  "--chrome-size": "22px"
+  "--chrome-foot-size": "40px"
+  "--chrome-page-size": "22px"
+  "--logo-h": "34px"
+  # ordered colour cycle for ```echart data series (falls back to a default palette)
+  "--chart-colors": "#5B8CFF, #A855F7, #2DD4BF, #34D399, #FB923C, #EC4899"
+
+backgrounds:
+  navy:  { type: solid, color: "{palette.navy}" }
+  team:  { type: gradient, stops: ["#0B1220 0%", "#0B1220 50%", "#05070D 50%", "#05070D 100%"], angle: 90 }
+  paper: { type: solid, color: "#EEEFF1" }
+
+variants:
+  light:
+    roles: { background: "#EEEFF1", surface: "#FFFFFF", text: "#0B1220", heading: "#0B1220", muted: "#5A6072" }
+
+transitions: { default: fade, duration: 420 }
+
+chrome:
+  header: { right: "{{date}}  |  © {{company}}" }
+  footer: { left: "{{footer}}", right: "{{pagePadded}} / {{totalPadded}}" }
+  logoPos: top-left
+  logo: '<svg viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>'
+
+layouts:
+  cover:
+    background: navy
+    chrome: header
+    logo: false
+    align: start
+    areas: [". diagram", "brand diagram", "title diagram", "sub diagram"]
+    rows: "1fr auto auto auto"
+    cols: "1.1fr 0.9fr"
+    gap: "0.3em 3em"
+    slots:
+      brand:   { type: body, style: { align: left } }
+      title:   { type: title, style: { font: display, size: hero, weight: "800", leading: "0.98", maxw: "7ch" } }
+      sub:     { type: subtitle, style: { size: "32px", color: white, weight: "400" } }
+      diagram: { type: image, style: { valign: center } }
+
+  statement:
+    background: navy
+    align: center
+    areas: ["title title title", "s1 s2 s3"]
+    rows: "auto 1fr"
+    cols: "1fr 1fr 1fr"
+    gap: "1.4em"
+    slots:
+      title: { type: title, style: { size: "80px", weight: "800" } }
+      s1: { type: body, style: { align: center, valign: center } }
+      s2: { type: body, style: { align: center, valign: center } }
+      s3: { type: body, style: { align: center, valign: center } }
+
+  title-content:
+    background: navy
+    areas: ["title", "body"]
+    rows: "auto 1fr"
+    slots:
+      title: { type: title, style: { size: h1, weight: "800" } }
+      body:  { type: body }
+
+  content-aside:
+    background: navy
+    areas: ["title title", "body aside"]
+    rows: "auto 1fr"
+    cols: "1.45fr 1fr"
+    gap: "3em"
+    slots:
+      title: { type: title, style: { size: h1, weight: "800" } }
+      body:  { type: body }
+      aside: { type: body, style: { color: muted, size: caption } }
+
+  two-col:
+    background: navy
+    areas: ["title title", "left right"]
+    rows: "auto 1fr"
+    cols: "1fr 1fr"
+    gap: "3em"
+    slots:
+      title: { type: title, style: { size: h1, weight: "800" } }
+      left:  { type: body }
+      right: { type: body }
+
+  team:
+    background: team
+    areas:
+      - "title title"
+      - "lname rname"
+      - "lbio  rbio"
+      - "logos logos"
+    rows: "auto 400px 1fr auto"
+    cols: "1fr 1fr"
+    gap: "0.2em 2.4em"
+    slots:
+      title: { type: title, style: { size: "54px", weight: "800" } }
+      lname: { type: title, style: { size: "72px", weight: "800", leading: "0.95", valign: center } }
+      lbio:  { type: body,  style: { size: "28px", color: muted, valign: top } }
+      rname: { type: title, style: { size: "72px", weight: "800", leading: "0.95", valign: center } }
+      rbio:  { type: body,  style: { size: "28px", color: muted, valign: top } }
+      logos: { type: body,  style: { valign: bottom } }
+
+  closing:
+    chrome: false
+    background: paper
+    align: center
+    areas: ["card"]
+    rows: "1fr"
+    cols: "1fr"
+    slots:
+      card: { type: body, style: { box: ink, color: white, align: center, valign: center, justify: center, maxw: "60%" } }
+
+  section:
+    background: navy
+    align: center
+    areas: ["title"]
+    rows: "1fr"
+    slots:
+      title: { type: title, style: { size: hero, weight: "800", align: center } }
+
+  media-split:
+    background: navy
+    areas: ["media copy"]
+    rows: "1fr"
+    cols: "1.25fr 1fr"
+    gap: "3.4em"
+    slots:
+      media: { type: media }
+      copy:  { type: body, style: { valign: center } }

package/skills/slaide/examples/sample.slaide

@@ -0,0 +1,98 @@
+---
+master: ../themes/aurora.slaide.yaml
+title: slaide — Q3 Roadmap
+author: The slaide team
+~transition: slide-left
+---
+layout: cover
+transition: fade
+---
+:: title ::
+slaide
+
+:: subtitle ::
+slides that AI can actually write — and humans love to watch
+
+??? Open warm. The whole pitch: plain text in, beautiful deck out.
+
+---
+layout: title-content
+---
+## Why a new language
+
+- PowerPoint's `.pptx` is a zip of namespaced XML — **bulky and overloaded**   >>>
+- Markdown is what language models write most reliably   >>>
+- A forgiving parser means **no broken decks**   >>>
+- One small header defines the entire visual system   >>>
+
+??? Land the contrast: OOXML vs. a single readable file.
+
+---
+layout: two-cols
+---
+:: title ::
+## Input vs. output
+
+:: left ::
+**You write this**
+
+```
+---
+layout: image-right
+---
+## The pipeline
+1. Parse
+2. Compile
+3. Render
+```
+
+:: right ::
+**Your audience sees**
+
+> A typographic, animated, full-bleed presentation — on the web or as a crisp PDF.
+
+---
+layout: image-right
+morph: hero
+---
+:: title ::
+## The pipeline
+
+:: body ::
+1. **Parse** the deck + master   >>>
+2. **Compile** to a portable IR   >>>
+3. **Validate** against the schema   >>>
+4. **Render** to web or PDF   >>>
+
+:: image ::
+![Pipeline diagram](./assets/pipeline.svg){#hero}
+
+---
+layout: image-left
+transition: morph
+---
+:: title ::
+## One IR, many renderers
+
+:: image ::
+![Pipeline diagram](./assets/pipeline.svg){#hero}
+
+:: body ::
+The compiled **deck.ir.json** is the durable asset.
+
+Web and PDF are just *consumers* of it — so they can never drift apart.
+
+---
+layout: quote
+variant: light
+transition: zoom
+---
+:: quote ::
+> "The best format is the one your tools can write flawlessly **and** your audience never thinks about."
+
+---
+layout: section
+transition: zoom
+---
+:: title ::
+Let's build.

package/skills/slaide/reference.md

@@ -0,0 +1,177 @@
+# slaide language specification (v1)
+
+A **deck** is one UTF-8 `.slaide` file: a deck *headmatter* block + one or more slides. Styling lives in a separate reusable **master** (`*.slaide.yaml`, see [themes.md](themes.md)). Write plain Markdown; reference layouts / colours / fonts / classes **by name** from the master. Reach for explicit positioning (`anchor`, `valign`) only when a layout can't express it.
+
+## 1. File structure
+
+```
+---                         ← deck HEADMATTER (deck-wide config)
+master: ./theme.slaide.yaml
+title: My Talk
+company: Acme, Inc.          ← any scalar key → {{placeholder}}
+~transition: slide-left      ← `~` cascades this default to later slides
+---
+layout: cover                ← per-slide FRONTMATTER
+footer: Hello world
+---
+:: title ::                  ← route Markdown into slot "title"
+My Talk
+---                          ← slide separator
+## A content slide           ← no frontmatter; body → main slot
+- point one    >>>           ← `>>>` reveals as a build step
+??? Speaker note (hidden from the audience).
+```
+
+- A line that is exactly `---` separates slides. The **first** config block is headmatter; after a separator, a block is **frontmatter** *iff* it is `key:`-only **and** closed by another `---` before the body — else it's body. (A body first line that merely contains a colon, `We offer: Tooling`, stays body. To force body: an empty frontmatter `---`/`---`, or escape the line `\Name: Acme`.) Malformed config → `bad-config` warning.
+- **Code fences are sigil-safe:** inside ``` / `~~~` everything is literal — sigils (`---`, `:: name ::`, `??? …`, `>>>`), spans, and `![img]` show verbatim, so a deck can show its own source. Outside fences, escape one line with a leading `\`.
+- **Packaging:** the editable form is a folder (deck + master + `assets/`). `slaide pack` zips it into one `.slaidec`; `unpack` reverses. Same language, read transparently; archive is deterministic.
+
+## 2. Headmatter keys
+
+| Key | Meaning |
+|---|---|
+| `master` | Path to the master (relative to the deck). Omit → bundled default theme. |
+| `title`, `author`, `date`, `company`, … | Metadata. **Any** scalar key here → a `{{placeholder}}` (§7). |
+| `~<key>` | Set a **cascading default** from here onward (e.g. `~transition: fade`). |
+| `progress` | `true`/`false` — web position bar + counter (default `true`; web only, never PDF). |
+
+## 3. Per-slide frontmatter keys
+
+| Key | Values | Meaning |
+|---|---|---|
+| `layout` | a master layout name | Which grid to use. |
+| `transition` | `none`,`fade`,`slide-left/right/up/down`,`zoom`,`morph` | Transition **into** this slide. |
+| `background` | a master background name | Override the layout's background. |
+| `variant` | a master variant name | Scoped token overrides (e.g. a light section). |
+| `morph` | an id | Participate in a shared-element morph. |
+| `footer` | inline Markdown | Per-slide footer; also `{{footer}}`. |
+| `chrome` | `both`,`header`,`footer`,`none`,`false` | Header/footer visibility this slide. |
+| `logo` | `false` | Hide the corner logo this slide. |
+| *any other scalar* | — | Available as a `{{placeholder}}`. |
+
+**Cascade vs scope:** a bare key (`transition: zoom`) is this-slide-only; a `~`-prefixed key cascades to this slide and every later one until overridden (also valid in headmatter).
+
+## 4. Slide body
+
+- **Regions:** `:: name ::` on its own line routes following Markdown into slot `name`. Text before any marker → the main slot (`body`, else the first slot).
+- **Markdown:** standard CommonMark — headings, lists, **bold**, *italic*, `code`, fences, > quotes, links, tables, images. (A single newline is a space; blank line = new paragraph.)
+- **Builds `>>>`:** end an item/block with `>>>` to reveal it; steps auto-number in order, same step = simultaneous. PDF shows all.
+- **Notes `??? …`:** a `???` line (until a blank line) is a speaker note — presenter overlay only, hidden from audience and PDF.
+
+### 4.1 Inline styled spans — `[text]{.class …}`
+
+Wrap inline text with one or more chainable dot-classes:
+
+```
+[Smart Inference]{.grad}   [40-80%]{.grad-purple .huge}   [300+]{.green .lg}   [caption]{.sm .muted}
+```
+
+| Class | Effect |
+|---|---|
+| `.<color>` | text colour — any `palette` key or `roles` name (`.blue`, `.accent`, `.muted`), or a raw hex/CSS colour as an escape hatch (`.#3366ff`, `.tomato`) — palette names preferred |
+| `.grad` / `.grad-<name>` | fill text with the `brand` / a named gradient |
+| `.xs .sm .md .lg .xl .xxl .huge` | font size (type-scale steps small→…→stat) |
+| `.bold` / `.muted` | weight 800 / muted colour |
+
+An unknown class warns (`unknown-class`/`unknown-gradient`) — it never silently degrades. Resolved against the master (see [themes.md](themes.md#marks--utility-classes)).
+
+### 4.2 Images — `![alt](src){ … }`
+
+Local paths are inlined (portable single file). The `{…}` brace mixes, any order:
+
+| Token | Meaning |
+|---|---|
+| `#id` | morph target — same id on the next slide morphs into it (`transition: morph`) |
+| `.class` | `.round` (circular), `.cover` (fill+crop), `.shadow` |
+| `width=170px` / `height=…` | explicit size (bare `key=value`, units ok, unquoted) |
+| `anchor: "x% y% w% h%"` | absolute placement in the slot (quoted) |
+
+Example: `![Paul](paul.jpg){.round width=170px}`
+
+### 4.3 Video, audio, embeds
+
+Image syntax + a media extension: `![alt](clip.mp4){ poster=cover.jpg }` → `<video controls>` (add `.autoplay` for muted looping bg); `![alt](track.mp3)` → `<audio>`. In PDF, video → its `poster` (always supply one), audio omitted. Local media inlined up to ~6 MB. For dynamic content (never run in the doc): ` ```embed ` (one URL → sandboxed iframe) and ` ```widget ` (inline HTML/JS → `sandbox="allow-scripts"` srcdoc, theme tokens injected). Both degrade to a static note in PDF.
+
+### 4.4 Inline SVG — ` ```svg `
+
+A fence tagged `svg` renders as a **vector** (inherits theme colour via `currentColor`). **Give it explicit `width`/`height`** — a zero-intrinsic-size SVG in a centered slot collapses and vanishes silently.
+
+### 4.5 Charts — ` ```mermaid ` / ` ```echart `
+
+Both render to **theme-coloured inline SVG** (web/PDF/PNG/PPTX); `slaide build` bakes them to static SVG with no engine left in the file.
+- ` ```mermaid ` — diagrams (flowchart, sequence, state, ER, gantt). Match shape to slot: `flowchart TD` tall, `LR` wide.
+- ` ```echart ` — ECharts `option` as JSON/YAML; best for data viz. Validated (bad option → `bad-chart` + code-block fallback). Series colours from the master `--chart-colors`.
+
+**Put a chart in a slot with height (a `1fr` row, not `auto`)** or it collapses to a default aspect.
+
+```echart
+{ "xAxis": { "type": "category", "data": ["A","B","C"] },
+  "yAxis": { "type": "value" },
+  "series": [{ "type": "bar", "data": [5,9,7] }] }
+```
+
+### 4.6 Tables
+
+GFM pipe tables, styled by the master; use `[cell]{.class}` spans for emphasis.
+
+## 5. Layers
+
+Each slide composites **background → content → chrome** by paint order. Backgrounds come from the master (per layout or per slide); content flows through the layout's named slots; chrome sits on top.
+
+## 6. Chrome
+
+Defined in the master `chrome:` block (see [themes.md](themes.md#chrome)): header/footer are three-cell bands (`left`/`center`/`right`) with `{{placeholders}}`; a corner `logo` (inline SVG) sits in a chosen corner. Page numbers = `{{page}}`/`{{total}}` in a band. Per-slide `footer:`/`chrome:`/`logo:` override.
+
+## 7. Placeholders — `{{ … }}`
+
+Resolved at compile time in chrome bands and master text. Built-ins + every scalar headmatter/frontmatter key:
+
+| Placeholder | Value |
+|---|---|
+| `{{page}}` / `{{total}}` | 1-based index / count |
+| `{{pagePadded}}` / `{{totalPadded}}` | zero-padded (`05` / `08`) |
+| `{{date}}` | `date:`, else today |
+| `{{title}}` / `{{author}}` / `{{slideTitle}}` | from headmatter / the slide's first heading |
+| `{{footer}}` / `{{<anyKey>}}` | the slide's `footer:` / any scalar key (`{{company}}`) |
+
+Unknown names → empty (with a warning).
+
+## 8. Reserved sigils (cheat sheet)
+
+| Token | Where | Meaning |
+|---|---|---|
+| `---` | line | slide separator / config fence (outside code fences) |
+| `:: name ::` | line | slot marker |
+| `>>>` | line end | build step |
+| `???` | line start | speaker note |
+| `~key:` | frontmatter | cascading default |
+| `[t]{.c}` | inline | styled span |
+| `{#id .c k=v anchor:"…"}` | after image | attributes |
+| `{{name}}` | chrome/master | placeholder |
+| ` ```svg ` / ` ```embed ` / ` ```widget ` | fence | vector / sandboxed iframe |
+| ` ```mermaid ` / ` ```echart ` | fence | chart → inline SVG |
+| `\` (leading) | before a sigil | escape to literal |
+
+## 9. Minimal example
+
+```
+---
+master: ./aurora.slaide.yaml
+title: Hello
+---
+layout: cover
+---
+:: title ::
+[Hello, world]{.grad}
+:: subtitle ::
+written in slaide
+---
+layout: title-content
+footer: A first deck
+---
+## Why it's nice
+- Plain text in    >>>
+- Beautiful out    >>>
+```
+
+See [themes.md](themes.md) to author a master.