# Гид по инструментам JSON: документы и данные в JSON и обратно

> В этом руководстве описано, как инструменты JSON читают и пишут файлы и какой инструмент выбрать для каждой задачи.

- Страница: https://acepdfmd.com/ru/guides/json-guide/
- Обновлено: 2026-09-21
- Работает на: https://acepdfmd.com (Загруженные файлы удаляются в течение 60 минут. Без регистрации при небольшом объёме.)
- Также на 29 языках: https://acepdfmd.com/<lang>/guides/json-guide/

## Почему JSON

JSON, это формат данных, который программы, веб-сервисы и модели ИИ читают легче всего: объекты с именованными полями, списки, числа, текст, true, false и null, и больше ничего. Документы и электронные таблицы не хранятся таким образом. Инструменты этого семейства связывают эти два мира в обоих направлениях: они превращают PDF, файлы Word, электронные таблицы, CSV, YAML и XML в JSON, а также превращают JSON обратно в файлы, которые читают люди, такие как PDF, Word, Excel, CSV и HTML.

Каждый инструмент работает на наших серверах через защищённое соединение и удаляет загруженный файл в течение 60 минут. Текст можно вставить напрямую вместо загрузки файла.

## Какой инструмент для какой задачи

| У Вас есть | Вы хотите получить | Используйте |
|---|---|---|
| PDF | Текст, таблицы и метаданные в виде данных | [PDF в JSON](https://acepdfmd.com/ru/tool/pdf-to-json/) |
| Документ Word | Заголовки, абзацы, списки и таблицы в виде данных | [Word в JSON](https://acepdfmd.com/ru/tool/word-to-json/) |
| Книгу Excel | Записи, строки или столбцы | [Excel в JSON](https://acepdfmd.com/ru/tool/excel-to-json/) |
| Файл CSV или TSV | Массив JSON с типизированными значениями | [CSV в JSON](https://acepdfmd.com/ru/tool/csv-to-json/) |
| Файл YAML | Те же данные в виде JSON | [YAML в JSON](https://acepdfmd.com/ru/tool/yaml-to-json/) |
| Файл XML | Объекты, атрибуты и массивы | [XML в JSON](https://acepdfmd.com/ru/tool/xml-to-json/) |
| JSON | PDF для чтения или печати | [JSON в PDF](https://acepdfmd.com/ru/tool/json-to-pdf/) |
| JSON | Книгу Excel | [JSON в Excel](https://acepdfmd.com/ru/tool/json-to-excel/) |
| JSON | Файл CSV | [JSON в CSV](https://acepdfmd.com/ru/tool/json-to-csv/) |
| JSON | Редактируемый документ Word | [JSON в Word](https://acepdfmd.com/ru/tool/json-to-word/) |
| JSON | Веб-страницу | [JSON в HTML](https://acepdfmd.com/ru/tool/json-to-html/) |
| JSON | YAML для конфигурационного файла | [JSON в YAML](https://acepdfmd.com/ru/tool/json-to-yaml/) |
| JSON | XML для другой системы | [JSON в XML](https://acepdfmd.com/ru/tool/json-to-xml/) |
| JSON, который повреждён или некорректен | Чистый, корректный JSON | [Форматирование JSON](https://acepdfmd.com/ru/tool/json-formatter/) |
| Два файла JSON | Список того, что изменилось | [Сравнить JSON](https://acepdfmd.com/ru/tool/json-compare/) |

У Markdown есть своя пара: [Markdown в JSON](https://acepdfmd.com/ru/tool/markdown-to-json/) экспортирует дерево документа, а [JSON в Markdown](https://acepdfmd.com/ru/tool/json-to-markdown/) превращает JSON в структуру или таблицу Markdown.

## Формат документа

PDF в JSON и Word в JSON записывают одну и ту же форму, поэтому один и тот же код обрабатывает оба случая. На верхнем уровне всегда присутствуют такие поля:

```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": []}
}
```

Поля означают следующее:

- source: что представлял собой файл, с метаданными, которые он содержал (заголовок, автор, тема, ключевые слова, даты создания и изменения, количество страниц). Файлы Word дополнительно указывают количество слов, таблиц и изображений.
- pages: одна запись на каждую страницу PDF с её размером в пунктах, поворотом, количеством слов и текстом. У файлов Word нет страниц, потому что Word размещает страницы только при печати.
- blocks: документ в порядке чтения. Типы: heading (заголовок с уровнем от 1 до 6), paragraph (абзац с необязательным именем стиля из Word), list (список, упорядоченный или нет, с элементами и уровнем вложенности), table (таблица с заголовком и типизированными строками), code, blockquote, rule и image.
- tables: для PDF, каждая обнаруженная таблица со страницей, на которой она найдена, и, если таблица продолжается, страницей, на которой она заканчивается. Ячейки, похожие на числа, представлены числами.
- form_fields: присутствует только когда в PDF есть форма. У каждого поля есть имя, тип (text, choice, button или signature) и текущее значение.
- extraction: какой конвертер выполнял преобразование, выбранный режим, требовалось ли OCR, и любые предупреждения, например о таблице, которую не удалось обнаружить.

Версия 1 этого формата только получает новые поля; существующие поля сохраняют свои имена и значение.

## Табличные данные и вложенность

CSV и Excel плоские, JSON, нет. Когда JSON превращается в CSV или Excel, вложенные объекты разворачиваются в имена столбцов с точками, а массивы, в пронумерованные, поэтому запись заказа с объектом клиента и массивом позиций становится столбцами вида customer.name, items[0].sku и items[1].sku. Когда CSV или Excel возвращается в JSON, заголовки, записанные таким образом, восстанавливаются во вложенные объекты и массивы. Заголовок с обычной точкой, например номер версии или сокращение, оставляется без изменений.

Значения типизируются на входе: числа становятся числами, true и false становятся логическими значениями, пустая ячейка становится null, а всё остальное остаётся строкой. Даты, приходящие из Excel, записываются как строки ISO 8601, поскольку в JSON нет типа даты. Переключите параметр типов значений на текст, когда идентификаторы с ведущими нулями должны остаться записанными в точности.

## Проверка и исправление

Каждый инструмент JSON проверяет входные данные одинаковым образом. Некорректный файл отклоняется с указанием строки и столбца первой ошибки и коротким фрагментом этой строки. [Форматирование JSON](https://acepdfmd.com/ru/tool/json-formatter/) может также исправить ошибки, которые люди чаще всего вставляют: комментарии, висячие запятые, строки в одинарных кавычках, ключи без кавычек, написанные с большой буквы True, False и None, NaN и Infinity, и ограждения кода вокруг текста. Когда исправление применено, результат сообщает об этом, поэтому ничего не меняется незаметно для Вас.

## Конфиденциальность

Загруженные файлы и вставленный текст обрабатываются на наших серверах и удаляются в течение 60 минут; подробности смотрите в [руководстве по конфиденциальности](https://acepdfmd.com/ru/guides/privacy-guide/). Ничего не хранится дольше этого времени и не используется для каких-либо иных целей.

## Инструменты, упомянутые в этом руководстве

- [PDF в JSON](https://acepdfmd.com/ru/tool/pdf-to-json/): Извлеките текст, заголовки, списки, таблицы, поля форм и метаданные PDF в виде структурированного JSON.
- [Word в JSON](https://acepdfmd.com/ru/tool/word-to-json/): Превратите документ Word в JSON: заголовки, абзацы, списки и таблицы в порядке чтения.
- [Excel в JSON](https://acepdfmd.com/ru/tool/excel-to-json/): Преобразуйте листы Excel в записи, строки или столбцы JSON с реальными числами и датами.
- [CSV в JSON](https://acepdfmd.com/ru/tool/csv-to-json/): Преобразуйте CSV или TSV в массив объектов JSON с типизированными числами и вложенными ключами.
- [YAML в JSON](https://acepdfmd.com/ru/tool/yaml-to-json/): Преобразуйте YAML в чистый JSON, включая файлы с несколькими документами.
- [XML в JSON](https://acepdfmd.com/ru/tool/xml-to-json/): Преобразуйте XML в JSON с атрибутами, повторяющимися элементами в виде массивов и типизированными значениями.
- [JSON в PDF](https://acepdfmd.com/ru/tool/json-to-pdf/): Превратите JSON в удобочитаемый PDF: записи становятся таблицами, а вложенные данные, структурой с заголовками.
- [JSON в Excel](https://acepdfmd.com/ru/tool/json-to-excel/): Преобразуйте JSON в книгу Excel, по одному листу на список записей, вложенные ключи становятся столбцами.
- [JSON в CSV](https://acepdfmd.com/ru/tool/json-to-csv/): Разверните записи JSON в файл CSV, который открывается в любой электронной таблице.
- [JSON в Word](https://acepdfmd.com/ru/tool/json-to-word/): Преобразуйте JSON в редактируемый документ Word с заголовками, списками и таблицами.
- [JSON в HTML](https://acepdfmd.com/ru/tool/json-to-html/): Отобразите JSON как отдельную HTML-страницу с таблицами и структурой для печати.
- [JSON в YAML](https://acepdfmd.com/ru/tool/json-to-yaml/): Преобразуйте JSON в удобочитаемый YAML с ключами в исходном порядке.
- [JSON в XML](https://acepdfmd.com/ru/tool/json-to-xml/): Преобразуйте JSON в корректный, отформатированный XML с выбранным корневым элементом.
- [Форматирование JSON](https://acepdfmd.com/ru/tool/json-formatter/): Проверяйте, форматируйте, минифицируйте, сортируйте или исправляйте JSON с указанием точной строки и столбца любой ошибки.
- [Сравнить JSON](https://acepdfmd.com/ru/tool/json-compare/): Сравните два файла JSON по структуре и получите список всех добавленных, удалённых и изменённых значений по пути.
- [Markdown в JSON](https://acepdfmd.com/ru/tool/markdown-to-json/): Экспортируйте структуру документа как синтаксическое дерево JSON (pandoc AST).
- [JSON в Markdown](https://acepdfmd.com/ru/tool/json-to-markdown/): Превратите данные JSON или pandoc AST в читаемый Markdown с таблицами.

## Больше руководств

- [Шпаргалка по Markdown: справочник синтаксиса с примерами](https://acepdfmd.com/ru/guides/markdown-cheat-sheet/)
- [Размеры и форматы страниц PDF: A4, Letter, Legal и другие](https://acepdfmd.com/ru/guides/pdf-page-sizes/)
- [Как работает сжатие PDF и почему некоторые файлы почти не уменьшаются](https://acepdfmd.com/ru/guides/pdf-compression-guide/)
- [PDF в Markdown: как это работает и как использовать для ИИ](https://acepdfmd.com/ru/guides/pdf-to-markdown-guide/)
- [OCR для PDF и изображений: как получить точный текст](https://acepdfmd.com/ru/guides/ocr-guide/)
- [Безопасно ли загружать PDF онлайн? Руководство по приватности](https://acepdfmd.com/ru/guides/privacy-guide/)
- [Открыть и преобразовать файлы iWork (Pages, Numbers, Keynote) без Mac](https://acepdfmd.com/ru/guides/iwork-guide/)