Produzir apresentações e PDF com critérios de entrega

Um número corrigido uma vez sai certo na página, no PDF e no slide, desde que os três nasçam do mesmo texto. Esse texto fica guardado no git, o caderno de versões que registra cada alteração do projeto.

Feito à mão, o mesmo número pede três correções separadas, uma por formato, e é aí que uma delas escapa. Quem monta proposta, relatório mensal ou aula com frequência ganha tempo escolhendo a ferramenta pelo destino do documento.

Para o deck feito uma vez só, essa economia quase não aparece, porque ela nasce da segunda correção em diante. Quando o material volta todo mês, o ganho se acumula.

Entre as duas ferramentas de deck, o destino decide. Use o Slidev quando quiser mostrar código rodando ou deixar a apresentação num endereço na internet, porque ele também gera site. Troque pelo Marp quando o destino for só o arquivo, porque ele exporta PDF e PowerPoint num comando.

O relatório sobe um degrau porque ele volta todo trimestre. O Astro, um gerador que entrega a página já pronta em HTML e só carrega programação onde ela é necessária, é a escolha para relatório e microsite. Ele hospeda a fonte no próprio site e já traz a lista do que a página aceita carregar de fora.

Confira a versão corrente do Astro antes de instalar, porque a linha estável muda de mês em mês. A armadilha é outra: carregar um framework inteiro, isto é, toda a estrutura que organiza um site grande, para uma página que muda quatro vezes ao ano.

Quando o arquivo viaja por e-mail e precisa abrir daqui a cinco anos, o caminho é o relatório em HTML puro, sem nada para atualizar depois. O board mensal fechado segue a mesma linha, com gráfico desenhado na própria página e CSS de impressão.

Para o board, cartão e tabela de variação em HTML e CSS comuns costumam vencer o gráfico cheio de filtros. O conselheiro quer o número, a variação e a origem do dado em dois cliques, sem arrastar nada.

Dois ajustes de tipografia sustentam essa leitura. O primeiro é clamp(), uma regra que faz o texto crescer com a tela entre um piso e um teto, e evita título gigante no celular.

O segundo é o algarismo de largura fixa, que alinha a coluna de números: sem ele o 1 é mais estreito que o 8 e a coluna dança.

Por fim, o equilíbrio automático da quebra de linha do título já funciona na maioria dos navegadores e serve bem a texto curto. O mesmo ajuste para o corpo do texto ainda falta em parte deles, então trate-o como bônus: onde não existir, o texto quebra do jeito de sempre.

O tema de cor e de fonte tem atalho pronto. A skill theme-factory, que é um pacote de instruções carregado pelo agente, traz dez temas com paleta e par de fontes já escolhidos.

Antes de você decidir, o agente mostra os temas num PDF; depois aplica o escolhido ao deck, ao documento ou à página. Se nenhum servir, ele monta um tema novo a partir de uma descrição sua.

Nenhum tema pronto substitui a direção do briefing. Ele resolve cor e fonte; a hierarquia da informação, o tom e o que fica de fora do slide continuam sendo decisão sua. Um tema chamado Midnight Galaxy num balancete para o conselho fiscal fica bonito e errado.

O slide é lido de longe, numa sala com a luz acesa, e três regras decidem se ele se lê. A primeira é contraste: letra escura sobre fundo sólido, no nível AA, que é o piso de diferença entre letra e fundo, sem gradiente atrás do texto.

A segunda é tamanho: corpo a partir de 24px na tela e 36px projetado, títulos de 48 a 72px. A terceira é foco: uma ideia por slide, no máximo cinco tópicos, e trecho de código com mais de seis linhas vira dois slides.

O defeito que mais reprova é o contraste, porque título sobre foto sem camada sólida some na projeção.

O e-mail é o documento mais hostil que sai da web, porque Gmail, Outlook e modo escuro ignoram metade do CSS moderno. Sem ferramenta, o plano B é tabela HTML, fonte do sistema e fundo sólido nos dois modos de cor.

React Email serve quem tem produto próprio, porque o time do site reaproveita os mesmos blocos. A agência com dezenas de marcas fica com MJML, cujas marcações viram tabela e aguentam o Outlook.

Quem já escreve o site com Tailwind, a biblioteca de classes prontas de estilo, usa Maizzle. A armadilha das três é testar só no Gmail claro.

Numa clínica com três sócios, o relatório mensal era refeito à mão todo início de mês. Virou uma página em HTML com CSS de impressão e algarismos alinhados na coluna de receita. O e-mail de confirmação, que sumia no modo escuro do celular, foi para o React Email com fundo sólido nos dois modos.

Instale a theme-factory antes de escolher o tema, com npx skills add https://github.com/anthropics/skills --skill theme-factory. Peça o mostruário dos dez temas ao agente e escreva o briefing antes de aplicar um deles.

Depois revise cada slide pelas três regras: fundo sólido, corpo a partir de 24px, uma ideia por slide. Exporte com npx slidev export e escolha PDF para quem precisa copiar o texto, porque no PowerPoint o texto vira imagem.

Gerar o PDF com prova de conformidade sem travar o site

O deck escrito como texto resolve o site e o slide, e o arquivo que circula por e-mail ainda pede gerador de PDF com prova de conformidade e fila própria.

Um PDF gerado pelo site é produto entregue, com prova a cumprir e risco de operação a controlar. Gerar o arquivo no meio da requisição derruba o portal justo no dia de maior procura. Requisição é o pedido que o navegador faz ao servidor enquanto o cliente espera na tela.

Quem manda relatório, balancete ou proposta em PDF a partir de uma página escolhe a ferramenta pela prova que ela entrega. São três provas diferentes, e confundi-las é o erro que custa caro depois.

Duas normas respondem a duas perguntas diferentes. PDF/UA-1 garante que um leitor de tela consiga ler o arquivo, com título, tabela e ordem de leitura marcados. PDF/A-2a garante que o arquivo abra daqui a dez anos, porque a fonte vai embarcada dentro dele.

O Typst, um compositor de documentos que monta a página a partir de texto escrito, entrega as duas normas no mesmo arquivo. Quando o resultado não cumpre a norma, ele acusa o erro em vez de gerar um PDF que só parece conforme.

Escolha o Typst quando o relatório precisa provar acessibilidade e arquivamento juntos. A armadilha é esperar que ele copie a tela pixel a pixel, porque ele compõe a página pelo texto, e o gráfico entra como imagem exportada.

Quando o relatório precisa sair idêntico à tela, com gráfico desenhado pelo navegador, o caminho é o Playwright ou o Puppeteer. São robôs que abrem a página num navegador de verdade e mandam imprimir.

Duas travas mudam o resultado. Fixe a versão do navegador na esteira que testa e publica, porque atualização de motor muda paginação e fonte sem avisar. E dispare a impressão só depois de um sinal explícito de que a página terminou de montar, porque o aviso padrão chega antes do gráfico.

Gotenberg e IronPDF vendem esse mesmo modelo como serviço. Você manda o HTML por uma API, que é a porta por onde um sistema pede algo a outro, e recebe o arquivo pronto. Ninguém precisa manter navegador no servidor.

Quem transforma em PDF um HTML que veio de fora precisa do WeasyPrint 69, a versão que corrige a falha de segurança catalogada em 2026. Isso vale para o arquivo enviado por cliente ou colado de outro sistema. Essa versão também exporta com o perfil de cor que a gráfica pede.

PrinceXML, PDFreactor e Antenna House são a linha paga para editorial e conformidade, com suporte contratual e fatura eletrônica embutida no arquivo. Pague por elas quando o volume editorial e a responsabilidade pelo prazo justificarem a licença.

O paged.js é a opção gratuita da mesma família, e está trocando de mantenedores com quebras de compatibilidade já anunciadas. Use no protótipo e troque antes de publicar.

No navegador, o jsPDF e o pdfMake montam o recibo de uma página sem passar pelo servidor. As versões recentes de cada um corrigem falhas que deixavam o código ler arquivo fora da pasta permitida ou buscar recurso de endereço escolhido por um atacante.

Atualizar as duas é segurança, e não capricho. Elas resolvem o recibo simples; relatório que precisa provar norma volta para o Typst ou para o navegador com versão fixada.

A escala tem uma regra só: nunca gere PDF na hora, dentro do servidor de produção, porque o dia de pico trava o site inteiro. O pedido entra numa fila e um trabalhador separado produz o arquivo.

Quando a fila cresce, sobem mais trabalhadores, e um conjunto de navegadores já abertos atende os pedidos em vez de abrir um navegador por vez. Dois cuidados fecham a esteira: rode o navegador isolado da rede interna e limpe o HTML recebido antes de imprimir.

Nos dois caminhos, a fonte fica hospedada no seu servidor e embarcada no arquivo. Buscar a fonte no Google durante a geração entrega o endereço de rede de quem gera, e uma sentença em Munique tratou esse endereço como dado pessoal.

Para ler, preencher e montar PDF dentro do fluxo do agente, existe a skill pdf do repositório anthropics/skills, uma caixa de ferramentas em Python já pronta.

Instale com npx skills add https://github.com/anthropics/skills --skill pdf e peça ao agente para extrair a tabela do balancete antigo antes de compor o novo.

O critério é sempre o dia de pico. Num escritório de contabilidade, o balancete saía em PDF pelo portal e cada download abria um navegador na hora, o que travava o sistema todo dia 5. Com a fila, o arquivo já está pronto quando o cliente clica, e o selo de acessibilidade foi conferido na véspera.

Antes de publicar, decida com o agente qual das três provas o seu PDF precisa entregar. São três: conformidade com norma, fidelidade ao que a tela mostra ou recibo simples de uma página.

A resposta escolhe entre Typst, navegador com versão fixada e jsPDF atualizado. Ela também decide se a fonte vai embarcada e se o navegador roda isolado, longe da rede interna da empresa.

Guia prático: a aula como slides web, com vídeo que toca com som

A edição de vídeo estudada em 07/10/2026 é, por dentro, uma página web. Cada bloco tem início e duração em atributos de dados, uma única linha do tempo pausada controla toda a animação, e o render abre essa página e grava quadro a quadro. No caso real, um vídeo de 11 minutos com 191 cortes e 36 efeitos gráficos saiu de uma página assim. O mesmo motor, HTML com linha do tempo, serve para a apresentação: em vez de gravar a linha do tempo inteira, você para em cada slide e avança pela seta.

O HyperFrames tem esse fluxo na skill de slideshow, conferida na documentação pública do repositório. O deck é servido, e não renderizado: o comando present abre a apresentação, e a tecla P abre a aba da plateia em tela cheia. A aba original vira o modo apresentador, com o slide atual, a prévia do próximo, as notas e o cronômetro, as duas sincronizadas. Setas, espaço e retrocesso navegam; dentro de um slide, os fragmentos são pontos de parada na linha do tempo. A própria documentação avisa: não renderize o deck como MP4, porque cada slide é uma composição separada e o arquivo sai cortado.

O vídeo com som exige um cuidado. O navegador só deixa tocar com áudio depois de uma interação da pessoa na página: clique, toque ou tecla. Por isso o vídeo do slide começa por um clique do apresentador, e não sozinho. No deck do HyperFrames, a mídia da aba da plateia começa sem som pela mesma regra, e sair do slide para a mídia dele.

Aplicar os recursos ao projeto