Основи таблиць Markdown: структура, синтаксис та найкращі практики
Markdown став стандартною полегшеною мовою розмітки для розробників, технічних письменників та спеціалістів по всьому світу. Незалежно від того, чи створюєте ви файли GitHub README, пишете технічну документацію в Docusaurus, ведете бази знань у Notion чи особисті нотатки в Obsidian, табличні дані є важливими для чіткої організації інформації. Однак ручний ввід вертикальних рисок, дефісів і вирівнювання пробілів у багатостовпчикових макетах у текстових файлах є нудним і схильним до помилок.
Анатомія таблиць Markdown
Стандартні таблиці Markdown спираються на текстову структуру:
- Рядок заголовка: Верхній рядок містить назви стовпчиків, розділені вертикальними рисками (
|). - Рядок-розділювач: Другий рядок відокремлює заголовки від даних за допомогою дефісів (
-). Цей рядок також керує вирівнюванням. - Рядки даних: Наступні рядки містять комірки даних, розділені рисками.
Наприклад, стандартна таблиця Markdown у формати простого тексту має такий вигляд:
| Функція | Підтримка | Примітки |
| :--- | :---: | ---: |
| Клієнтська сторона | Так | Повністю приватно |
| Швидкість | Миттєво | Виконання в браузері |
| Вартість | Безкоштовно | Без реєстрації |
Вирівнювання в стовпчиках
Вирівнювання в стандартному GitHub Flavored Markdown (GFM) налаштовується в рядку-розділювачі за допомогою двокрапок (:):
- По лівому краю (за замовчуванням):
:---або---двокрапка ліворуч. - По центру:
:---:двокрапки з обох боків. - По правому краю:
---:двокрапка праворуч.
Ручне підтримання пробілів і розділювачів у великих таблицях швидко стає складним. Пропущена вертикальна риска може зламати весь макет Markdown.
Усунення ручної рутини
Використання зручного генератора таблиць Markdown усуває помилки вирівнювання. Замість вирівнювання тексту вручну, наш редактор пропонує візуальну сітку, яка автоматично генерує синтаксис GitHub Flavored Markdown у реальному часі.