Markdown para Apresentações

Escreva apresentações da mesma forma que você escreve READMEs: cabeçalhos Markdown, listas com marcadores, blocos de código, separados por regras horizontais --- em slides. A ferramenta renderiza seu conjunto ao vivo usando Reveal.js (temas: preto, branco, simples, solarizado), suporta notas do apresentador com Nota:, slides verticais aninhados com --, e exporta para um arquivo HTML autossuficiente ou um PDF pronto para impressão.

Como o Markdown se torna um conjunto de slides

  1. 1

    Escreva Markdown

    Use `---` para separar slides. Cabeçalhos, listas e blocos de código padrão funcionam como de costume.

  2. 2

    Adicione notas do apresentador

    Prefixe um parágrafo com `Nota:`, ele é exibido apenas no modo apresentador.

  3. 3

    Visualize o conjunto

    A visualização ao vivo mostra o conjunto com navegação por teclas de seta.

  4. 4

    Escolha um tema

    Preto, branco, liga, céu, simples, solarizado, qualquer tema do Reveal.js.

  5. 5

    Exportar

    Arquivo HTML autossuficiente ou PDF via impressão do navegador.

A sintaxe do slide

# Slide de abertura

Texto do subtítulo aqui

---

## Segundo slide

- Marcador um
- Marcador dois
- Marcador três

Nota: estas são notas do apresentador visíveis apenas no modo apresentador.

---

## Slide de código

\`\`\`python
def hello(name):
    return f"Oi {name}"
\`\`\`
  • --- (três traços em sua própria linha) inicia um novo slide horizontal.
  • -- (dois traços) inicia um slide vertical dentro da coluna de slide atual, pressione a seta para baixo para descer.
  • Nota: no início de um parágrafo se torna uma nota do apresentador.

Navegação por teclado

Tecla Ação
Direita / Espaço Próximo slide
Esquerda Slide anterior
Para baixo / Para cima Navegar na pilha vertical
s Abrir visualização do apresentador
o Visão geral dos slides
f Tela cheia
? Diálogo de ajuda

Truques de layout

  • Layout de duas colunas: use HTML bruto dentro de um slide, <div class="columns">...</div>.
  • Revelação de fragmentos: listas com marcadores animam uma a uma com o atributo {.fragment} ao usar Reveal.js diretamente. Adicione como HTML bruto se precisar.
  • Imagens de fundo: atributo de nível de slide <!-- .slide: data-background="url" --> define um fundo de borda total.
  • Auto-animação entre slides: Reveal 4 suporta transições suaves para elementos correspondentes, ative nas configurações do tema.

Exportando para PDF

Na visualização ao vivo, abra ?print-pdf na URL do seu navegador e use o diálogo de impressão do navegador. Escolha A4 paisagem, gráficos de fundo ativados, margens mínimas. O Reveal.js gera um slide por página com notas do apresentador em páginas adicionais opcionais.

Quando os slides baseados em Markdown se destacam

  • Palestras técnicas com muitos exemplos de código.
  • Conjuntos de conteúdo primeiro onde o layout é secundário.
  • Documentos como slides, mantenha apresentações ao lado do README do projeto no git.
  • Material de treinamento controlado por versão.

Quando não se destacam

  • Palestras com design pesado com colocação precisa de imagens.
  • Slides que precisam de animações complexas ou temporização de vídeo embutido.
  • Conjuntos governados por marca onde os modelos ditam cada detalhe.

Perguntas frequentes

Sim, a sintaxe de imagem Markdown regular funciona. Use URLs absolutas ou faça upload de imagens primeiro para que sejam acessíveis a partir do HTML exportado.

Sim, opcionalmente. O modo de impressão do Reveal suporta “notas como página separada”, cada slide se torna duas páginas PDF, uma com o slide, outra com as notas.

Não. A renderização é local no seu navegador. O código-fonte Markdown e o HTML exportado nunca saem da sua máquina.

Sim. Adicione um bloco <style> no topo do seu Markdown ou vincule uma folha de estilo externa nas configurações do tema. Ele é injetado na saída do Reveal.js.

O HTML exportado é um arquivo autossuficiente que roda em qualquer host estático, GitHub Pages, Netlify, S3. Faça upload do HTML e você está feito.

Ferramentas relacionadas

Ferramenta disponível em outros idiomas