Таблица в Markdown, HTML и другие разметки

Восемь разметок: где какая нужна

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

Одна таблица в четырёх разметках

Что умеет конвертер разметки

Конвертер принимает таблицу в любом ходовом виде: диапазон из Excel и Google Таблиц приходит с табуляциями, CSV разбирается с угаданным разделителем и кавычками, готовая Markdown-таблица с вертикальными чертами и HTML с тегом table разбираются в клетки, разметка Jira и MediaWiki тоже понимается на входе. Первая строка считается шапкой, галочка это выключает; таблицу можно транспонировать перед выгрузкой.

На выходе восемь разметок. Markdown с выравниванием через двоеточия в разделительной строке и столбцами, выровненными пробелами, чтобы таблица читалась и в исходнике; HTML с thead и tbody, необязательным классом и подписью caption; моноширинный текст с рамкой из плюсов, псевдографики или без рамки для Telegram и консоли; LaTeX tabular с booktabs; SQL с CREATE TABLE и INSERT, где типы столбцов угаданы по данным; разметки Jira, MediaWiki и reStructuredText.

Спецсимволы экранируются по правилам каждой разметки: вертикальная черта в Markdown, угловые скобки и амперсанд в HTML, амперсанд, процент и подчёркивание в LaTeX, кавычки в SQL. Числовые столбцы выравниваются вправо везде, где формат это умеет. Под кодом стоит предпросмотр, код копируется или скачивается файлом с нужным расширением, а Markdown-таблица уходит обратно в Excel кнопкой «Копировать как TSV».

От tabular до GitHub Flavored Markdown

Разметка таблиц старше веба: в TeX Дональда Кнута 1978 года и LaTeX Лесли Лэмпорта 1984-го таблицы набирали окружением tabular, где столбцы разделяет амперсанд, а строки — двойная обратная косая черта. Пакет booktabs 1995 года убрал вертикальные линии и научил печатать таблицы по правилам типографики: три горизонтальные линейки и воздух между ними.

HTML получил тег table в 1995 году в черновике HTML 3.0, и первые годы таблицами верстали целые страницы; с приходом CSS они вернулись к данным, а теги thead, tbody и th отделили шапку от тела. Вики-движки придумали свои сокращения: MediaWiki с 2002 года использует фигурные скобки и вертикальные черты, Jira и Confluence — двойные черты для шапки.

Джон Грубер выпустил Markdown в 2004 году без таблиц вовсе; их добавили расширения, и в 2017 году GitHub закрепил синтаксис с вертикальными чертами и разделительной строкой в спецификации GitHub Flavored Markdown. Сегодня это самый частый способ записать таблицу в документации, а Telegram, где таблиц нет до сих пор, вернул к жизни моноширинный текст с рамкой из плюсов и минусов, как на пишущей машинке.

Как перевести таблицу в нужную разметку

Вставьте таблицу в левое поле: из Excel через буфер, CSV из выгрузки, Markdown или HTML из документа. Строка под полем покажет, какой формат распознан и сколько строк и столбцов получилось; если разбор неверен, поправьте разделители в исходнике или загрузите файл кнопкой.

Выберите разметку справа и настройте её: выравнивание чисел, выровненные столбцы для Markdown, класс и caption для HTML, вид рамки для текста, booktabs для LaTeX, имя таблицы и CREATE TABLE для SQL. Предпросмотр внизу показывает таблицу так, как её увидит читатель.

Скопируйте код или скачайте файл с расширением разметки. Для Telegram оберните текст в тройные обратные кавычки, чтобы сохранить моноширинный шрифт. Обратный путь тоже работает: Markdown или HTML на входе, «Копировать как TSV» на выходе — и таблица вставляется в Excel по клеткам.