Що це
Набирати таблиці Markdown вручну виснажливо: у кожному рядку потрібні вертикальні риски, у другому — дефіси, а вирівнювання стовпців вручну забирає купу часу. Цей інструмент перетворює дані CSV або TSV на таблицю GitHub Flavored Markdown, яку можна вставити в README, pull request, задачу, вікі чи будь-яку документацію в Markdown.
CSV розбирається коректно: поля в лапках із комами, подвоєні лапки й багаторядкові клітинки обробляються правильно. Вивід доповнюється пробілами, щоб стовпці були рівними й у звичайному тексті, — так таблицю легше читати й редагувати.
Як користуватися
- Вставте CSV або TSV, завантажте файл
.csvчи.tsvабо натисніть Приклад. - Виберіть Вирівнювання: типово, ліворуч, по центру, праворуч або Числа праворуч, щоб вирівняти праворуч стовпці, де лише числа.
- Залиште Перший рядок — заголовок увімкненим, якщо в першому рядку назви стовпців; інакше заголовком стануть Column 1, Column 2 і так далі.
- Вимкніть Вирівнювати стовпці, якщо потрібні компактні рядки без доповнення.
- Скопіюйте таблицю або завантажте її як файл
.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, скористайтеся пов’язаними інструментами нижче.
Часті запитання
› Який варіант Markdown використовує таблиця?
Таблиці з вертикальними рисками з GitHub Flavored Markdown (GFM). Їх також підтримують GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs і більшість генераторів статичних сайтів. У чистому CommonMark синтаксису таблиць немає.
› Що відбувається з вертикальними рисками й переведеннями рядка в клітинках?
Вертикальна риска завершила б клітинку, тому її записують як \|. Переведення рядка всередині рядка таблиці не дозволене, тому воно стає тегом <br>, який GitHub і більшість рендерерів показують як перенесення рядка.
› Чому стовпці з китайським, японським чи корейським текстом вирівняні?
Коли ввімкнено «Вирівнювати стовпці», клітинки доповнюються з урахуванням ширини відображення: широкі східноазійські символи рахуються як два стовпці, тож вихідний Markdown лишається рівним у редакторі з моноширинним шрифтом. Відображена таблиця однакова в обох випадках.
› Чи можна конвертувати TSV, скопійований з Excel або Google Таблиць?
Так. Клітинки, скопійовані з електронної таблиці, розділені табуляцією, і роздільник визначається автоматично. Також можна явно вибрати табуляцію.