Генератор таблиц Markdown

Генератор таблиц Markdown превращает сетку ячеек в готовый текст разметки: вы заполняете поля, а в окне «Таблица Markdown» появляется код в диалекте GFM. Такой код читают GitHub и GitLab, а также записные книжки и генераторы документации, которые умеют работать с Markdown. Сетка вмещает до 50 строк и 20 столбцов, код обновляется при каждом изменении, а кнопка «Отменить» откатывает до 50 шагов назад. Готовую запись можно скопировать одной кнопкой «Скопировать» и вставить в документ, README или заметку.

Как устроена таблица в Markdown

Запись таблицы в Markdown состоит из трёх частей. Первая строка — шапка: в ней через вертикальные черты записаны названия столбцов. Вторая строка — разделитель: в каждом столбце стоят чёрточки, минимум три. Дальше идут строки с содержимым, по одной строке текста на каждую строку таблицы.

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

Пробелы, которые выравнивают столбцы в исходнике, программе для разбора таблицы не нужны. Они нужны только человеку, читающему код. По умолчанию галочка «Выровнять столбцы пробелами» включена, и исходник получается ровным: черты и чёрточки встают друг под другом. Снимите её, если в ячейках длинные тексты или таблица широкая. Без пробелов код короче и не разъезжается за край экрана.

Как задать выравнивание столбцов

Выравнивание задаётся двоеточиями в строке-разделителе. Двоеточие слева от чёрточек прижимает столбец к левому краю, справа — к правому, а если оно стоит по обе стороны, текст в столбце встаёт по центру. Настройка действует отдельно на каждый столбец: поставьте курсор в любую его ячейку и нажмите кнопку «слева», «по центру» или «справа». Кнопка «без выравнивания» убирает двоеточия, и программа сама решает, как показывать столбец, — чаще всего по левому краю.

Столбцы с числами и ценами выравнивайте по правому краю: разряды встанут друг под другом, и сравнивать значения будет проще.

Как вставить готовую таблицу

Таблицу из Excel или Google Таблиц переносите в сетку напрямую: скопируйте диапазон, поставьте курсор в ячейку сетки и вставьте. Таблица растёт сама, подстраиваясь под размер диапазона; всё, что не влезло в 50 строк и 20 столбцов, отбрасывается, и страница сообщает об этом.

Так же работает обратный путь. Если таблица в Markdown уже написана, вставьте её текст в ячейку сетки: генератор разберёт запись по ячейкам, сохранит выравнивание, и дальше таблицу можно править строками, столбцами и кнопками.

Чего в таблицах Markdown нет

В формате нет объединения ячеек: ни по вертикали, ни по горизонтали таблица Markdown их не делает. Если объединение нужно, берите генератор таблиц HTML с объединением ячеек. Markdown пропускает HTML-код внутри текста, и такая таблица сохранит разметку.

Перевод строки внутри ячейки в Markdown-коде даёт только тег br, обычный перенос в записи таблицы не работает. В сетке для этого достаточно обычного Enter, генератор сам поставит тег в код. Вертикальная черта в тексте ячейки ломает разметку, поэтому генератор экранирует её обратной косой чертой сам.

Проверить, как таблица выглядит внутри документа, поможет редактор Markdown с предпросмотром: вставьте код таблицы и увидите то же, что покажет программа с поддержкой Markdown.