Таблицы Markdown — синтаксис GFM и экспорт в Word, PDF, HTML

Таблицы в GitHub Flavored Markdown (GFM) строятся из строк с вертикальными чертами | и разделительной строки с дефисами. Они одинаково рендерятся в редакторе, Word, PDF и HTML на md-to.ru.

Минимальный пример

Исходник:

| Продукт | Цена |
|---------|------|
| Базовый | 990 ₽ |
| Pro     | 1990 ₽ |

Результат: двухколоночная таблица с заголовком «Продукт / Цена» и двумя строками данных.

Выравнивание колонок

Двоеточия в строке |---| задают выравнивание:

| Лево | Центр | Право |
|:-----|:-----:|------:|
| a    |   b   |     c |
| длинный текст | x | 100 |

Синтаксис	Выравнивание
`:---`	по левому краю (по умолчанию)
`:---:`	по центру
`---:`	по правому краю

В Word и PDF выравнивание переносится; очень длинные ячейки переносятся по словам.

Таблица посложнее

## Сравнение форматов экспорта

| Формат | Редактирование | Печать | Веб |
|--------|:--------------:|:------:|:---:|
| DOCX   | да             | да     | нет |
| PDF    | нет            | да     | нет |
| HTML   | через CMS      | да     | да  |

*Источник: внутренняя документация.*

Проверьте preview в редакторе перед экспортом — так быстрее поймать пропущенную | или лишний столбец.

Частые ошибки

Разное число столбцов в строках — таблица может «поехать» или не распарситься.
Нет пустой строки до/после — в редких случаях соседний блок (список) склеивается; оставляйте blank line.
Переносы внутри ячейки — в классическом GFM одна ячейка = одна строка; для многострочного текста используйте <br> в HTML-режиме или разбейте таблицу.
Экранирование | — внутри ячейки пишите \| при необходимости.

Экспорт в Word

Конвертер MD → Word превращает GFM-таблицы в таблицы DOCX с границами. Сложное объединение ячеек (colspan) GFM не поддерживает — только прямоугольная сетка.

Если таблица пришла из ChatGPT — см. статью про ChatGPT → Word.

Экспорт в PDF

Таблицы попадают в print HTML. Широкие таблицы на A4 могут сжиматься — для печати с множеством колонок иногда удобнее Word с альбомной ориентацией или разбиение на две таблицы. Подробнее: MD → PDF с таблицами.

Экспорт в HTML

HTML-конвертер даёт <table>, <th>, <td> — фрагмент можно вставить в CMS. Санитизация удаляет опасные атрибуты; colspan/rowspan из сырого HTML в MD тоже могут быть обрезаны политикой безопасности.

Ограничения GFM

Нет объединения ячеек в чистом синтаксисе pipes.
Нет вложенных таблиц.
Форматирование внутри ячейки — bold, italic, code, ссылки; не блочные code fences.

Итог

Таблицы Markdown — три строки минимум: заголовок, |---|, данные. Выравнивание — через :. Перед отправкой документа проверьте preview и экспортируйте в нужный формат: Word, PDF или HTML.

Таблицы Markdown: синтаксис, выравнивание и экспорт