# Guia de ferramentas JSON: documentos e dados para JSON e de volta

> Este guia explica como as ferramentas de JSON leem e gravam arquivos, o formato de documento de PDF para JSON e Word para JSON, e qual ferramenta usar em cada tarefa.

- Página: https://acepdfmd.com/pt/guides/json-guide/
- Atualizado: 2026-09-21
- Funciona em: https://acepdfmd.com (Os arquivos enviados são excluídos em até 60 minutos. Sem cadastro para uso leve.)
- Também em 29 idiomas: https://acepdfmd.com/<lang>/guides/json-guide/

## Por que JSON

JSON é o formato de dados que programas, serviços web e modelos de inteligência artificial leem com mais facilidade: objetos com campos nomeados, listas, números, texto, true, false e null, nada mais. Documentos e planilhas não são armazenados dessa forma. As ferramentas desta família fazem a ponte nas duas direções: transformam PDFs, arquivos Word, planilhas, CSV, YAML e XML em JSON, e transformam JSON de volta em arquivos que as pessoas leem, como PDF, Word, Excel, CSV e HTML.

Cada ferramenta é executada em nossos servidores por uma conexão segura e exclui o arquivo enviado dentro de 60 minutos. O texto de entrada pode ser colado diretamente em vez de enviado como arquivo.

## Qual ferramenta usar em cada tarefa

| Você tem | Você quer | Use |
|---|---|---|
| Um PDF | Texto, tabelas e metadados como dados | [PDF para JSON](https://acepdfmd.com/pt/tool/pdf-to-json/) |
| Um documento Word | Títulos, parágrafos, listas e tabelas como dados | [Word para JSON](https://acepdfmd.com/pt/tool/word-to-json/) |
| Uma pasta de trabalho do Excel | Registros, linhas ou colunas | [Excel para JSON](https://acepdfmd.com/pt/tool/excel-to-json/) |
| Um arquivo CSV ou TSV | Um array JSON com valores tipados | [CSV para JSON](https://acepdfmd.com/pt/tool/csv-to-json/) |
| Um arquivo YAML | Os mesmos dados como JSON | [YAML para JSON](https://acepdfmd.com/pt/tool/yaml-to-json/) |
| Um arquivo XML | Objetos, atributos e arrays | [XML para JSON](https://acepdfmd.com/pt/tool/xml-to-json/) |
| JSON | Um PDF para ler ou imprimir | [JSON para PDF](https://acepdfmd.com/pt/tool/json-to-pdf/) |
| JSON | Uma pasta de trabalho do Excel | [JSON para Excel](https://acepdfmd.com/pt/tool/json-to-excel/) |
| JSON | Um arquivo CSV | [JSON para CSV](https://acepdfmd.com/pt/tool/json-to-csv/) |
| JSON | Um documento Word editável | [JSON para Word](https://acepdfmd.com/pt/tool/json-to-word/) |
| JSON | Uma página web | [JSON para HTML](https://acepdfmd.com/pt/tool/json-to-html/) |
| JSON | YAML para um arquivo de configuração | [JSON para YAML](https://acepdfmd.com/pt/tool/json-to-yaml/) |
| JSON | XML para outro sistema | [JSON para XML](https://acepdfmd.com/pt/tool/json-to-xml/) |
| JSON confuso ou inválido | JSON limpo e válido | [Formatador de JSON](https://acepdfmd.com/pt/tool/json-formatter/) |
| Dois arquivos JSON | Uma lista do que mudou | [Comparar JSON](https://acepdfmd.com/pt/tool/json-compare/) |

Markdown tem seu próprio par de ferramentas: [Markdown para JSON](https://acepdfmd.com/pt/tool/markdown-to-json/) exporta uma árvore de documento e [JSON para Markdown](https://acepdfmd.com/pt/tool/json-to-markdown/) transforma JSON num esquema ou tabela em Markdown.

## O formato de documento

PDF para JSON e Word para JSON gravam a mesma forma, para que um único código trate os dois. O nível superior sempre tem estes campos:

```json
{
  "format": "acepdfmd-document",
  "version": 1,
  "source": {"type": "pdf", "filename": "report.pdf", "title": "Q3 Report", "pages": 12},
  "pages": [{"number": 1, "width": 612, "height": 792, "words": 380, "text": "..."}],
  "blocks": [
    {"type": "heading", "level": 1, "text": "Q3 Report"},
    {"type": "paragraph", "text": "Revenue grew..."},
    {"type": "list", "ordered": false, "items": [{"level": 0, "text": "Europe"}]},
    {"type": "table", "header": ["Region", "Q3"], "rows": [["Europe", 1200.5]]}
  ],
  "tables": [{"index": 1, "page": 3, "rows": [["Region", "Q3"], ["Europe", 1200.5]]}],
  "form_fields": [{"name": "email", "type": "text", "value": "a@b.com"}],
  "extraction": {"engine": "pdf_to_markdown/layout", "mode": "structure", "ocr": false, "warnings": []}
}
```

Os campos significam o seguinte:

- source: o que era o arquivo, com os metadados que ele trazia (título, autor, assunto, palavras-chave, datas de criação e modificação, número de páginas). Arquivos Word acrescentam a contagem de palavras, tabelas e imagens.
- pages: uma entrada por página do PDF, com seu tamanho em pontos, sua rotação, uma contagem de palavras e seu texto. Arquivos Word não têm páginas, porque o Word organiza páginas apenas quando imprime.
- blocks: o documento na ordem de leitura. Os tipos são heading (com nível de 1 a 6), paragraph (com um nome de estilo opcional vindo do Word), list (ordenada ou não, itens com um nível de aninhamento), table (cabeçalho e linhas tipadas), code, blockquote, rule e image.
- tables: para PDFs, cada tabela detectada com a página em que foi encontrada e, para uma tabela que continua, a página em que termina. Células que parecem números são números.
- form_fields: presente apenas quando o PDF tem um formulário. Cada campo tem seu nome, tipo (text, choice, button ou signature) e valor atual.
- extraction: qual conversor foi usado, o modo escolhido, se foi necessário OCR, e quaisquer avisos, como uma tabela que não pôde ser detectada.

A versão 1 deste formato só ganha campos novos; os campos existentes mantêm seus nomes e significados.

## Dados tabulares e aninhamento

CSV e Excel são planos; JSON não é. Quando JSON vai para CSV ou Excel, objetos aninhados são achatados em nomes de coluna com pontos e arrays em nomes indexados, então um registro de pedido com um objeto de cliente e um array de itens se torna colunas como customer.name, items[0].sku e items[1].sku. Quando CSV ou Excel volta para JSON, os cabeçalhos escritos dessa forma são reconstruídos em objetos e arrays aninhados. Um cabeçalho com um ponto comum, como um número de versão ou uma abreviação, é deixado como está.

Os valores são tipados na entrada: números se tornam números, true e false se tornam booleanos, uma célula vazia se torna null, e qualquer outra coisa permanece uma string. Datas vindas do Excel são gravadas como strings ISO 8601, porque JSON não tem tipo de data. Mude a opção de tipos de valor para texto quando identificadores com zeros à esquerda precisarem permanecer exatamente como foram escritos.

## Validação e reparo

Toda ferramenta de JSON valida sua entrada da mesma forma. Um arquivo inválido é rejeitado com a linha e a coluna do primeiro erro, e um trecho curto dessa linha. O [Formatador de JSON](https://acepdfmd.com/pt/tool/json-formatter/) também pode reparar os erros que as pessoas mais colam por engano: comentários, vírgulas finais, strings entre aspas simples, chaves sem aspas, True, False e None com maiúsculas, NaN e Infinity, e blocos de código em volta do texto. Quando um reparo é aplicado, o resultado informa isso, então nada muda de comportamento sem você saber.

## Privacidade

Arquivos enviados e texto colado são processados em nossos servidores e excluídos dentro de 60 minutos; veja o [guia de privacidade](https://acepdfmd.com/pt/guides/privacy-guide/) para os detalhes. Nada é armazenado além desse período e nada é usado para qualquer outro propósito.

## Ferramentas mencionadas neste guia

- [PDF para JSON](https://acepdfmd.com/pt/tool/pdf-to-json/): Extrai texto, títulos, listas, tabelas, campos de formulário e metadados de um PDF como JSON estruturado.
- [Word para JSON](https://acepdfmd.com/pt/tool/word-to-json/): Transforma um documento Word em JSON: títulos, parágrafos, listas e tabelas na ordem de leitura.
- [Excel para JSON](https://acepdfmd.com/pt/tool/excel-to-json/): Converte planilhas do Excel em registros, linhas ou colunas JSON com números e datas reais.
- [CSV para JSON](https://acepdfmd.com/pt/tool/csv-to-json/): Converte CSV ou TSV num array JSON de objetos, com números tipados e chaves aninhadas.
- [YAML para JSON](https://acepdfmd.com/pt/tool/yaml-to-json/): Converte YAML em JSON limpo, incluindo arquivos com vários documentos.
- [XML para JSON](https://acepdfmd.com/pt/tool/xml-to-json/): Converte XML em JSON com atributos, elementos repetidos como arrays e valores tipados.
- [JSON para PDF](https://acepdfmd.com/pt/tool/json-to-pdf/): Transforma JSON num PDF legível: os registros se tornam tabelas, e os dados aninhados, uma estrutura organizada.
- [JSON para Excel](https://acepdfmd.com/pt/tool/json-to-excel/): Converte JSON numa planilha do Excel, uma folha por lista de registros, com chaves aninhadas como colunas.
- [JSON para CSV](https://acepdfmd.com/pt/tool/json-to-csv/): Achata registros JSON num arquivo CSV que abre em qualquer planilha.
- [JSON para Word](https://acepdfmd.com/pt/tool/json-to-word/): Converte JSON num documento Word editável com títulos, listas e tabelas.
- [JSON para HTML](https://acepdfmd.com/pt/tool/json-to-html/): Renderiza JSON como uma página HTML autônoma com tabelas e uma estrutura pronta para impressão.
- [JSON para YAML](https://acepdfmd.com/pt/tool/json-to-yaml/): Converte JSON em YAML legível, com as chaves na ordem original.
- [JSON para XML](https://acepdfmd.com/pt/tool/json-to-xml/): Converte JSON em XML bem formado e indentado, com um elemento raiz que você escolhe.
- [Formatador de JSON](https://acepdfmd.com/pt/tool/json-formatter/): Valide, formate, minifique, ordene ou repare JSON, com a linha e a coluna exatas de qualquer erro.
- [Comparar JSON](https://acepdfmd.com/pt/tool/json-compare/): Compare dois arquivos JSON estruturalmente e liste cada valor adicionado, removido e alterado por caminho.
- [Markdown para JSON](https://acepdfmd.com/pt/tool/markdown-to-json/): Exporte a estrutura do documento como árvore sintática JSON (AST do pandoc).
- [JSON para Markdown](https://acepdfmd.com/pt/tool/json-to-markdown/): Transforme dados JSON ou um AST do pandoc em Markdown legível com tabelas.

## Mais guias

- [Folha de referência de Markdown: sintaxe com exemplos](https://acepdfmd.com/pt/guides/markdown-cheat-sheet/)
- [Tamanhos e dimensões de página em PDF: A4, Letter, Legal e mais](https://acepdfmd.com/pt/guides/pdf-page-sizes/)
- [Compressão PDF: como funciona e por que alguns arquivos mal encolhem](https://acepdfmd.com/pt/guides/pdf-compression-guide/)
- [PDF para Markdown: como funciona e como usar para IA](https://acepdfmd.com/pt/guides/pdf-to-markdown-guide/)
- [OCR para PDFs e imagens: como obter texto preciso](https://acepdfmd.com/pt/guides/ocr-guide/)
- [É seguro enviar um PDF pela internet? Um guia de privacidade](https://acepdfmd.com/pt/guides/privacy-guide/)
- [Abrir e converter arquivos iWork (Pages, Numbers, Keynote) sem Mac](https://acepdfmd.com/pt/guides/iwork-guide/)