Як зробити таблицю в Markdown:синтаксис, вирівнювання та багаторядкові комірки.

Базовий синтаксис таблиці в Markdown

Таблиці входять до GitHub Flavored Markdown (GFM), діалекту GitHub, GitLab і більшості Markdown-застосунків. Для таблиці потрібні три речі:

1. Рядок заголовка

   Назви стовпців, розділені вертикальними рисками: | Name | Role |.

2. Рядок-розділювач

   Рядок із дефісів, по одній групі на стовпець, просто під заголовком: | --- | --- |. Комірок у ньому має бути стільки ж, скільки в заголовку, інакше текст залишиться звичайним і таблиці не буде.

3. Рядки таблиці

   По одному рядку на запис, комірки розділені вертикальними рисками. Якщо в рядку комірок не вистачає, він доповнюється порожніми, зайві відкидаються. Таблиця закінчується на першому порожньому рядку.

| Name  | Role     |
| ----- | -------- |
| Alice | Designer |
| Bob   | Engineer |

Так це бачить читач:

Вертикальні риски на початку й наприкінці рядка необов'язкові, але з ними таблицю легше читати. Стовпці у вихідному тексті не мусять бути рівними: вирівнювання пробілами вище потрібне лише людям. У комірках можна використовувати напівжирний, курсив, код, посилання та зображення.

Вирівнювання в таблиці Markdown

Поставте двокрапку ліворуч, праворуч або з обох боків від дефісів стовпця:

| Item   | Qty | Price |
|:-------|:---:|------:|
| Pencil |  12 |  $1.50 |
| Ruler  |   3 |  $4.00 |

Вирівнювання діє на весь стовпець, разом із заголовком. Воно задається один раз у рядку-розділювачі, а не в кожній комірці. Числа краще вирівнювати по правому краю, щоб розряди стояли один під одним.

Вертикальна риска або другий рядок у комірці

Вертикальна риска закриває комірку, тому риску, що входить до тексту, треба екранувати зворотною скісною рискою. GFM вимагає цього навіть усередині рядкового коду:

| Command            | Meaning          |
|--------------------|------------------|
| `a \| b`           | a pipe, in code  |
| Either \| or       | a pipe, in text  |

У таблиці на вертикальних рисках один рядок відповідає одному запису, тому в комірці не можна зробити справжній перенос рядка чи другий абзац. Звичайний обхід — HTML-тег <br>:

| Step  | What to do                          |
|-------|-------------------------------------|
| Build | Run the build.<br>Fix any errors.  |
| Ship  | Tag the release.<br>Push the tag.  |

Той самий прийом дає багаторядкову комірку на GitHub і в більшості інших застосунків, які приймають HTML. Список Markdown у комірці не працює: якщо в комірці потрібен список, поставте <br> між короткими пунктами або винесіть список із таблиці.

Широкі таблиці й довгий текст

У Markdown не можна задати ширину стовпця чи об'єднати комірки: як вмістити таблицю, вирішує застосунок, який її показує. Кілька звичок зроблять таблицю читабельною скрізь:

• Робіть комірки короткими: слово або число. Довге пояснення винесіть у речення під таблицею.
• Беріть менше стовпців. Якщо їх вісім, переверніть таблицю: нехай стовпці будуть об'єктами, а рядки — їхніми властивостями.
• Не вирівнюйте вихідний текст пробілами в таблиці, яку часто правите: через одну змінену комірку довелося б переробляти відступи в усіх рядках.
• Якщо потрібні об'єднані комірки, комірки на кілька рядків чи підпис, напишіть таблицю на HTML. Більшість Markdown-застосунків показують звичайний <table>.

Чому таблиця Markdown не відображається

• Немає рядка-розділювача. Саме рядок із дефісів перетворює текст на таблицю.
• Кількість комірок не збігається. Якщо в заголовку три комірки, а в розділювачі дві, нічого не відобразиться.
• Неекранована вертикальна риска в комірці ділить її навпіл. Пишіть \|.
• Порожній рядок усередині таблиці. На ньому таблиця закінчується, решта — звичайний текст.
• У застосунку немає таблиць. Таблиць немає ні у вихідному Markdown, ні в ядрі CommonMark. Вони прийшли з GFM, тому мінімальний парсер покаже вертикальні риски як текст.

Щоб побачити результат до коміту, відкрийте файл у програмі для читання Markdown. DotMD показує таблиці відмальованими, і читати в ньому безкоштовно. У DotMD Editor команда Insert → Table вставляє у файл готову таблицю з трьох стовпців, а живий попередній перегляд перемальовує її в міру набору.

Питання про таблиці в Markdown

Інші запитання