Что это
Ответы API, выгрузки и настройки часто приходят в JSON, но в README, pull request, вики или сообщении в чате таблицу читать гораздо проще. Этот инструмент превращает массив объектов JSON в таблицу GitHub Flavored Markdown, которая отображается на GitHub, GitLab, в Notion, Obsidian и на большинстве сайтов документации.
Каждый объект становится строкой, каждый ключ — столбцом. Вложенные объекты разворачиваются в имена столбцов с точкой, вертикальные черты и переводы строк в значениях экранируются, а столбцы дополняются пробелами, чтобы ровным был и исходный Markdown.
Как пользоваться
- Вставьте JSON, загрузите файл
.jsonили нажмите Пример. - Выберите Выравнивание: по умолчанию, по левому краю, по центру, по правому краю или Числа вправо, чтобы выровнять вправо столбцы, где только числа.
- Оставьте Разворачивать вложенные объекты включённым, чтобы разложить вложенные поля по столбцам, или отключите, чтобы показывать их как JSON.
- Отключите Выравнивать столбцы, если нужны компактные строки без дополнения.
- Скопируйте таблицу или скачайте её как файл
.md.
Если JSON некорректен, в ошибке указаны строка и столбец, так что исправить его можно быстро.
Пример
Такой JSON:
[
{ "name": "ripgrep", "stars": 48000, "repo": { "owner": "BurntSushi" } },
{ "name": "fd", "stars": 34000, "repo": { "owner": "sharkdp" }, "tags": ["find"] }
]
превращается в такую таблицу Markdown:
| name | stars | repo.owner | tags |
| ------- | ----- | ---------- | -------- |
| ripgrep | 48000 | BurntSushi | |
| fd | 34000 | sharkdp | ["find"] |
Вложенный объект repo стал столбцом repo.owner, массив tags записан как JSON, а в первой строке ячейка пустая, потому что у неё нет tags.
Советы
- Значения записываются как текст: числа и логические значения выводятся как есть, а
nullстановится пустой ячейкой. - Очень широкие таблицы трудно читать; удалите ненужные поля перед преобразованием.
- Встроенная разметка в строковых значениях, например
**жирный**или ссылки, сохраняется и отображается большинством просмотрщиков. - Для данных CSV или чтобы получить HTML-таблицу, воспользуйтесь связанными инструментами ниже.
Частые вопросы
› Какие структуры JSON поддерживаются?
Массив объектов даёт по строке на объект и столбец для каждого ключа, встречающегося хотя бы в одном объекте. Одиночный объект даёт таблицу из двух столбцов Key / Value. Массив массивов даёт строки с пронумерованными столбцами, а массив простых значений — один столбец Value.
› Как обрабатываются вложенные объекты?
При включённом «Разворачивать вложенные объекты» вложенные поля становятся столбцами с точкой, например address.city. Массивы записываются в ячейку компактным JSON. Отключите разворачивание, чтобы каждый вложенный объект оставался JSON в одной ячейке.
› Что, если у объектов разные ключи?
Заголовок — объединение всех ключей в порядке их первого появления. Если у объекта нет ключа, ячейка остаётся пустой; значения null тоже показываются пустыми ячейками.
› Мой JSON куда-то отправляется?
Нет. Разбор и преобразование выполняются полностью в браузере, поэтому ответы API и личные данные не покидают ваше устройство.