Таблиці в Markdown: як їх писати й читати

Таблиця в Markdown це звичайний текст, що перетворюється на сітку. Ти вводиш слова, вертикальні риски | і дефіси -. Засіб читання Markdown показує рядки та стовпці.

Таблиці є всюди у файлах Markdown: прайс-листи, плани, порівняння, результати тестів. Чати зі ШІ й агенти для програмування пишуть їх постійно.

Базова таблиця

| Fruit  | Colour | Price |
|--------|--------|-------|
| Apple  | Red    | 1.20  |
| Banana | Yellow | 0.50  |

Ось що вона показує:

FruitColourPrice
AppleRed1.20
BananaYellow0.50

Три види рядків:

  1. Рядок заголовка: назви стовпців.
  2. Рядок із дефісів: відокремлює заголовок від решти. Він обов’язковий. Без нього таблиці немає.
  3. Рядки даних: один рядок на один рядок таблиці.

Вертикальні риски | розділяють клітинки. Риски на початку й наприкінці кожного рядка необов’язкові, але з ними таблицю легше читати.

Стовпці не мусять вирівнюватися у твоєму тексті. Так теж працює:

| Fruit | Colour | Price |
|---|---|---|
| Apple | Red | 1.20 |

Залиш порожній рядок до і після таблиці. Таблиця закінчується на першому порожньому рядку.

Вирівнювання стовпців

Додай двокрапки : до рядка з дефісів:

| Left | Centre | Right |
|:-----|:------:|------:|
| a    | b      | 1.20  |
| aa   | bb     | 10.50 |
LeftCentreRight
ab1.20
aabb10.50

Форматування всередині клітинки

Клітинки можуть містити жирний шрифт, курсив, код і посилання:

| Task      | Status   | Link                         |
|-----------|----------|------------------------------|
| Write     | **Done** | [Notes](https://example.com) |
| `npm test`| *Running*|                              |

Щоб помістити вертикальну риску всередину клітинки, напиши \|. Інакше вона починає нову клітинку. Це стосується й тексту всередині code.

Чого таблиці не вміють

Широкі таблиці

Таблиця з багатьма стовпцями стає широкою, особливо на телефоні. Кілька порад:

Швидкі способи створити таблицю

Читання таблиць Markdown

У звичайному текстовому редакторі таблиця лишається вертикальними рисками й дефісами. Для малих таблиць це читабельно, а для великих важко. Засіб читання Markdown показує справжню сітку.

PilcrowMD показує таблиці Markdown на Android і Mac. Клітинки можуть містити жирний шрифт, курсив, посилання та формули. На Android широка таблиця прокручується вбік, тож стовпці не стискаються.

Поширені запитання

Чи однакова таблиця Markdown скрізь? Здебільшого. Таблиці входять до GitHub Flavored Markdown, якого дотримується більшість застосунків. Кілька дуже простих застосунків Markdown таблиць не показують узагалі.

Чи можна додати розрив рядка всередині клітинки? У стандартному Markdown ні. Деякі застосунки приймають HTML-тег <br>, але не всі.

Чи треба вирівнювати вертикальні риски? Ні. Це лише полегшує читання тексту.

Також для Mac: PilcrowMD для Mac (бета)