Anatomy of a VibeDeck File

Two layers, one file

A VibeDeck file has just two layers: the deck frontmatter at the very top, then a series of cards.

It's all plain markdown — no proprietary format, and no special editor required.

The fence

Blocks are separated by a line containing exactly three dashes: ---.

The first fenced block is the deck frontmatter. After that, blocks come in pairs — a card's frontmatter, then that card's body.

Because the three-dash line is the separator, a card body can't contain one. Want a horizontal rule inside a card? Use *** instead.

Deck frontmatter

The opening block is YAML that describes the whole deck. Five fields are required:

• title — the deck's name
• author — who made it
• topic — groups the deck in the library
• keywords — a list, e.g. [markdown, reference]
• theme — the visual style (you're reading operazione-stile)

Plus the optional description — a one-line summary for index listings.

Optional: behavior switches

Three more optional frontmatter fields tune how the deck behaves:

• visibility — public (listed), unlisted (link-only), or private (only you)
• transition — the card-change animation: slide, fade, or none
• reveal: bullets — bullet lists reveal one item per advance, so each point lands before the next appears

A card

Each card is a tiny frontmatter block followed by a markdown body. The card frontmatter only needs one field:

type: concept

Everything after it, until the next fence, is the card's body — ordinary markdown: headings, lists, emphasis, links, and images.