ViewCSVОткройте или вставьте CSV-файл — рядом с настройками появится таблица с вертикальными чертами, готовая для README, задачи или вики-страницы. Символ | внутри значения записывается как \|, поэтому он никогда не разобьёт ячейку, переносы строк внутри ячейки превращаются в <br>, а числовые столбцы выравниваются по правому краю. Файл конвертируется в вашем браузере и никогда не загружается на сервер.
Как преобразовать CSV в Markdown
- Нажмите Открыть файл, перетащите на инструмент файл
.csv,.tsvили.txtили выберите Вставить. Разделитель определяется автоматически; если он определён неверно, задайте его, кодировку или Первая строка — заголовки столбцов в разделе Параметры импорта. - Выберите Выравнивание столбцов и то, как записываются Переносы строк в ячейках. На вкладке Markdown виден ровно тот текст, который окажется в скачанном файле.
- Нажмите Копировать, чтобы вставить таблицу прямо в GitHub, GitLab или свой редактор, или Скачать Markdown, чтобы сохранить файл
.md.
Если в файле нет строки заголовков, отключите Первая строка — заголовки столбцов: таблице Markdown заголовок нужен всегда, поэтому столбцы получат названия Column 1, Column 2 и так далее. Чтобы показать те же данные в виде веб-таблицы, воспользуйтесь CSV в HTML.
Что делает каждая настройка
| Числа справа, текст по умолчанию | Вариант по умолчанию. Столбец выравнивается по правому краю (---:), только если каждое непустое значение — простое число; из-за 00731 или 12 kg столбец остаётся с выравниванием по умолчанию, принятым в программе отображения. |
|---|---|
| По умолчанию (без выравнивания), по левому краю, по центру, по правому краю | Одно выравнивание для всех столбцов: в строке-разделителе просто ---, :---, :---: или ---:. |
| Оставить как <br> | Перенос строки внутри ячейки становится <br>, и GitHub и большинство программ отображения показывают его как новую строку в ячейке. Это вариант по умолчанию. |
| Заменить пробелом | Каждый перенос строки заменяется одним пробелом — для программ отображения, которые удаляют HTML. |
| Экранировать символы Markdown | По умолчанию включено. Перед *, _, [, ], <, >, #, ~ и обратным апострофом ставится обратная косая черта, так что значение вроде *fast* или <b> показывается как введено, а не превращается в форматирование или HTML. Отключайте, только если в ячейках Markdown, который нужно отобразить. |
| Выровнять столбцы в исходном тексте | По умолчанию включено. Ячейки дополняются пробелами, чтобы и сам файл .md читался как сетка. Широкие символы — китайские, японские, корейские — считаются за два столбца. Отключите ради самого компактного результата: отображаемая таблица выглядит так же. |
Как обрабатываются сложные данные
- Вертикальные черты и обратные косые черты экранируются всегда (
\|,\\), даже если Экранировать символы Markdown отключено: неэкранированный|начал бы новую ячейку. - Запятые и переносы строк в кавычках читаются по RFC 4180, поэтому
"Cable tidy, 3-pack"остаётся в одной ячейке. Значения, в которых был перенос строки, подсчитываются в уведомлении над предпросмотром. - Значения записываются как текст:
00731сохраняет нули, а34.90— завершающий ноль. Ничего не округляется и не переформатируется. - Пустой заголовок становится
Column 3, повторяющийся —name (2), так что у каждого столбца свой заголовок. - Программы отображения Markdown обрезают пробелы в начале и в конце ячейки, а в таблице не может быть списков или абзацев; такое содержимое держите в отдельном документе.
Устранение неполадок
- Текст после таблицы приклеивается к её последней строке. Таблица заканчивается только на пустой строке или в начале другого блока, поэтому оставьте после неё пустую строку.
- Все значения в одном столбце. Разделитель определён неверно. Выберите запятую, точку с запятой, табуляцию или вертикальную черту в параметрах импорта и откройте файл заново.
- **В результате перед * или _ видны обратные косые черты.** Это работает экранирование в программе отображения, которая его не поддерживает. Если в ваших данных нет символов форматирования, которые нужно защищать, отключите «Экранировать символы Markdown».
- Переносы строк отображаются как тег. Программа отображения не допускает HTML. В поле «Переносы строк в ячейках» выберите «Заменить пробелом».
Ограничения и конфиденциальность
Файлы до 25 МБ, 100 000 строк или 2 млн ячеек открываются с живым предпросмотром первых 200 строк. Бо́льшие файлы конвертируются в потоковом режиме: файл читается частями дважды (сначала чтобы измерить столбцы и их ширину, затем чтобы записать результат), уведомление сообщает, что скачанный файл охватывает весь файл, а кнопки Копировать нет. Один выходной файл ограничен 4 ГБ.
Конвертация идёт в фоновом обработчике в этой вкладке, поэтому страница не зависает, а кнопка Отмена её останавливает. CSV никогда не отправляется на сервер. Чтобы проверить большой файл перед конвертацией, откройте его в просмотре CSV.
Пример
Список товаров с артикулом, начинающимся с нуля, вертикальной чертой в названии, запятой в кавычках и двухстрочной заметкой, преобразованный с настройками по умолчанию. price выровнен вправо, потому что все значения — числа; sku — нет, потому что 00731 хранится как текст.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Вопросы и ответы
Работает ли результат на GitHub?
Да. Это таблица GitHub Flavored Markdown с вертикальными чертами: строка заголовков, строка-разделитель с необязательными двоеточиями для выравнивания и по строке на каждую строку CSV. Тот же синтаксис понимают GitLab, Obsidian и большинство генераторов статических сайтов.
Почему в исходном тексте виден `\|`?
Обычный | в таблице Markdown завершает ячейку. Обратная косая черта говорит программе отображения показать вертикальную черту как текст, поэтому Desk lamp | brass остаётся в одной ячейке.
Можно ли преобразовать таблицу Markdown обратно в CSV?
На этой странице — нет. Она преобразует только CSV и TSV в Markdown.