Markdown Slides
Transforme arquivos Markdown (.md) em apresentações de slides diretamente no VS Code — escreva em Markdown, visualize como slides e apresente sem sair do editor.
Uso
- Escrever — abra ou crie um arquivo
.md e escreva seu conteúdo normalmente.
- Visualizar — clique no botão ▶ (Preview) na barra de título do editor, ou use o comando
Markdown Slides: Preview. Abre uma visualização ao lado do editor.
- Apresentar — clique no botão de Play (ou no botão ▶ Apresentar dentro do painel), ou use o comando
Markdown Slides: Play (Fullscreen). Isso coloca a própria janela do VS Code em tela cheia real (igual ao F11) e ativa o Zen Mode, escondendo abas, barra lateral e barra de status — uma experiência de apresentação em tela cheia como a de um PowerPoint, mas dentro do VS Code.
As alterações no Markdown são refletidas automaticamente conforme você digita ou salva.
Sintaxe
Separe os slides com --- em uma linha isolada:
# Título
Conteúdo do primeiro slide.
---
# Segundo slide
- item 1
- item 2
Delimitadores --- dentro de blocos de código (``` ou ~~~) são ignorados.
Cada slide ocupa 100% do espaço disponível (painel, janela ou tela cheia) — sem moldura, cartão ou sombra — com padding responsivo que se ajusta ao tamanho da tela.
Navegação
→ / Espaço / PageDown: próximo slide
← / Backspace / PageUp: slide anterior
Home / End: primeiro / último slide
F ou botão ▶ Apresentar: entra em modo de apresentação (tela cheia real da janela do VS Code + Zen Mode)
Esc: sai do modo de apresentação (desfaz a tela cheia e o Zen Mode)
Como o VS Code não expõe uma API para consultar se a janela já está em tela cheia/Zen Mode, a extensão assume que não estava e simplesmente alterna (toggleFullScreen/toggleZenMode) ao entrar e ao sair. Se você já estivesse manualmente em tela cheia ou Zen Mode antes de apresentar, a extensão pode desfazer esse estado ao sair.
Temas
Um tema é um único arquivo CSS. Ele é injetado no painel depois do Tailwind CSS, então pode:
- sobrescrever variáveis de cor usadas pelo conteúdo Markdown (geradas pelo plugin
@tailwindcss/typography: --tw-prose-* para modo claro e --tw-prose-invert-* para modo escuro — o modo escuro é ativado automaticamente conforme o tema atual do VS Code);
- definir
--slide-bg (fundo do slide);
- estilizar livremente seletores como
#stage, .slide-content, etc.
Dois temas de exemplo ficam em themes/: default.css e dark.css — use-os como ponto de partida para criar os seus.
Como escolher o tema:
Configuração global: markdownSlides.theme (nas Settings do VS Code), com o nome de um tema embutido (default, dark, ...) ou o caminho para um .css próprio (absoluto ou relativo ao arquivo .md).
Por arquivo, via front matter no topo do .md (tem prioridade sobre a configuração):
---
theme: dark
---
# Primeiro slide
...
(o bloco de front matter só é reconhecido quando está na primeira linha do arquivo; qualquer outro --- continua separando slides normalmente)
Dentro do Markdown você também pode usar classes utilitárias do Tailwind diretamente em HTML embutido, por exemplo:
<div class="grid grid-cols-2 gap-8">
<div>Coluna 1</div>
<div>Coluna 2</div>
</div>
Exportar para HTML
Clique no botão ⭳ (Export) na barra de título do editor, ou use o comando Markdown Slides: Export to HTML, para gerar um único arquivo .html com a apresentação completa — o diálogo de salvar abre já sugerindo salvar ao lado do .md, dentro da pasta do projeto.
O arquivo exportado é autocontido (CSS do Tailwind, tema ativo e todos os slides embutidos) e roda em qualquer navegador, sem depender do VS Code:
- mesma estrutura de telas (slide ocupando 100% da tela, responsivo) e o mesmo tema aplicado no
.md;
- navegação por
←/→/Espaço/Home/End e pelos botões;
- botão ▶ Apresentar (ou tecla
F) que usa a Fullscreen API real do navegador — diferente do painel dentro do VS Code, aqui a tela cheia funciona de forma direta, pois não há sandbox de webview envolvido.
Como o arquivo é independente, imagens referenciadas por caminho relativo no Markdown continuam funcionando desde que o .html exportado permaneça na mesma pasta do .md original.
Desenvolvimento
npm install
npm run compile
npm run compile gera o CSS do Tailwind (media/tailwind.css, a partir de src/styles/tailwind.css + tailwind.config.js) e depois compila o TypeScript. Pressione F5 no VS Code para abrir uma janela de Extension Development Host com a extensão carregada.