Конвертер CSV в таблицу Markdown
Набирая таблицу Markdown вручную, приходится считать вертикальные черты и дефисы в каждой строке. Загрузите CSV и получите таблицу со строкой заголовков и строкой-разделителем, готовую для вставки в README, вики-страницу или блокнот.
Конвертер данных
или перетащите сюда файлы CSV, TSV, TXT … ·
Макс. 95 MB на файл· До 20 файлов· Удаляются через 30 минут
Файлы обрабатываются на наших серверах и удаляются через 30 минут.
Символ, разделяющий столбцы в CSV и текстовых файлах, — при чтении и при записи. «Автоопределение» распознаёт его во входном файле, а при записи ставит запятые.
UTF-8 подходит для любого языка. Выберите «UTF-8 с BOM», если Excel в Windows искажает при открытии CSV буквы с диакритикой, кириллицу или азиатские символы.
Для файлов Excel, ODS и Numbers: преобразовать только первый лист или все листы (по одному CSV на лист в ZIP или по одному ключу JSON на лист).
Название вкладки листа в новой таблице, до 31 символа.
«Массив объектов» использует имена столбцов как ключи в каждой строке; «Массив массивов» компактнее и хранит заголовок первым массивом.
Имя внешнего элемента, который содержит все строки; каждая строка становится элементом <row> внутри него.
Используется в операторах CREATE TABLE и INSERT. Только латинские буквы, цифры и подчёркивания.
Кавычки и типы столбцов немного различаются в разных СУБД; выберите ту, в которую будете импортировать.
Приводит ячейки с датами к одному формату. ISO (2026-10-18) надёжнее всего для баз данных и кода; «Оставить как есть» сохраняет даты в исходном виде.
Как пользоваться инструментом
- 1
Загрузите CSV
Добавьте файлы .csv, .tsv или .txt с разделителями: до 20 за раз, каждый до 95 MB. Автоопределение распознаёт запятые, точки с запятой, табуляцию и вертикальные черты.
- 2
Проверьте строку заголовков
Параметр Первая строка — заголовок включён, поэтому первая строка станет заголовком таблицы. Если файл начинается сразу с данных, отключите его в разделе Расширенные настройки.
- 3
Конвертируйте и вставьте
Нажмите Конвертировать в Markdown table, откройте файл .md и вставьте таблицу в README, pull request, issue или заметку.
Как превратить CSV-файл в таблицу Markdown?
Загрузите CSV и нажмите Конвертировать в Markdown table. Первая строка станет заголовком таблицы, под ней добавится строка из дефисов, а каждая из остальных строк превратится в ряд с ячейками, разделёнными вертикальными чертами.
Зачем разработчики переводят CSV в Markdown
Документация всё чаще живёт в файлах Markdown. Мейнтейнеру нужна таблица поддерживаемых версий в README, инженер вставляет результаты бенчмарков в pull request, исследователь ведёт список литературы в Obsidian. Числа обычно начинаются в электронной таблице или в CSV-выводе скрипта, а собирать их вручную, ставя черту между всеми ячейками, долго и легко ошибиться.
В оригинальном Markdown Джона Грубера 2004 года таблиц не было вовсе. Синтаксис с вертикальными чертами распространился через PHP Markdown Extra, а в 2017 году вошёл в спецификацию GitHub Flavored Markdown, поэтому работает на GitHub и в большинстве инструментов, которые ей следуют. Если строки взяты из Excel, сначала сохраните их через Excel в CSV, а затем конвертируйте здесь.
Пример: CSV в таблицу Markdown
среда,версия,статус Python,3.13,поддерживается Python,3.9,поддержка завершена | октябрь 2025 Node.js,22,поддерживается
| среда | версия | статус | | --- | --- | --- | | Python | 3.13 | поддерживается | | Python | 3.9 | поддержка завершена \| октябрь 2025 | | Node.js | 22 | поддерживается |
Где отображается готовая таблица Markdown
| Организация | Требование | Источник |
|---|---|---|
| GitHub | Отображает таблицы с вертикальными чертами в README, issues, pull requests и вики по спецификации GFM. | Спецификация GFM |
| GitLab | GitLab Flavored Markdown отображает такие же таблицы в репозиториях, issues и merge requests. | — |
| Obsidian | Показывает таблицы в режиме чтения и позволяет редактировать их в режиме живого просмотра. | — |
| Jupyter | Markdown-ячейки в ноутбуках отображают таблицы рядом с вашим кодом. | — |
| CommonMark | В базовой спецификации нет синтаксиса таблиц; рендерерам нужно расширение для таблиц. | commonmark.org |
Факты о форматах CSV и Markdown
CSV
Значения, разделённые запятыми (CSV)
CSV — текстовый формат таблиц, в котором каждая строка файла — это строка таблицы, а столбцы разделяются запятыми. Он используется с первых лет вычислительной техники и описан в RFC 4180, хотя во многих вариантах применяются точка с запятой или табуляция и разные кодировки текста. Почти любая электронная таблица, база данных и аналитический инструмент умеют импортировать и экспортировать CSV, поэтому это стандартный формат для переноса данных между системами. CSV хранит только значения — без формул, форматирования, нескольких листов и типов данных.
- Сжатие
- –
- Прозрачность
- –
- Анимация
- –
- Год появления
- –
MD
Разметка Markdown
Markdown — облегчённый синтаксис разметки, созданный Джоном Грубером в 2004 году. В нём используются обычные текстовые символы — # для заголовков, * для выделения и - для списков, — которые остаются читаемыми в исходном тексте и аккуратно преобразуются в HTML. Это стандарт для файлов README, документации, вики, приложений для заметок и многих генераторов статических сайтов. Существует несколько диалектов, например CommonMark и GitHub Flavored Markdown, которые различаются в деталях вроде таблиц. Файлы .md открываются в любом текстовом редакторе.
- Сжатие
- –
- Прозрачность
- –
- Анимация
- –
- Год появления
- 2004 · John Gruber
CSV превращают в Markdown, когда небольшой набор данных должен жить внутри документации: таблица совместимости в README, список версий в changelog, pull request со сравнением результатов бенчмарков или заметка в личной базе знаний.
Значения при конвертации почти не теряются, а вот замысел данных теряется. CSV хранит каждую строку для программ, а таблица Markdown — это картинка данных для людей: в ней нет типов, формул и объединения ячеек. Храните CSV в репозитории как источник и пересоздавайте таблицу, когда числа меняются.
Вопросы о конвертации CSV в Markdown
Где отображаются таблицы Markdown?
Везде, где рендерер поддерживает расширение с таблицами на вертикальных чертах: GitHub, GitLab, Obsidian, Jupyter notebooks, а также генераторы статических сайтов вроде MkDocs и Hugo. Строгий рендерер CommonMark покажет те же строки обычным текстом с видимыми вертикальными чертами.
Что, если значение в CSV содержит вертикальную черту?
Неэкранированный символ | начнёт новую ячейку и сдвинет все столбцы вправо. Конвертер записывает его как \|: так экранирование определено в GitHub Flavored Markdown, и черта отображается в ячейке как текст.
Можно ли выровнять числа по правому краю?
Да, для этого нужно изменить строку-разделитель: ---: выравнивает столбец по правому краю, :---: по центру, :--- по левому. Добавляйте двоеточия после конвертации: они меняют только отображение таблицы, а не данные.
CSV какого размера имеет смысл превращать в таблицу Markdown?
Таблицы Markdown предназначены для чтения, поэтому лучше всего подходят несколько десятков строк и небольшое число столбцов. Таблица из тысяч строк конвертируется без проблем, но README с ней неудобно прокручивать; лучше дайте в репозитории ссылку на CSV-файл и покажите фрагмент.
Что происходит с переносами строк внутри поля CSV?
Строка таблицы Markdown должна оставаться в одной строке, поэтому значение CSV в кавычках, занимающее несколько строк, нельзя сохранить как есть. Замените переносы до конвертации; на GitHub для принудительного переноса внутри ячейки можно использовать <br>.
Можно ли вместо этого конвертировать таблицу в HTML?
Если результат нужен для веб-страницы, CMS или письма, а не для файла Markdown, выберите в поле Преобразовать в вариант HTML table. Если данные изначально в JSON, на странице JSON в HTML этот вывод выбран заранее.