У цій статті
Що таке таблиці Markdown?
Таблиці Markdown використовують символи вертикальної риски (|) та дефіси (-) для створення структурованих табличних даних у текстових документах. Вони є частиною GitHub Flavored Markdown (GFM) і підтримуються більшістю рендерерів Markdown, включаючи GitHub, GitLab, VS Code та генератори статичних сайтів.
Таблиці в Markdown призначені для простого відображення даних — заголовки стовпців, рядок-роздільник та рядки даних. Вони відображаються як повноцінні HTML-таблиці у результаті, що робить їх ідеальними для документації, файлів README та технічного написання без знання HTML.
Синтаксис таблиць Markdown
Таблиця Markdown складається з трьох частин: рядка заголовка, рядка-роздільника та одного або кількох рядків даних.
- Рядок заголовка — перший рядок визначає назви стовпців, розділених символами вертикальної риски (|). Початкові та кінцеві риски є необов'язковими, але рекомендуються для ясності.
- Рядок-роздільник — другий рядок використовує дефіси (---) між рисками для відокремлення заголовка від даних. Вимагається щонайменше три дефіси на стовпець.
- Рядки даних — кожен наступний рядок містить значення комірок, розділені рисками. Комірки не обов'язково вирівнювати візуально, хоча вирівняні стовпці покращують читабельність вихідного коду.
- Екранування рисок — якщо вміст комірки містить буквальний символ риски, екрануйте його зворотною скісною рискою (\|), щоб запобігти його інтерпретації як роздільника стовпців.
Параметри вирівнювання стовпців
Вирівнювання стовпців керується додаванням двокрапок до рядка-роздільника. Це визначає, як текст вирівнюється в кожному стовпці.
- Вирівнювання ліворуч (за замовчуванням) — використовуйте :--- або --- у роздільнику. Текст вирівнюється по лівому краю стовпця. Це значення за замовчуванням, коли двокрапки не вказані.
- Вирівнювання по центру — використовуйте :---: у роздільнику. Текст центрується в межах стовпця. Корисно для міток стану, категорій або коротких значень.
- Вирівнювання праворуч — використовуйте ---: у роздільнику. Текст вирівнюється по правому краю. Ідеально для числових значень, цін, лічильників і вимірювань.
Спробуйте безкоштовно — реєстрація не потрібна
Згенерувати таблиці Markdown →Поширені варіанти використання
Таблиці Markdown використовуються скрізь, де потрібно представити структуровані дані в документації.
- Документація README — таблиці порівняння функцій проєкту, вимоги до встановлення, підтримувані платформи та матриці сумісності версій
- Документація API — довідники ендпоінтів з методом, шляхом, описом та таблицями параметрів для кожного маршруту
- Порівняльні таблиці — порівняння функцій поруч, цінові рівні та оцінки інструментів у дописах блогу та технічних оглядах
- Журнали змін — таблиці історії версій з датою, номером версії та описом змін для кожного випуску
Поради та найкращі практики
Дотримання цих рекомендацій допоможе зберегти таблиці Markdown читабельними як у вихідному, так і у відрендереному вигляді.
- Зберігайте вирівнювання стовпців у вихідному коді — доповнюйте комірки пробілами, щоб стовпці вирівнювалися візуально. Більшість редакторів та наш генератор роблять це автоматично. Вирівняний вихідний код набагато легше переглядати у pull request-ах.
- Уникайте складного вмісту в комірках — таблиці Markdown не підтримують багаторядковий вміст комірок, блокові елементи або вкладені таблиці. Зберігайте вміст комірок коротким і простим. Для складних даних розгляньте можливість використання HTML-таблиць.
- Обмежуйте кількість стовпців — таблиці з більш ніж 5-6 стовпцями стають важкочитаними на менших екранах. Розгляньте можливість розбиття широких таблиць на кілька тематичних або використання іншого формату для дуже широких даних.
Часті запитання
Чи є обмеження на вміст комірок у таблицях Markdown?
Технічного обмеження на кількість символів у вмісті комірки немає, але комірки таблиці Markdown є однорядковими. Ви не можете включати переноси рядків, абзаци або блокові елементи, як-от списки, всередину комірки. Для складного вмісту комірок використовуйте HTML-таблиці з елементами <td>, що підтримують будь-який HTML-вміст.
Чи можна об'єднувати комірки у таблицях Markdown?
Ні. Стандартні таблиці Markdown не підтримують colspan або rowspan — кожен рядок повинен мати однакову кількість стовпців. Об'єднання комірок потребує HTML-таблиць. Якщо вам потрібні об'єднані комірки, напишіть таблицю в HTML і вставте її безпосередньо у свій Markdown-документ.
Чи можна вкладати таблиці всередину таблиць Markdown?
Ні. Таблиці Markdown не можна вкладати одна в одну. Кожна таблиця є плоскою сіткою рядків і стовпців. Якщо вам потрібні ієрархічні дані, розгляньте можливість використання вкладених списків, окремих таблиць із заголовками або HTML-таблиць із вкладеними елементами <table>.