Control flow

Loops and conditions decide whether the Markdown inside them appears, and how many times. They're template directives, so they're usually written in <{ }> and they don't do write-back.

Loops

Loop over a list with for:, which repeats its Markdown for each item, filling in variables like {tag}:

<{ for: tag in: tags }>
- {tag}
<{ :for }>

Loop over a hash by its keys and values, like links in the front matter:

---
links:
  docs: https://raindown.dev
  code: https://github.com/rainpour/raindown
---

<{ for: name, url in: links }>
- [{name}]({url})
<{ :for }>

To loop over your project's files, use a list block.

Conditions

Render a block only when a value is true with if::

<{ if: draft }>
This is a draft.
<{ :if }>

A value can be nested, like if: author.name. Only false and missing values are false, so 0, empty text and empty lists count as true.

Render order

Variables, loops and conditions render before the Markdown does, like Liquid in Jekyll. So a loop's lines make one list or table, and a value can contain Markdown like *emphasis*.