Content schema — authoring content.md

A content.md is a flat list of blocks. Each block starts with @<alias>: <variant> then field: value lines. The generator turns each block into one slide: the alias + variant pick the layout, the fields fill its placeholders. Field names per layout are in references/layout-map.md.

A complete example

@cover: Master title - Blue
title: Market Entry Readiness
subtitle: Advisory · June 2026

@disclaimer

@section: Light Blue
subhead: Part One
title: The Landscape
subtitle: Where things stand today

@content: 1 text
title: Three forces are converging
subtitle: Protocols, platforms, demand
body:
# Why now
- Standards reached production readiness
- Major platforms shipped new surfaces
  - Two reference implementations are live
- Buyer demand is pulling adoption forward

@content: 2 text
title: First-party vs third-party
body1:
# First-party
- On your own channels
body2:
# Third-party
- External assistants act for the buyer

@thankyou: Blue

Block aliases

Alias	What it makes
@cover	Title slide. Variant = exact cover layout name. Fields: title, subtitle.
@disclaimer	Canned confidentiality notice on the 1 text layout. No fields needed — edit the placeholder text in scripts/generate_deck.py.
@section	Section divider. Variant = Blue · Medium Blue · Light Blue. Fields: subhead, title, subtitle.
@content	Variant = exact layout name (1 text, 2 text, 1 text, 1 content…). Fields: title, subtitle, body1..N, content1..N.
@blank	Variant = White · Blue · Med Blue · Light Blue. Fields: title, subtitle.
@thankyou / @qa	Closing slides. Variant = Blue or White. Text is baked into the layout — no fields.
@quote / @bigstatement	Variant appended to the family name. Field: body1.

For any other layout, use its exact name as the variant after @content:.

Field rules

• Single-line fields: title, subtitle, subhead, source.
• Body fields (body, body1, body2, content1…) take a block of lines that follow on subsequent rows, until the next field: or @block.
• Bare body maps to body1; left/right map to body1/body2.

Body line syntax

Inside a body field:

• # text — a heading (outline level 0).
• - text — a bullet (level 1).
• Two-space indent per extra level — - text is level 2, - text level 3.

A level-0 line inherits the template's plain body style, not a distinct heading treatment — see the generator's known limitations.

Picture and object placeholders

picture1..N and content1..N (object) placeholders hold images or charts, not text. The generator leaves them empty and warns. Fill them in PowerPoint after generating, or extend the generator to insert media.