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. Basta que o deck, o relatório e o e-mail nasçam como texto versionado no git, o histórico de versões do projeto.

Feito à mão, o mesmo número exige três correções separadas, uma em cada formato. Quem prepara proposta, relatório mensal ou aula com frequência escolhe a ferramenta pelo destino do documento. Três regras decidem se o slide se lê da última fileira da sala.

Para o deck único, feito uma vez, a economia do texto versionado é menor: o ganho aparece quando algo muda depois da primeira versão.

A escolha entre as duas ferramentas de deck se decide pelo destino. Use o Slidev quando quer mostrar código rodando ou hospedar a apresentação numa página, porque ele também gera site. Troque por Marp quando o destino é só o arquivo: ele exporta PDF e o formato do PowerPoint com um comando.

Relatório sobe dois degraus. O Astro (o gerador de site que entrega HTML pronto e só carrega script onde precisa) é a escolha do manual para relatório estático premium e microsite. Ele traz Fonts API para hospedar a fonte no próprio site, CSP (a lista do que a página aceita carregar) embutida e publicação em Cloudflare Workers.

A linha estável em 8 de setembro de 2026 é a 7.3.2, publicada naquele mesmo dia; confira a versão corrente antes de instalar.

O investor update do manual segue essa linha: Astro com MDX (texto com componentes dentro), gráfico em D3 ou ECharts e PDF via Playwright.

A armadilha é carregar um framework (a estrutura que organiza o código do site) inteiro para uma página trimestral.

Quando o arquivo viaja por e-mail e precisa abrir daqui a cinco anos, vale o relatório único auditável e offline. Ele fica em HTML puro com ES Modules (o JavaScript nativo do navegador, sem empacotador), sem dependência para atualizar. O board mensal fechado segue igual: HTML estático, gráfico em D3 ou Observable Plot e CSS de impressão.

Para board, HTML e CSS puro (cartões, scorecards, tabela de variação) costuma vencer o gráfico hiperinterativo. O conselheiro quer o número, a variação e a fonte em dois cliques, sem filtro para arrastar.

Dois refinos de tipografia sustentam isso. A tipografia fluida por clamp() (um tamanho que cresce com a tela dentro de um piso e um teto) evita título gigante no celular e miúdo no telão.

Tabular figures (algarismos de largura igual) alinham toda coluna de número; sem eles o 1 é mais estreito que o 8 e a coluna dança. Sem fonte com essa variante, o plano B é uma monoespaçada só na coluna de número.

O equilíbrio de linha do título, text-wrap: balance, é recente e tem teto por motor. O Chromium balanceia até seis linhas e o Firefox até dez, então ele serve a título e trecho curto.

O text-wrap: pretty do corpo seguia sem Firefox em setembro de 2026, e entra como melhoria progressiva: onde ele não existe, o texto quebra do jeito de sempre.

O tema de cor e fonte tem atalho oficial. A skill theme-factory (o pacote de instruções que o agente carrega) do repositório anthropics/skills traz dez temas prontos, cada um com paleta em hex e par de fontes.

Antes de você escolher, o agente mostra um showcase em PDF; depois aplica o tema ao deck, ao documento ou à landing. Se nenhum servir, ele cria um tema novo a partir de uma descrição.

Nenhum tema pronto dispensa a direção do briefing da aula sobre prompt de frontend. Ele resolve paleta e fonte; a hierarquia, o tom e o que fica fora do slide continuam decisão sua. Um Midnight Galaxy num balancete para o conselho fiscal é bonito e errado.

Um slide é lido de longe, numa sala com a luz acesa, e três regras decidem se ele se lê. Contraste sobre fundo sólido, no mínimo no nível AA (o piso de contraste entre letra e fundo), sem gradiente atrás do texto.

Corpo a partir de 24px na tela e 36px projetado; títulos de 48 a 72px. Uma ideia por slide, no máximo cinco tópicos; trecho de código com mais de seis linhas vira dois slides. O defeito que mais reprova é o contraste: título sobre foto sem camada sólida some na projeção.

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

React Email serve o produto próprio, com componentes React (a biblioteca de interface) e o mesmo time do site. A agência com muitos clientes fica com MJML: as tags compiladas para tabela aguentam o Outlook. Quem já pensa em Tailwind (a biblioteca de classes utilitárias) usa Maizzle. A armadilha comum às três é testar só no Gmail claro.

Numa clínica com três sócios, o relatório mensal refeito à mão virou HTML único com CSS de impressão e tabular figures 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: npx skills add https://github.com/anthropics/skills --skill theme-factory. Peça ao agente o showcase dos dez temas e escreva o briefing antes de aplicar um.

Revise cada slide com as 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, ou PowerPoint só para quem vai editar, porque nele o texto vira imagem.

Gere o PDF com prova de conformidade fora do caminho da requisição

Um PDF gerado pelo site é um produto entregue, com prova de conformidade a cumprir e risco de operação a controlar. Gerar dentro do caminho da requisição, o pedido que o navegador do cliente faz ao servidor e espera resposta, derruba o portal no dia de maior procura.

Quem envia relatório, balancete ou proposta em PDF a partir de uma página escolhe o gerador pela prova que ele entrega. São oito ferramentas, cada uma com o seu critério e a sua armadilha.

Duas normas respondem a duas perguntas. PDF/UA-1 garante leitura por leitor de tela, com marcação de título, tabela e ordem de leitura. PDF/A-2a garante que o arquivo abra daqui a dez anos, com a fonte embarcada. A PDF/UA-2 (ISO 14289-2:2024) existe, mas o alvo prático de 2026 segue a versão 1, que validadores e Typst tratam com maturidade.

O Typst 0.15 (um compositor de documentos em texto, como um LaTeX moderno) entrega PDF/UA-1 e PDF/A-2a no mesmo arquivo. Quando o resultado não cumpre a norma, ele acusa erro explícito em vez de gerar um PDF silenciosamente não conforme. Traz fontes variáveis e export HTML com MathML (fórmula legível por leitor de tela).

Escolha o Typst quando o relatório precisa provar acessibilidade e arquivamento no mesmo artefato. A armadilha é esperar que ele reproduza a tela pixel a pixel: ele compõe a partir do texto, e o gráfico da tela entra exportado.

Quando o relatório precisa sair idêntico à tela, com gráfico em SVG ou Canvas, use Playwright ou Puppeteer (robôs que abrem a página num navegador real e imprimem). A impressão page.pdf existe só no Chromium.

Duas travas mudam o resultado. Fixe a versão do Chromium no CI (a esteira que testa e publica), porque a atualização do motor muda paginação e fontes. Dispare o PDF só depois de um marcador explícito de estado estável; o evento de load chega antes de o gráfico terminar.

Gotenberg e IronPDF empacotam o mesmo modelo como serviço. Você chama uma API (a porta por onde um sistema pede algo a outro) com o HTML e recebe o arquivo, sem manter Chromium.

Quem renderiza HTML não confiável, enviado por cliente ou colado de fora, precisa do WeasyPrint 69 por causa da CVE-2026-49452 (falha de segurança em catálogo público). A versão traz --output-intent com perfis ICC (a descrição de cor que a gráfica exige) e propriedades lógicas.

PrinceXML 16.2, PDFreactor e Antenna House são o CSS Paged Media (a especificação de página impressa em CSS) comercial para editorial e PDF/A. O PDFreactor roda ECMAScript 2025 via GraalJS e emite ZUGFeRD (a fatura eletrônica embutida no PDF). Pague por eles quando o volume editorial e o suporte contratual justificam a licença.

O paged.js, opção gratuita da mesma família, está em transição de mantenedores com quebras de compatibilidade anunciadas: risco para quem depende dele em produção. Use no protótipo e troque antes de publicar.

No navegador, o jsPDF 4.2.1 corrige path traversal (leitura de arquivo fora da pasta permitida) no build Node. O pdfMake 0.3.11 ganhou setUrlAccessPolicy() contra download de recurso de origem controlada por atacante. Atualizar as duas é segurança, não cosmética. Elas servem ao recibo de uma página; relatório com norma vai para Typst ou navegador fixado.

A escala tem regra única: nunca gere PDF de forma síncrona em servidor de produção, porque o dia de pico trava a fila de requisições. O pedido entra numa fila assíncrona (Kafka, RabbitMQ ou BullMQ, a fila de tarefas do Node) e um trabalhador separado gera o arquivo.

Um orquestrador sobe trabalhadores pelo sinal de backlog (o tamanho da fila), e um pool de navegadores reutilizados atende em vez de abrir um Chromium por pedido. Dois cuidados fecham a esteira: sandbox contra SSRF (o navegador do servidor usado para alcançar a rede interna) e sanitize-html antes do render.

Nos dois caminhos, a fonte fica hospedada no seu servidor e embarcada no arquivo. Chamar a fonte no Google durante a geração vaza 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 em Python, a skill pdf (o pacote de instruções que o agente carrega) do repositório anthropics/skills é a caixa de ferramentas oficial. Ela é source-available e uma das quatro que movem a criação de documentos do Claude.

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 é o dia de pico. Num escritório de contabilidade cujo balancete sai em PDF pelo portal, cada download disparava um navegador na hora e travava o dia 5. Com a fila assíncrona, o arquivo já está pronto quando o cliente clica, e o validador de PDF/UA-1 anexou a prova na véspera.

Antes de publicar, pergunte ao agente qual das três provas o PDF precisa: conformidade, fidelidade à tela ou recibo simples. A resposta escolhe Typst, Playwright com Chromium fixado, ou jsPDF atualizado, e decide se a fonte fica embarcada e o navegador roda em sandbox, longe da rede interna.