Как пользоваться
- Выберите направление Преобразовать: CSV или TSV в таблицу Markdown либо таблицу Markdown в CSV.
- Вставьте текст в поле Текст для преобразования. В CSV первая строка — это заголовок таблицы.
- Оставьте Выравнивание столбцов на «Автоматически», которое ставит числа справа, или выберите одну сторону для каждого столбца.
- Скопируйте Таблицу Markdown или CSV — в зависимости от выбранного направления.
Синтаксис таблицы Markdown
Таблица в расширении таблиц GitHub Flavored Markdown имеет строку заголовка, строку-разделитель и строки данных. Ячейки записываются между вертикальными чертами, а строка-разделитель имеет одну ячейку для каждого столбца из дефисов с необязательным двоеточием на любом конце. Спецификация GFM (на английском) требует, чтобы строка-разделитель имела столько же ячеек, сколько заголовок. Двоеточие слева выравнивает столбец по левому краю, двоеточие справа — по правому, а двоеточия с обеих сторон центрируют его.
Строка данных с меньшим числом ячеек, чем в заголовке, получает пустые ячейки. Строка с большим числом ячеек теряет лишние. Вертикальная черта внутри ячейки записывается с обратной косой чертой перед ней, чтобы отрисовщик оставил её в ячейке.
| заголовок | заголовок | затем | --- | ---: | затем | данные | данные |Ширина столбцов, числа и экранирование
Каждый столбец так же широк, как его самая широкая ячейка, но не меньше трёх символов, поэтому каждая строка дополненной таблицы имеет одинаковую длину. Столбец, в котором все заполненные ячейки — числа, выравнивается по правому краю, что делает цифры удобными для сравнения. Ширина считается в символах, поэтому широкая буква может выровняться не точно.
Строка таблицы должна занимать одну строку, поэтому перенос строки внутри ячейки CSV записывается как пробел. Чтение CSV следует обычным правилам: ячейка, в которой есть запятая или кавычка, заключается в кавычки, а кавычка внутри неё удваивается.
- Выберите разделитель сами, когда «Определить» выбирает не тот: русская таблица часто использует точки с запятой.
- Выключите «Выровнять столбцы», когда текст Markdown длинный и размер файла важнее раскладки исходного текста.
Пример: прайс-лист с вертикальной чертой в одном названии
Исходный текст имеет заголовок Товар;Цена;Остаток и строки Чай;12,5;40 и Кофе | зерна;85;12. Ячейка Кофе | зерна занимает 13 символов, когда её вертикальная черта экранирована, поэтому столбец Товар имеет ширину 13. Столбцы Цена и Остаток — 4 и 7 символов, потому что их числа выровнены по правому краю.
Строка-разделитель — ------------- (13 дефисов) для столбца Товар, ---: для Цена и ------: для Остаток. Строка Кофе читается как Кофе \| зерна, а затем 85 и 12, прижатые вправо. В таблице 2 строки данных и 3 столбца.
Частые вопросы
Зачем в ячейке нужна обратная косая черта перед вертикальной чертой?
Вертикальная черта — разделитель столбцов в таблице Markdown, поэтому голая вертикальная черта внутри ячейки начала бы новый столбец. Обратная косая черта перед ней оставляет её в ячейке, и отображаемая таблица показывает одну вертикальную черту.
Меняют ли пробелы, добавленные для выравнивания, вид таблицы?
Нет. Отрисовщики игнорируют пробелы вокруг текста ячейки, поэтому таблица выглядит одинаково. Дополнение лишь делает исходный Markdown удобнее для чтения в редакторе.
Почему столбцы чисел выровнены по правому краю?
Цифры легче сравнивать, когда их последние разряды совпадают, поэтому автоматическое выравнивание ставит столбец чисел справа. Столбец с любым текстом остаётся обычным, по левому краю.
Что происходит с переносом строки внутри ячейки CSV?
Строка таблицы должна занимать одну строку, поэтому инструмент записывает перенос строки внутри ячейки как пробел. Текст ячейки остаётся прежним, не считая этого пробела.
Где таблицы Markdown отображаются правильно?
GitHub и большинство инструментов Markdown, которые следуют расширению таблиц GFM, отображают их. Некоторые простые отрисовщики Markdown не имеют синтаксиса таблиц вовсе, поэтому проверьте место, где будете публиковать таблицу.
Отправляется ли или сохраняется ли вставленный текст где-нибудь?
Нет. Таблица и CSV создаются в вашем браузере. Ничего не сохраняется и не отправляется на наш сервер, поэтому скопируйте результат, прежде чем покинуть страницу.
Источники
- GitHub Flavored Markdown Spec, расширение таблиц (на английском)
- IETF: RFC 4180, Common Format and MIME Type for CSV Files (на английском)
Цифры и текст в последний раз проверены вторник, 10 ноября 2026 г..