Slidev: criar slides para desenvolvedores com o andaime oficial

Para quem

Esta skill serve quando você quer uma apresentação para desenvolvedores e quer que o andaime oficial inicie imediatamente um projeto de slides no local. O posicionamento é slides de apresentação para desenvolvedores. O caminho local oficial é só um: primeiro cumprir Node.js >= 20.12.0 e depois executar npm init slidev. Os materiais também têm uma entrada online e notas de editor, mas não as coloque ao lado da inicialização local como caminhos principais intercambiáveis. Se o seu Node estiver abaixo de 20.12.0, ou você não pretende gerar um projeto nesta máquina, não execute o init ainda.

Serve a quem já consegue executar Node e só precisa de um projeto de slides com pré-visualização. Não serve a quem ainda não chegou à versão exigida e quer mudar tema ou extensão primeiro. No lado do editor, os materiais mencionam um editor integrado ou uma extensão VSCode; isso é a superfície de edição, não um segundo instalador. Você pode inicializar sem roteiro da palestra, mas não espere que o andaime escreva o texto completo.

Primeira tentativa em 3 minutos

Use apenas este comando oficial de instalação:

npm init slidev

Pré-requisitos: confirme primeiro Node.js >= 20.12.0. A página para obter o Node é

https://nodejs.org/

Esta rodada só inicializa um projeto novo. Não publique. Não ligue uma entrada online que não esteja escrita como caminho principal.

O local de instalação é o diretório local que o npm init vai criar. Antes de executar, peça ao assistente para repetir o diretório de destino e a versão do Node; execute só depois de confirmar, porque isso grava no disco.

Sinal de sucesso: um novo projeto de slides aparece no local e você consegue abrir a pré-visualização seguindo as próprias dicas do andaime. Se o comando falhar, confira primeiro a versão do Node; não mude para uma criação online que não é o caminho principal. Os materiais não escrevem um nome de tema padrão nem passos de exportação PDF. Se o init perguntar o nome do projeto, use um diretório vazio para não sobrescrever arquivos existentes.

Casos de uso

Caso 1: criar localmente um deck para desenvolvedores. Depois de confirmar a versão do Node, execute a inicialização oficial, gere só um projeto e abra para ver se a página inicial aparece. A evidência cobre npm init slidev, mas não dá itens de perguntas nem uma lista de modelos. Além disso, pare em «consegue inicializar e abrir». Inicialize só um diretório por vez.

Caso 2: editar slides com o editor integrado ou a extensão VSCode. Com o projeto no ar, mude uma página na superfície de edição que os materiais nomeiam. A evidência cobre integrated editor e VSCode extension, mas não escreve um identificador de mercado de extensões nem atalhos. Não leia a instalação do editor como outro andaime de projeto. Antes de mudar uma página, confirme que você está alterando o projeto recém-inicializado. Primeiro mude um título ou uma nota, confirme que a pré-visualização acompanha e só então considere mais páginas.

Limites

O caminho local principal é só npm init slidev e exige Node.js >= 20.12.0. Os materiais também mostram o endereço online

https://sli.dev/new

Esse não é o caminho principal recomendado desta vez; não coloque ao lado do npm init. Os docs do editor apontam para

https://sli.dev/guide/index#editor

https://sli.dev/features/vscode-extension

Eles só descrevem a superfície de edição. A primeira tentativa para na inicialização e na pré-visualização. Não invente um instalador não escrito e não repita init antes de o diretório estar confirmado. Se a versão do Node não atingir o requisito, pare no requisito de runtime; não rebaixe para um comando antigo não escrito.