Блог Calcup · Информатика
CSV в Markdown без ручной правки разделителей
Короткая заметка о релизе Calcup на 27 июня: добавили конвертер CSV и TSV в Markdown-таблицу
В этой заметке
Коротко
- Когда таблица нужна прямо в README
- Кавычки и pipe-символы считаются отдельно
- TSV тоже закрыт
- Границы расчёта
В статье
Когда таблица нужна прямо в README
Небольшие таблицы часто живут не в spreadsheet, а в README, issue, wiki или changelog. Данные при этом обычно приходят как CSV из экспорта, TSV из буфера обмена или строки с точкой с запятой.
Сегодня в Calcup появился конвертер CSV в Markdown-таблицу. Он разбирает табличный текст, учитывает кавычки и выбранный разделитель, а на выходе даёт готовую pipe table.
Кавычки и pipe-символы считаются отдельно
Главная ошибка ручной конвертации - просто заменить запятые на вертикальные черты. Это ломается на ячейках вроде "roadmap, metrics", где запятая является частью значения, а не границей столбца.
Новый инструмент проходит по строке как CSV-парсер: кавычки удерживают запятые внутри ячейки, двойные кавычки превращаются в один символ, а вертикальная черта внутри текста экранируется, чтобы Markdown не создал лишний столбец.
TSV тоже закрыт
Если скопировать диапазон из таблицы, часто получается TSV: между ячейками стоит tab, а не запятая. Для этого в форме есть отдельный режим разделителя.
Если первая строка не является заголовком, конвертер создаёт Column 1, Column 2 и оставляет все строки как данные. Так можно быстро оформить маленькую выборку без подготовки исходного файла.
Границы расчёта
Инструмент рассчитан на небольшие таблицы для документации. Он не сохраняет стили, формулы, объединённые ячейки, типы данных, фильтры и сортировки.
Для больших экспортов лучше оставить данные в spreadsheet или обработать скриптом, а в Markdown вставлять только компактный итоговый фрагмент.