Como converter JSON ou YAML em PDF: tabela, gráfico, árvore, código

Como converter JSON ou YAML em PDF

Para converter JSON ou YAML em PDF, envie o arquivo .json, .yaml ou .yml na ferramenta Converter JSON ou YAML em PDF, escolha como apresentar os dados (Tabela, Gráfico, Árvore ou Código) e clique em "Gerar PDF e baixar". O PDF sai em A4 (a Tabela, em A4 deitado), com cabeçalho, data e numeração de páginas, e o texto continua selecionável e pesquisável. Tudo roda no navegador, sem enviar o arquivo a nenhum servidor.

É a saída para quem precisa anexar uma configuração, um retorno de sistema ou uma lista de dados a um chamado, a um relatório ou a um e-mail sem despejar texto cru e desalinhado. A ferramenta lê o arquivo, descobre que formas de apresentação cabem nele e já sugere a melhor. Se o arquivo é um texto, um Markdown ou uma página HTML, o conversor é outro: veja como converter TXT, Markdown ou HTML em PDF.

Quatro jeitos de apresentar os mesmos dados

Assim que o arquivo entra, o painel analisa o conteúdo e mostra só os modos que fazem sentido para ele. A sugestão automática segue esta ordem: Tabela, quando os dados são uma lista de itens; Árvore, quando há dados aninhados; Código, para qualquer arquivo. Você pode trocar o modo antes de gerar.

• "Tabela": os dados são uma lista de itens e viram uma tabela com colunas e linhas, com cabeçalho destacado e repetido em cada página. Só aparece quando o arquivo é uma lista de registros parecidos. Um valor aninhado dentro de uma célula vira um resumo, como "[3 itens]" ou "{2 campos}".
• "Gráfico": uma coluna numérica vira um gráfico. Você escolhe a "Coluna de valor (números)", a "Coluna de rótulo" e o "Tipo de gráfico": Barras, Linha ou Pizza. Só aparece quando existe pelo menos uma coluna de números. As barras são horizontais e continuam em novas páginas quando há muitas linhas; Linha e Pizza cabem numa página só, e na Pizza os valores zero ficam de fora.
• "Árvore": dados aninhados numa visão indentada, mais fácil de ler que o arquivo cru. Com Árvore selecionada, aparece dentro de "Aparência (opcional)" a caixa "Incluir sumário (índice de seções)": o PDF ganha, no início, um índice com as seções principais e a página de cada uma.
• "Código": o arquivo inteiro, colorido por tipo (chaves, textos, números), do jeito que foi escrito, em fonte monoespaçada e com a indentação preservada.

Se o arquivo não for uma lista de itens, o modo Tabela não é oferecido; se não houver coluna numérica, o Gráfico fica de fora. Quando nem Tabela nem Árvore cabem (um arquivo com um único valor, por exemplo), o seletor de modo nem aparece e o PDF sai em Código. Com vários arquivos de uma vez, a análise usa só o primeiro e o modo escolhido vale para todos; se outro arquivo não couber nele, aparece um aviso como "Estes dados não formam uma tabela. Use o modo Código." e a geração é interrompida nesse arquivo.

Passo a passo para gerar o PDF

1. Abra a ferramenta "Converter JSON ou YAML em PDF".
2. Envie o arquivo .json, .yaml ou .yml; a ferramenta analisa o conteúdo e marca o modo sugerido.
3. Escolha como apresentar: "Tabela", "Gráfico", "Árvore" ou "Código". No Gráfico, defina a coluna de valor, a de rótulo e o tipo (Barras, Linha ou Pizza).
4. Abra "Aparência (opcional)" para escolher o "Tema" (Claro, Escuro, Corporativo ou Impressão, que economiza tinta) e enviar um "Logo no cabeçalho" em PNG ou JPG. Com Árvore selecionada, é aqui que fica a caixa "Incluir sumário (índice de seções)".
5. Clique em "Gerar PDF e baixar". O arquivo baixa com o nome original e a extensão .pdf; com vários arquivos, o botão mostra "Gerar N PDFs" e sai um PDF por arquivo.

Em qualquer modo, o PDF recebe um cabeçalho com o nome do arquivo e a data da geração (no formato dia/mês/ano), o logo se você enviou um, e a numeração das páginas no rodapé, como "1 / 3". O texto é desenhado como texto, não como imagem: dá para selecionar, copiar e pesquisar no leitor de PDF. Conteúdo longo é dividido em várias páginas em vez de sumir na margem.

Aparência: temas e logo

• Claro: fundo branco e cores vivas por tipo de dado, o padrão para leitura em tela e impressão comum.
• Escuro: fundo escuro com paleta ajustada, para quem vai ler em tela.
• Corporativo: tons mais sóbrios, pensado para relatórios e anexos formais.
• Impressão (economiza tinta): tons de cinza, sem cores fortes, para imprimir muitas páginas.
• Logo no cabeçalho: PNG ou JPG, exibido no topo de cada página, ao lado do nome do arquivo e da data. Se a imagem não puder ser lida, o PDF sai sem logo, sem aviso.

Quando gerar um PDF a partir dos dados

• Documentar a configuração de um sistema e guardar junto com o restante da papelada de um projeto.
• Anexar um arquivo de dados a um chamado, um relatório ou um e-mail sem depender de o destinatário ter um editor de código.
• Registrar o estado de uma configuração num momento específico, como um comprovante legível e datado.
• Apresentar uma lista de registros como tabela ou gráfico numa reunião, para quem não abre JSON ou YAML no dia a dia.

JSON e YAML: qual usar

Os dois formatos representam os mesmos dados de jeitos diferentes. O JSON é o padrão de troca entre sistemas; o YAML é mais enxuto e comum em arquivos de configuração, por ser fácil de ler e escrever à mão. A ferramenta aceita os dois e aplica os mesmos modos e temas, então use o que você já tem. Se o arquivo é o retorno de um sistema, provavelmente é JSON; se é a configuração de um programa, muitas vezes é YAML. Para passar de um formato ao outro antes de gerar o PDF, veja como converter JSON para YAML, YAML para JSON e XML para JSON.

Limites que vale conhecer

Não há escolha de tamanho de papel nem de fonte: o PDF sai sempre em A4, em pé nos modos Código, Árvore e Gráfico e deitado na Tabela. Letras fora do alfabeto latino, como chinês, japonês e emoji, somem do PDF, sem aviso, porque a fonte embutida cobre só o alfabeto latino com acentos. O modo Gráfico traça uma série por vez, a partir de uma coluna numérica; para comparar várias colunas, gere um PDF para cada uma. Um arquivo JSON ou YAML com erro de sintaxe não é convertido: aparece "Não foi possível ler este JSON. Confira se está bem formado." ou "Não foi possível ler este YAML. Confira a indentação e a sintaxe."

A conversão acontece toda no seu navegador: o arquivo é processado no próprio aparelho e nunca é enviado a nenhum servidor.

Para conferir se a Tabela vai aparecer: o arquivo precisa ser uma lista de itens com os mesmos campos, como uma lista de produtos ou de pessoas. Um objeto único com seções aninhadas vai para Árvore ou Código.