Revelação por etapas

Markdown para LLMs (em inglês)llms.txt

Revelar por etapas ajuda o público a acompanhar o raciocínio: cada ponto aparece quando você chega nele, e não todos de uma vez. No Folio há duas formas de fazer isso: o bloco ::: steps e o atributo step.

O bloco `steps`

Tudo o que estiver dentro de ::: steps aparece em ordem, um por vez, a cada avanço:

# Por que mudar agora
::: steps {gap=md}
Os custos de operação subiram 18% em um ano.

A concorrência já automatizou o atendimento.

Os clientes pedem respostas no mesmo dia.
:::

Cada bloco filho (um parágrafo, um título, uma imagem, outro bloco) é uma etapa.

Listas

Quando o filho é uma lista, cada item vira uma etapa:

# Plano para o semestre
::: steps
- Mapear os processos atuais
- Escolher as ferramentas
- Treinar as equipes
- Medir os resultados
:::

O bloco steps organiza os filhos numa pilha vertical e aceita os mesmos atributos de ::: stack, como gap e align.

Etapas explícitas com `step`

Para controlar a ordem você mesmo, use o atributo step=N em qualquer bloco. O bloco aparece na etapa N:

::: columns {gap=xl}
::: box {.card}
## Hoje
Relatórios montados à mão, uma vez por mês.
:::
::: box {.card step=1}
## Em seis meses
Relatórios automáticos, atualizados todos os dias.
:::
:::

O atributo também funciona em:

itens de lista: - Terceiro ponto {step=3};
trechos de texto: A meta é [dobrar a receita]{step=1 color=accent}.;
componentes: :: metrica {valor=38% rotulo="crescimento" step=2}.

# Meta para 2027
A receita foi de R$ 12 milhões. [A meta é chegar a R$ 20 milhões.]{step=1 color=accent weight=bold}

O número da etapa vai de 1 a 99. Vários elementos com o mesmo número aparecem juntos.

Como as etapas se combinam

Elementos sem etapa ficam visíveis desde o início do slide.
O slide tem tantas etapas quanto o maior número usado nele.
Um ::: steps continua a contagem a partir da maior etapa que já apareceu antes dele no slide. Se um título tem {step=2} e logo depois vem um ::: steps com três itens, os itens ficam nas etapas 3, 4 e 5.
Dentro de um ::: steps, a ordem é definida pelo próprio bloco. Não use step nos filhos diretos dele.

# Resultados {step=1}
::: steps
- Receita: +38%
- Clientes: +94
- Satisfação: 4,8
:::

Neste exemplo, o título aparece na etapa 1 e os itens nas etapas 2, 3 e 4.

Navegando pelas etapas

Ao apresentar, cada avanço mostra a próxima etapa do slide atual. Quando todas já apareceram, o próximo avanço vai para o slide seguinte.

→, Espaço ou um clique avançam uma etapa.
← volta uma etapa. Voltando do começo de um slide, você chega ao slide anterior já com todas as etapas reveladas.
O rodapé do modo Apresentar mostra a etapa atual, como 3 / 10 · etapa 2/4.
No modo Apresentador, o quadro lateral mostra a Próxima etapa enquanto houver etapas no slide atual.

Veja todos os atalhos em Apresentando.

Erros comuns

Código	Quando acontece
F301	`step` sem valor ou com um valor que não é um número inteiro de 1 a 99, como `{step}`, `step=0` ou `step=a`.