Таблицы в Markdown
Markdown задумывался как простой формат, и таблиц в исходной спецификации не было. Их добавили расширения — прежде всего GitHub Flavored Markdown, синтаксис которого стал фактическим стандартом. Сейчас такие таблицы понимают GitHub, GitLab, Obsidian, Notion, Telegraph и большинство генераторов документации.
Синтаксис простой: колонки разделяются вертикальной чертой, вторая строка задаёт выравнивание. Сложность в том, что вручную набирать такое утомительно — особенно когда колонок больше трёх, а данные нужно ещё и выровнять по ширине.
Выравнивание колонок
| Запись | Результат |
|---|---|
| :--- | По левому краю |
| :---: | По центру |
| ---: | По правому краю |
| --- | По умолчанию, обычно влево |
Числа принято выравнивать вправо — так разряды выстраиваются друг под другом и колонку легче читать. Заголовки и текст оставляют слева.
Что можно внутри ячеек
- Форматирование текста — жирный, курсив, зачёркнутый, код в обратных кавычках
- Ссылки и изображения — обычным синтаксисом Markdown
- Вертикальная черта — только экранированная обратным слэшем
Чего нельзя: переносов строк внутри ячейки, объединения ячеек, вложенных таблиц и списков. Это принципиальные ограничения формата. Если нужна сложная структура, придётся использовать HTML прямо в Markdown — большинство обработчиков его пропускают.
Перенос данных из Excel
Скопируйте диапазон в табличном редакторе и нажмите кнопку вставки — данные разложатся по ячейкам автоматически. Работает и с CSV: инструмент распознаёт разделение табуляцией, точкой с запятой и запятой.