← Blog

Blog Sanctuary

Como transformar Markdown em slides de apresentação online

Converta documentos Markdown em slides de apresentação no navegador usando os títulos como divisores. Sem exportar, sem instalar ferramentas externas.

Atualizado
markdownslidesapresentacaotutorial

Neste artigo
  1. Como funciona o modo slides
  2. Como estruturar o Markdown para apresentações
  3. Próximos passos

Documentos Markdown com boa estrutura de títulos podem ser transformados em apresentações sem nenhum trabalho extra de formatação. Se o arquivo já tem # e ## organizando o conteúdo, basta ativar o modo slides para apresentar.

O Sanctuary Reader converte qualquer documento Markdown em slides diretamente no navegador, usando cada seção de título como um slide separado.

Como funciona o modo slides

O modo de apresentação do Sanctuary Reader divide o documento pelos títulos H2 (##) e H3 (###) e exibe cada seção como um slide individual em tela cheia. A navegação acontece pelo teclado ou pelos controles na tela. Se o documento não tiver H2 ou H3, o conteúdo inteiro é exibido como um único slide.

Para ativar:

  1. Abra um documento Markdown no Sanctuary Reader
  2. Clique no botão Slides na barra de ferramentas (ícone de retângulo)
  3. O modo apresentação é ativado com o primeiro slide em tela cheia
  4. Navegue com as setas do teclado ou com os botões na tela

Para sair do modo slides, pressione Esc ou clique no botão de fechar.

Como estruturar o Markdown para apresentações

A estrutura do documento define diretamente a estrutura dos slides. Cada título H2 (##) ou H3 (###) cria um novo slide. O H1 (#) funciona como título geral do documento.

Exemplo de estrutura:

# Título da Apresentação

Subtítulo ou descrição breve

## Problema

- Ponto 1
- Ponto 2
- Ponto 3

## Solução proposta

Descrição da solução com **destaques** importantes.

## Arquitetura

```mermaid
flowchart LR
    A[Cliente] --> B[API] --> C[Banco de dados]

Próximos passos

  1. Etapa 1
  2. Etapa 2
  3. Etapa 3

Nesse exemplo, cada bloco de `##` vira um slide. O conteúdo dentro de cada seção — texto, listas, tabelas, diagramas — é exibido normalmente no slide correspondente.

## Vantagens de apresentar a partir de Markdown

### O conteúdo existe uma vez

Você não precisa manter sincronizados um documento de referência e uma apresentação separada. O mesmo arquivo `.md` serve para leitura, revisão e apresentação. Quando o conteúdo muda, a apresentação reflete a mudança automaticamente.

### Versionamento natural

Arquivos Markdown ficam bem em Git. Você pode versionar as mudanças na apresentação junto com o restante da documentação, comparar versões e reverter se necessário.

### Sem ferramentas de apresentação

PowerPoint, Keynote e Google Slides têm curvas de aprendizado, formatos proprietários e limitações para conteúdo técnico como código e diagramas. Markdown não tem nenhum desses problemas.

### Diagramas técnicos inline

Blocos [Mermaid](/blog/markdown-com-mermaid-diagramas-online/) são renderizados diretamente nos slides. Um diagrama de arquitetura ou fluxo de processo aparece no slide correspondente sem precisar ser exportado como imagem.

## Casos de uso práticos

**Revisões técnicas**: Um RFC ou especificação técnica com boa estrutura de títulos pode ser apresentado diretamente sem preparação extra.

**Aulas e treinamentos**: Materiais de curso em Markdown funcionam como apresentação e como referência de estudo no mesmo arquivo.

**Demonstrações de projeto**: READMEs estruturados de projetos open source frequentemente já têm a estrutura adequada para uma apresentação de 5 a 10 slides.

**Reuniões de status**: Um documento de atualização com seções de progresso, bloqueios e próximos passos se torna uma apresentação de status diretamente.

## Como preparar o arquivo para slides

Algumas boas práticas ao escrever Markdown pensando em apresentação:

- **Use títulos de 2º nível (`##`)** como divisores principais de slide. Títulos de 1º nível (`#`) funcionam bem como capa.
- **Prefira listas curtas** a parágrafos longos em cada seção — slides funcionam melhor com informação densa mas concisa.
- **Inclua diagramas Mermaid** nas seções que se beneficiam de visualização. Eles renderizam inline no slide.
- **Evite tabelas muito largas** — podem não caber bem na visualização em tela cheia dependendo do tamanho da tela.
- **Use `**negrito**`** para destacar os pontos mais importantes de cada slide.

## Outras opções de modo de leitura

O Sanctuary Reader oferece outros modos além de slides:

- **Modo Foco**: destaca a seção atual e esmaece o restante — útil para leitura sem distração
- **Leitura Guiada**: usa o estudo guiado para registrar previsão, questionamento e conclusão por seção — útil para revisar longos documentos

Veja mais em [Modos de leitura no Sanctuary Reader](/guia/modos-de-leitura/).

## Limitações atuais

O modo slides do Sanctuary Reader é voltado para revisão e apresentação leve. Ele não gera arquivos de apresentação exportáveis (como `.pptx`) — o foco é apresentar o documento Markdown diretamente no navegador, sem conversão para outro formato.

Para geração de arquivos de apresentação a partir de Markdown, ferramentas como Marp ou Slidev são alternativas dedicadas a esse fluxo.

Se estiver avaliando editores Markdown online, veja também: [Editor Markdown online sem cadastro — o que esperar](/blog/editor-markdown-online-sem-cadastro/).

[Abrir o editor e testar o modo slides →](/)