Solução de problemas
O que costuma dar errado, e por quê.
A imagem não aparece no slide
O PixelDeck só carrega arquivos que estejam na pasta do documento ou
em suas subpastas. Uma imagem em ~/Downloads, referenciada
por caminho absoluto, não aparece — e isso é proposital: garante que a
apresentação continue funcionando quando você mandar a pasta para outra
pessoa.
Solução: use Escolher imagem, vídeo ou áudio…
no bloco. Ele copia o arquivo para imagens/ ao lado do documento e
corrige o caminho.
Os efeitos de tela não aparecem na lista
- Eles vivem na aba Aparência do inspetor (⌘ ⇧ ,), não nas Preferências.
- Vêm desligados por padrão: a combinação inicial é Desligado.
- Sem um dispositivo Metal disponível, eles não podem ser compilados e ficam indisponíveis. Todo Mac com Apple Silicon tem Metal.
O efeito está ligado mas nada se mexe
Duas causas, nesta ordem:
- Reduzir movimento em Ajustes do Sistema → Acessibilidade suprime a animação, e tem a última palavra.
- O interruptor Movimento e cintilação, na própria seção de efeitos, está desligado.
O visual continua aplicado nos dois casos — o que para é a animação.
O vídeo do slide aparece parado durante a apresentação
Com um efeito de tela ligado, a tela é desenhada a partir de quadros capturados, e mídia em movimento não sobrevive à captura. Desligue o efeito para apresentar um deck com vídeo ou áudio.
Os links não funcionam durante a apresentação
Mesma causa: sob o efeito, a tela é uma imagem em Metal e não recebe cliques nos elementos. Desligue o efeito, ou use o PDF e o HTML portátil, onde os links continuam clicáveis.
Editei o documento e a apresentação não mudou
A apresentação é um retrato do conteúdo no instante em que começou. Encerre e recomece para incluir a edição. Veja Apresentar.
O projetor recebeu as minhas notas
Aperte X durante a apresentação: ele troca as telas, sem encerrar e sem abrir os ajustes do sistema.
O texto do PDF não é selecionável
É esperado. Cada página do PDF é uma imagem em 2560 × 1440 — é o preço de preservar exatamente o desenho, o brilho e a tipografia do slide. Se você precisa de texto selecionável, exporte o HTML portátil.
A exportação de vídeo demora
O vídeo é renderizado quadro a quadro, mas roda cerca de dez vezes mais depressa que o tempo real do resultado. Se estiver demorando muito, reduza Segundos por slide no vídeo em ⌘ , → Exportar: um deck com muitos passos de revelação produz muitos "slides" de vídeo.
O aplicativo não reabre a última apresentação
Confira ⌘ , → Ao abrir → Reabrir a última apresentação. Se o arquivo foi movido ou renomeado fora do PixelDeck, ele não é encontrado e o aplicativo pergunta qual abrir.
Abri um Markdown de outro programa e o slide ficou diferente
Esperado. O PixelDeck aplica a própria identidade visual — fontes, cores, brilho e espaçamento do tema — em vez de imitar a aparência de origem. Um comando que pede outra fonte ou outra cor é ignorado e gera aviso no slide. O arquivo, esse, continua intacto: o que você não editar é gravado byte a byte. Veja Referência da sintaxe.
Um slide com notas apareceu vazio na apresentação
Notas não escondem um slide. Para guardar um slide sem apresentá-lo,
comente todo o conteúdo dele com <!-- e -->
na aba Markdown. Veja
Comentários e slides ocultos.
Um bloco apareceu como "Bloco avançado"
É sintaxe que o editor visual não modela. Ela fica visível, editável como texto e preservada — o PixelDeck prefere isso a apagar em silêncio o que não entendeu.