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.
When they fire
Section titled “When they fire”Autoflow runs three skip checks before any rule. If any check passes, autoflow leaves the slide untouched.
| Check | Trigger |
|---|---|
explicit | Slide 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 |
code | Slide contains a fenced code block (```) |
custom-block | Slide contains a :::columns, :::diagram, :::steps, :::center, or :::math block |
The user already told autoflow what they want. Don’t override intent.
Explicit images are not an opt-out
Section titled “Explicit images are not an opt-out”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'].
Live fixture
Section titled “Live fixture”Source
Section titled “Source”footer: autoflow skip checksslidenumbers: trueautoflow: truetheme: nordicscheme: 1
# Cover
These slides demonstrate the SKIP CHECKS that bypass autoflow entirely.
---
<!--SKIP: explicitThe 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: codeA code block is a strong signal of intent — don't reflow it.-->
# A code example
```jsfunction sum(a, b) { return a + b;}```
---
<!--SKIP: custom-block:::columns / :::diagram / :::steps / :::center / :::mathall bypass autoflow because they're explicit layouts.-->
# Two columns
:::columnsFirst column with some text that lays out beside the next.
Second column with different text.:::
---
<!--NOT A SKIP: explicit image + textAn 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.-->

The image is mine.The words are autoflow's.