Conceitos

Esta página apresenta as ideias principais do Folio. Cada seção aponta para o guia com os detalhes.

Projetos e apresentações

Um projeto agrupa apresentações relacionadas, como as de um cliente, de uma disciplina ou de uma equipe. Cada projeto pode ter um tema próprio, que vale para todas as suas apresentações.

Uma apresentação é um texto. O título que aparece na barra lateral vem da definição @title no início do texto. Sem ela, a apresentação aparece como Sem título.

Na barra lateral, use Novo projeto para criar um projeto. Passe o mouse sobre um projeto para criar uma Nova apresentação, renomear ou excluir.

Definições e slides

O texto de uma apresentação tem duas partes:

• Definições, no topo, em linhas que começam com @: título, tema, cores, fontes, estilos e componentes.
• Slides, logo depois. O primeiro conteúdo começa o slide 1, e cada linha com --- começa um novo slide.

@title Planejamento 2026
@theme paper

# Planejamento 2026
Metas, prazos e responsáveis.

---
# Metas
- Ampliar a base de clientes
- Reduzir o tempo de atendimento

A linha --- também aceita atributos que configuram o slide inteiro, como --- {.dark align=center}. Veja Layouts.

Editor, prévia e miniaturas

A tela de edição tem três partes que trabalham juntas:

Parte	O que faz
Editor	Onde você escreve. Erros e avisos aparecem sublinhados e listados no painel inferior, com a linha e uma dica de correção.
Prévia	Mostra o slide em que o cursor está e atualiza enquanto você digita. Clique em um elemento para levar o cursor até a linha dele.
Miniaturas	Ficam abaixo da prévia e mostram todos os slides, para você navegar pela apresentação.

Um erro não impede o resto da apresentação de aparecer: o Folio desenha tudo o que consegue e indica exatamente o que precisa ser corrigido. A lista completa de códigos está em Mensagens de erro.

Salvamento automático

Você não precisa salvar. O Folio salva o texto logo depois que você para de digitar, inclusive quando ele ainda tem erros, para não perder o rascunho.

O indicador no topo do editor mostra a situação:

Indicador	Significado
Salvo	Tudo o que você escreveu está guardado.
Alterações não salvas	Há mudanças esperando para serem salvas.
Salvando…	O texto está sendo enviado.
Erro ao salvar — tentando de novo	Não foi possível salvar, por exemplo sem conexão. O Folio tenta de novo sozinho.
Conflito de versões	A apresentação mudou em outro lugar. Veja a próxima seção.

Conflitos entre abas

Se a mesma apresentação estiver aberta em duas abas ou dois dispositivos, uma pode salvar por cima da outra. Para evitar isso, o Folio detecta quando o texto mudou em outro lugar, pausa o salvamento e mostra o aviso Conflito de versões com duas opções:

• Usar a versão salva: descarta as suas mudanças nesta aba e carrega o texto salvo.
• Manter a minha: salva o texto desta aba por cima da versão salva.

Dica

Na dúvida, escolha Manter a minha apenas se tiver certeza de que esta aba tem a versão mais recente. A outra versão continua disponível no histórico.

Histórico de versões

O Folio guarda versões da apresentação enquanto você trabalha. Abra o painel pelo botão Histórico de versões, no topo do editor, para ver as versões, navegar pelos slides de cada uma e restaurar a que quiser.

Há três tipos de versão:

Tipo	Quando é criada
Automática	Periodicamente, enquanto você edita.
Nomeada	Quando você dá um nome à versão atual com Salvar versão.
Antes de restaurar	Logo antes de uma restauração, para que você possa desfazê-la.

Veja os detalhes em Histórico.

Tema do projeto

O tema do projeto é um texto só com definições (@theme, @color, @font, @style e @component) que vale para todas as apresentações do projeto. Ele é aberto pelo ícone de paleta, Tema do projeto, ao lado do nome do projeto na barra lateral.

Cada apresentação pode sobrescrever o que quiser do tema do projeto. Veja Temas.

Imagens enviadas

Além de imagens da internet, você pode enviar imagens para o projeto com o botão Inserir imagem, arrastando um arquivo para o editor ou colando uma imagem. O Folio insere no texto uma referência no formato asset: seguida de um identificador, que funciona em qualquer apresentação do projeto.

Formatos aceitos e limites estão em Imagens.

Próximos passos

• Escrevendo slides: tudo o que você pode escrever em um slide.
• Layouts: colunas, grades e alinhamento.
• Apresentando: tela cheia, modo apresentador e PDF.