Skip to content

Autoflow rule: skip checks

When autoflow does NOTHING — text you laid out yourself, code, custom blocks. An explicit image with text is NOT a skip.

Autoflow runs three skip checks before any rule. If any check passes, autoflow leaves the slide untouched.

CheckTrigger
explicitSlide already lays out its text: #[fit], position modifiers, [.autoscale], or [.alternating-colors]. Or an explicit image with no text, or one autoflow can’t lay text around
codeSlide contains a fenced code block (```)
custom-blockSlide contains a :::columns, :::diagram, :::steps, :::center, or :::math block

The user already told autoflow what they want. Don’t override intent.

An explicit image (![left], ![right], ![fit], ![filtered]) is a decision about the image, not about the words. When it’s a split or a background and there’s text beside it, the image line stays exactly as written and the text still goes through the rules: a short line next to ![right] becomes a statement. Layouts that need the whole slide (diagonal, z-pattern, alternating colors) sit out on split slides; they declare skipIfDirective: ['split-image'].

footer: autoflow skip checks
slidenumbers: true
autoflow: true
theme: nordic
scheme: 1
# Cover
These slides demonstrate the SKIP CHECKS that bypass autoflow entirely.
---
<!--
SKIP: explicit
The slide already has explicit layout directives, so autoflow does nothing.
The user knows what they want.
-->
#[fit] I asked for #[fit] explicitly
Autoflow won't touch this slide.
---
<!--
SKIP: code
A code block is a strong signal of intent — don't reflow it.
-->
# A code example
```js
function sum(a, b) {
return a + b;
}
```
---
<!--
SKIP: custom-block
:::columns / :::diagram / :::steps / :::center / :::math
all bypass autoflow because they're explicit layouts.
-->
# Two columns
:::columns
First column with some text that lays out beside the next.
Second column with different text.
:::
---
<!--
NOT A SKIP: explicit image + text
An explicit image is about the image. `![right]` stays exactly as written,
and the text beside it still goes through autoflow (here: statement).
Whole-slide layouts (diagonal, z-pattern, alternating) sit out on splits.
-->
![right](/demo/images/coaches/yuval-ayalon.webp)
The image is mine.
The words are autoflow's.