Конвертер CSV в таблицу Markdown

Что это

Набирать таблицы Markdown вручную утомительно: в каждой строке нужны вертикальные черты, во второй строке — дефисы, а выравнивание столбцов вручную отнимает массу времени. Этот инструмент превращает данные CSV или TSV в таблицу GitHub Flavored Markdown, которую можно вставить в README, pull request, задачу, вики или любую документацию на Markdown.

CSV разбирается корректно: поля в кавычках с запятыми, удвоенные кавычки и многострочные ячейки обрабатываются правильно. Вывод дополняется пробелами, чтобы столбцы были ровными и в простом тексте, — так таблицу легче читать и править.

Как пользоваться

1. Вставьте CSV или TSV, загрузите файл .csv или .tsv либо нажмите Пример.
2. Выберите Выравнивание: по умолчанию, по левому краю, по центру, по правому краю или Числа вправо, чтобы выровнять вправо столбцы, где только числа.
3. Оставьте Первая строка — заголовок включённым, если в первой строке имена столбцов; иначе заголовком станут Column 1, Column 2 и так далее.
4. Отключите Выравнивать столбцы, если нужны компактные строки без дополнения.
5. Скопируйте таблицу или скачайте её как файл .md.

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

Пример

Такой CSV:

Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier

с выравниванием Числа вправо превращается в такую таблицу Markdown:

| Tool    | Stars | Notes                  |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd      | 34000 | find \| but friendlier |

Запятая в поле в кавычках остаётся в ячейке, вертикальная черта экранируется, а числовой столбец получает маркер --: и при отрисовке выравнивается вправо.

Советы

• Маркеры выравнивания во второй строке (:--, :-:, --:) определяют, как выравнивается каждый столбец в отрисованной таблице.
• Встроенная разметка в ячейках, например **жирный**, встроенный код или ссылки, сохраняется и отображается большинством просмотрщиков.
• Очень широкие таблицы трудно читать на маленьких экранах; подумайте о том, чтобы разбить столбцы на несколько таблиц.
• Чтобы создать HTML-таблицу или превратить массив JSON в таблицу Markdown, воспользуйтесь связанными инструментами ниже.