Инструменты JSON

JSON в таблицу Markdownполя для понятной документации

Вставьте массив объектов, выберите поля и проверьте их расположение в таблице.

JSON в таблицу Markdown

Входной JSON

Обработка в браузере. Входные данные не отправляются и не сохраняются.

Результат таблицы · Markdown

Преобразуйте данные для просмотра строк.

Параметры вывода

Выбор и порядок столбцов

Преобразование находит поля. Изменение входа или вложенности сбрасывает выбор. Стрелки меняют только порядок столбцов.

Обновление результата…

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

Этот конвертер JSON просматривает весь массив, а не только первый объект. Поле, которое появляется в последней записи, тоже попадает в список. Предварительный просмотр помогает проверить значения и порядок, прежде чем переносить их в README.

Зачем использовать JSON в таблицу Markdown

Сначала найти все поля

JSON в таблицу Markdown собирает ключи в порядке первого появления. Снимите отметки с ненужных полей и переместите остальные стрелками. Меняется только порядок столбцов: строки по-прежнему соответствуют последовательности объектов в исходном массиве.

Поля разных записей выбираются и переставляются в столбцы таблицы

Показать объект целиком или по свойствам

По умолчанию вложенный адрес занимает одну ячейку в виде компактного JSON. Для сравнения городов можно раскрыть пути объектов. Массивы всегда остаются в одной ячейке, поэтому список из нескольких тегов не размножает родительские строки.

Вложенный объект остаётся в одной ячейке или раскрывается в столбцы путей

Как подготовить нужное представление

01

Выбирать поля после настройки структуры

Первое преобразование создаёт список столбцов. Изменение входных данных или способа обработки вложенности сбрасывает выбор и заново собирает поля. Смена формата либо выравнивания сохраняет отмеченные столбцы и их порядок.

02

Управлять моментом обновления

Автоматический режим включён и ждёт 400 мс после последней правки. Если его выключить, доступны кнопка преобразования и Ctrl/Cmd + Enter. Любое изменение входа, параметров или столбцов сразу блокирует экспорт до получения актуального результата.

03

Проверять не только видимые строки

Сначала показаны 50 строк; можно добавлять ещё по 50. Копирование и скачивание включают все записи. В режиме исходного текста видны экранирование и разделитель заголовка. Имя файла соответствует формату: table.md или table.html.

Что сохраняется в ячейках

Отсутствие отличается от null

Если ключа нет, ячейка пустая. Явный null отображается словом null, а false и 0 не исчезают. Пустая строка тоже выглядит пустой, поэтому по одной таблице невозможно восстановить все типы исходного JSON.

Заголовки тоже экранируются

Вертикальные и обратные косые черты обрабатываются как в именах полей, так и в значениях. Разметка выделения и ссылок остаётся текстом. HTML из входа сначала кодируется, и лишь затем настоящие переводы строк заменяются созданными инструментом элементами <br>.

Один набор данных для двух форматов

Выравнивание слева, по центру или справа применяется ко всем столбцам. Markdown содержит обязательный заголовок и строку разделителей. HTML выдаётся как фрагмент table с thead, tbody и областью действия заголовков, без целой веб-страницы.

Числа без промежуточного округления

Длинные целые, экспоненты, конечные десятичные нули и отрицательный ноль сохраняют исходные токены. При раскрытии объектов используются пути JSON Pointer, которые отличают точку в имени ключа от вложенной структуры. Пустые контейнеры остаются {} и [].

Ограничения входа и отображения

Только строгий массив объектов
Из ответа с внешней обёрткой нужно самостоятельно извлечь нужный массив JSON. Отдельные объекты, массивы скаляров, JSONL, JSON5, комментарии и повторяющиеся ключи не принимаются. Загрузки файла, обращения к URL и автоматического исправления нет.
Без изменения состава записей
Обычный заголовок сохраняет исходный ключ. После раскрытия он становится путём вида /user/name; символы / и ~ в ключах записываются как ~1 и ~0. Массивы не разбиваются на строки и не склеиваются разделителем. Сортировки строк, транспонирования, удаления дублей и редактирования ячеек нет.
Итоговый вид зависит от редактора
Используется расширение таблиц GFM. Другой движок может не поддерживать таблицы или запрещать HTML-переносы. Пробелы по краям ячеек могут обрезаться, а повторяющиеся пробелы объединяться. Для точного сохранения типов и пробельных символов оставьте оригинальный JSON. Некоторые платформы автоматически превращают обычные URL в ссылки; здесь они показаны текстом.
Превышение лимита останавливает весь вывод
Пределы: 500 000 входных символов, 50 000 узлов, глубина 100, 10 000 строк, 200 столбцов, 100 000 ячеек и 2 000 000 выходных символов. Пустой массив, только пустые объекты либо отсутствие выбранных полей вызывают ошибку столбцов. Частично обрезанный файл не выдаётся за полный.

Вопросы о JSON в таблицу Markdown

JSON загружается на сервер?

Обработка выполняется в текущем браузере, без отправки и сохранения входа. Инструмент также не получает данные по удалённому адресу. Перед публикацией документа проверьте, какие поля вы оставили в таблице.

Какой размер поддерживается?

Проверяется не только длина текста, но и число узлов, глубина, размеры таблицы, ячейки и итоговый текст. Разреженный массив с множеством разных ключей может быстро исчерпать лимит ячеек. Превышение любого предела останавливает преобразование целиком.

Теряются ли вложенные объекты?

По умолчанию объекты и массивы остаются компактным JSON в одной ячейке. Можно раскрыть только объекты в столбцы путей. Это представление для чтения, а не полностью обратимое хранение: пустая строка и отсутствие свойства выглядят одинаково.

Подходит ли результат для GitHub?

Да, используются заголовок, разделительная строка и обозначения выравнивания GitHub Flavored Markdown. Для другой платформы проверьте поддержку <br>. Если редактор принимает HTML, выберите этот формат с тем же набором столбцов.

Как использовать JSON в Markdown?

Преобразование JSON в Markdown удобно для сравнения свойств нескольких записей. Если нужно показать целую конфигурацию и её иерархию, лучше сохранить JSON в блоке кода. Этот инструмент не создаёт списки или полноценные документы.

Нашли случай, который обрабатывается неверно?

Подготовить таблицу для читателя

Используйте JSON в таблицу Markdown, чтобы собрать связанные поля в нужном порядке. Проверьте пример, необязательные свойства и вложенные значения, затем перенесите полный актуальный результат в документацию.