Конвертер CSV в Markdown

Файлы README, описания пул-реквестов и сайты документации прекрасно отображают таблицы Markdown, если у вас есть желание вручную расставлять вертикальные черты и дефисы. Этот конвертер считывает CSV, берёт первую строку в качестве заголовка и выдаёт таблицу GitHub Flavored Markdown с правильной строкой-разделителем. Каждая ячейка обрамляется символами |, готовыми к вставке в README или описание пул-реквеста.

Как строится таблица

  1. 1

    Вставьте CSV

    По умолчанию загружен образец из трёх столбцов; замените его своими данными.

  2. 2

    Выберите разделитель

    По умолчанию запятая. Выберите в списке табуляцию, точку с запятой или вертикальную черту в соответствии с вашими данными.

  3. 3

    Первая строка является заголовком

    Первая строка выводится как заголовок Markdown, за которым следует обязательная строка-разделитель `| --- | --- |`.

  4. 4

    Строки дополняются до нужной ширины

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

Отображение, выравнивание и где это работает, а где нет

Таблицы GitHub Flavored Markdown (GFM) поддерживаются широко, но не повсеместно. Понимание того, где они отображаются, определяет разницу между аккуратным README и стеной из вертикальных черт.

Поддерживается в

  • Пул-реквестах и вики на GitHub, GitLab и Bitbucket
  • Большинстве генераторов статических сайтов (Docusaurus, VitePress, MkDocs Material)
  • Предпросмотре Markdown в VS Code
  • Notion (через вставку как Markdown)

Не поддерживается в

  • CommonMark без расширения GFM
  • Reddit (использует собственное подмножество)
  • Некоторых устаревших вики-движках (DokuWiki, MoinMoin)

Выравнивание столбцов

Таблицы GFM поддерживают выравнивание по левому краю, по центру и по правому краю с помощью двоеточий в строке-разделителе. Этот конвертер выдаёт обычные разделители ---; если нужно выравнивание, выполните постобработку:

Синтаксис Эффект
:--- Выравнивание по левому краю
:---: Выравнивание по центру
---: Выравнивание по правому краю

Замените строку-разделитель на | :--- | :---: | ---: |, подобрав значения под столбцы, которые нужно выровнять.

Экранирование символов в ячейках Markdown

  • Символы вертикальной черты (|) внутри ячейки необходимо экранировать как \\|, чтобы ячейка не разбивалась. Конвертер не делает этого автоматически, поэтому очистите данные заранее, если в них есть вертикальные черты.
  • Переносы строк внутри ячейки ломают отображение GFM. Замените их на <br> перед преобразованием, если хотите получить мягкие переносы строк внутри ячейки.
  • Звёздочки, подчёркивания и обратные кавычки проходят как есть и интерпретируются как выделение или код в Markdown. Чтобы вывести их буквально, поставьте перед ними обратную косую черту.

Часто задаваемые вопросы

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

Перед преобразованием экранируйте их обратной косой чертой, превратив | в \|. Иначе обработчик Markdown воспримет их как разделители столбцов и сломает таблицу.

Таблицы GFM отображаются на GitHub, GitLab, в большинстве генераторов статических сайтов и в VS Code. Они не отображаются в чистом CommonMark, на Reddit и в некоторых устаревших вики без плагина.

Да. CSV отправляется на наш сервер, чтобы конвертер мог построить таблицу. Он не сохраняется и не добавляется в ссылку на страницу.

Сопутствующие инструменты

Справочная таблица ASCII

Полная таблица ASCII от 0 до 127 с десятичным, шестнадцатеричным, восьмеричным и двоичным представлением, а также записью числовых ссылок HTML, включая NUL, LF и DEL.

Справочник сочетаний клавиш

Ищите документированные сочетания по умолчанию для VS Code, Chrome и Bash с GNU Readline в macOS, Windows и Linux.

Справочник символов HTML

Справочник HTML-сущностей с поиском, их именованными и числовыми кодами, а также копированием специальных символов и знаков одним кликом.

Счетчик FPS

Измерьте FPS браузера через requestAnimationFrame: сглаживание, минимальная и максимальная частота кадров, порог предупреждения и график по желанию. Работает локально, без загрузок и API.

Генератор случайных букв

Генерируйте случайные буквы A-Z. Выберите количество, верхний или нижний регистр либо смешанный вариант для игр, заданий и уроков.

Генератор цветовой палитры

Создавайте монохромные, аналоговые, комплементарные, триадные или тетрадные палитры из базового HEX-цвета и экспортируйте готовые CSS-переменные.

Инструмент доступен на других языках