CSV в таблицу Markdown

Как это работает

Таблицы Markdown утомительно писать вручную, и они не прощают ошибок выравнивания. Если данные уже есть в виде CSV, преобразование происходит мгновенно и избавляет от неверно посчитанного символа вертикальной черты, из-за которого ломается вся таблица.

Кавычки обрабатываются

Анализатор понимает поля в кавычках, поэтому запятые и переносы строк внутри ячейки сохраняются. Символы вертикальной черты в данных экранируются, поскольку неэкранированная черта преждевременно завершила бы ячейку.

Строка заголовка

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

Как читается CSV

Поля разделяются запятыми. Поле в двойных кавычках может содержать запятые и переносы строк, а удвоенная кавычка ("") внутри него обозначает одну кавычку. Окончания строк Windows и Unix работают одинаково, пустые строки пропускаются.

Как выглядит таблица

Первая строка становится строкой заголовка, за ней идёт разделитель ---, необходимый Markdown. Каждая следующая строка дополняется или обрезается до числа столбцов заголовка, а любой символ | внутри ячейки экранируется как \|, чтобы не сломать таблицу.