Anatomy of a flow

A flow is a Markdown document. Write whatever you want — headings, prose, lists, links, images — and turn any part of it into an executable step with a fenced code block tagged as step.

---
title: Fraud detection
description: A payment above the limit is held for review
---

# Fraud detection

Any prose you want. Then, an executable step:

```step
application: payments
method: pay
parameters:
  body:
    amount: 5000
test:
  status: 402
```

Frontmatter (the optional YAML block at the top) carries the flow-level metadata: title, description, version, latentApplications, xray — plus any other property you want to keep on the flow. See Properties. When there is no frontmatter title, the first # heading is used.

Regular code blocks (js`, bash…) are **not** steps: only step` blocks are executed. Everything else is documentation, and is rendered as such.

Legacy YAML flows (.yaml / .yml files with a steps: list) still work and are rendered in the same notebook UI.