Почему конвертер ломает таблицы в Markdown

Конвертер ломает Markdown-таблицу, когда исходник не прямоугольник: объединённые ячейки, перенос внутри ячейки, пустые столбцы справа и лист на десятки колонок. В Markdown таблица это текст: столбцы через вертикальную черту, под заголовком строка из дефисов. Объединения ячеек как в Excel там нет. Перенос внутри ячейки рвёт строку и сдвигает столбцы в превью GitHub. Широкий лист превращается в кашу на узком экране README. Сначала упростите сетку в книге, затем прогоните файл через XLSX → Markdown. Ниже: синтаксис, типичные поломки, ручная вставка, подготовка листа, шаги на Тулси и проверка. Как положить таблицу в документацию репозитория, читайте как оформить README. Путь «книга Excel → Markdown» целиком разобран в Excel в Markdown.

Почему Markdown-таблица ломается

Markdown ждёт ровную сетку. Каждая строка содержит одно и то же число вертикальных черт. Первая строка заголовки, вторая разделитель из дефисов, дальше данные. Конвертер, который «рисует» таблицу как в Excel, спотыкается, когда ячейки живут по другим правилам: одна шапка на три столбца, абзац внутри ячейки, скрытый столбец справа.

Люди ищут «markdown таблица», когда превью в GitHub, GitLab или заметках показывает кривую сетку: столбец уехал, заголовок слипся с данными, последняя колонка пропала. Часто исходник нормальный для бухгалтерии и ужасный для текстовой разметки. Excel прощает объединение и переносы. Markdown нет.

Типичный сбой: выгрузка прайса с шапкой «Тариф / условия» через три объединённые ячейки. Конвертер ставит текст в первую ячейку, остальные оставляет пустыми или дублирует. В .md число | по строкам расходится, превью «ломает» таблицу. Второй сбой: комментарий менеджера с Enter внутри ячейки. Третий: лист на 30 колонок, который в README никто не читает в одну строку.

Перед следующей конвертацией спросите себя, нужна ли эта сетка в тексте документации. Если да, вырежьте прямоугольник из 4-8 столбцов. Если нужен расчёт и фильтры, оставьте книгу Excel и в README дайте ссылку на файл. Инструмент на Тулси не чинит смысл листа: он переводит то, что вы загрузили.

Смешение форматов тоже даёт мусор. Кто-то копирует таблицу из Word с невидимыми символами, кто-то вставляет HTML <table> в .md и ждёт, что GitHub это поймёт. Для репозитория держите pipe-таблицу. HTML из уже готового Markdown собирайте отдельно на Markdown → HTML.

Синтаксис таблиц в Markdown

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

Выравнивание задают двоеточия в строке-разделителе: :--- влево, :---: по центру, ---: вправо. Это косметика. Сначала почините число столбцов, потом играйтесь с выравниванием. В README репозитория выравнивание чисел вправо иногда помогает читать суммы. Для коротких меток тарифов хватает выравнивания по умолчанию.

GitHub, GitLab и многие редакторы заметок понимают этот диалект. Расширения вроде объединения ячеек, многострочных ячеек и цветных заливок в «обычном» Markdown репозитория нет. То, что работает в одном вики-движке, на GitHub снова разъедется. Пишите под самый простой диалект, если файл уйдёт в публичный репозиторий.

Как сделать таблицу в Markdown руками

Откройте любой текстовый редактор. Наберите заголовки через |, нажмите Enter, поставьте строку дефисов, снова Enter, затем строки данных. Сохраните файл как .md. Откройте превью: в VS Code, в веб-интерфейсе GitHub или через чем открыть MD-файл.

Для двух-трёх строк руками быстрее, чем гонять Excel. Для прайса на 40 позиций руки ошибутся в |. Тогда готовьте прямоугольный лист и грузите его в XLSX → Markdown. Скопированный из чата «почти Markdown» часто содержит нестандартные длинные тире вместо дефисов в разделителе: замените их на обычный -.

Куда вставить таблицу в файл

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

В заметках кладите .md рядом с исходным .xlsx и в шапке пишите имя книги. Через месяц иначе не отличите черновик от выгрузки «как в проде». Если таблица пойдёт на сайт, сначала поправьте Markdown, потом конвертируйте в HTML. Не вставляйте сырой Excel в HTML-конвертер.

Что ломает сетку в исходнике

Три вещи дают почти все поломки после конвертера: объединение ячеек, перевод строки внутри ячейки, ширина листа. Макросы, диаграммы и сводные рядом, но они чаще просто пропадают, а не «ломают» |. Ниже разбор тех трёх, которые портят именно Markdown-таблицу.

Объединённые ячейки в Excel это одна подпись на несколько столбцов или строк. В pipe-таблице каждой колонке нужна своя ячейка в каждой строке. Конвертер либо кладёт текст влево и оставляет дыры, либо повторяет подпись. Превью GitHub дыры читает как пустые столбцы и сдвигает хвост строки. Разбейте объединение в Excel до загрузки: «Главная → Объединить и поместить в центре» снимите, подписи разнесите по колонкам.

Перенос строки внутри ячейки в Excel выглядит аккуратно: Alt+Enter, два абзаца в одной клетке. В Markdown перевод строки заканчивает строку таблицы. Вторая половина текста становится «голой» строкой без | или новой строкой с другим числом столбцов. Перед экспортом замените внутренние переносы на точку с запятой или на пробел. Длинный комментарий вынесите в отдельный столбец «примечание» без Enter внутри.

Широкий лист на 20+ колонок технически конвертируется. Читать его в README нельзя: горизонтальный скролл, обрезка на телефоне, дифф в Git превращается в шум. Для документации оставьте ключевые столбцы. Остальное держите в книге или в CSV рядом с репозиторием.

Объединение ячеек: чего ждать от Markdown

В классической Markdown-таблице нет colspan и rowspan. Запрос «markdown объединение ячеек в таблице» закрывается так: в стандартном README это не поддерживается. Если без шапки на несколько колонок нельзя, сделайте две таблицы подряд или вынесите общую подпись обычным абзацем над сеткой.

Не надейтесь, что конвертер «догадается» и соберёт HTML-таблицу с объединением внутри .md. GitHub такой фрагмент часто показывает как код или ломает вёрстку. Для документации репозитория прямоугольник без объединений надёжнее красивой шапки из Excel.

Перенос строки в ячейке и широкие листы

Проверьте ячейки с комментариями, адресами и «условиями тарифа». Если в строке статуса Excel видно две визуальные строки внутри одной клетки, перед выгрузкой схлопните их. После конвертации ищите в .md строки, которые не начинаются с |: это следы переноса.

Для ширины ориентир: если таблица не помещается в окно редактора без горизонтальной прокрутки, в README она тоже не поместится. Разрежьте на две таблицы по смыслу: «цены» и «лимиты». Один холст на всю книгу в README не читают.

Как подготовить лист и прогнать его на Тулси

Откройте книгу. Оставьте один лист с нужным диапазоном. Удалите пустые столбцы справа и пустые строки снизу: конвертер иначе тащит «пустоту» как колонки. Снимите фильтр, покажите скрытые строки, которые должны попасть в документацию. Сохраните .xlsx, снимите пароль, уложитесь в ориентир до 5 МБ.

Имя файла пишите по смыслу: tarify-readme-2026-08.xlsx. После конвертации так проще не перепутать .md. Картинки и фигуры на листе для Markdown бесполезны: уберите их, чтобы не раздувать файл. Полный маршрут «книга → README» без акцента на поломках сетки лежит в Excel в Markdown. Здесь цель другая: довести лист до прямоугольника, который pipe-таблица переживёт.

Если исходник не Excel, а PDF, Word или пачка форматов, откройте конвертер в Markdown. Узкая страница этой статьи заточена под книгу с сеткой ячеек. CSV с кривой кодировкой сначала поправьте, иначе кириллица в заголовках таблицы приедет кракозябрами.

Шаги на странице XLSX → Markdown

Откройте XLSX → Markdown в браузере. Перетащите .xlsx или .xls в зону загрузки. Запустите конвертацию и дождитесь текста.

Посмотрите первые три строки результата: заголовки, разделитель, первая строка данных. Сохраните .md или скопируйте фрагмент. Лимит бесплатного режима: до 3 файлов в день, до 5 МБ на файл. Не гоняйте один и тот же кривой лист десять раз: сначала разбейте объединение и уберите Enter в ячейках, потом один чистый прогон.

Что сделать с текстом после конвертации

Вставьте таблицу в README или в заметки. Откройте превью тем же способом, каким файл будут читать коллеги: веб GitHub или локальный просмотрщик, см. чем открыть MD-файл. Если дальше нужен HTML для сайта, поправьте Markdown и откройте Markdown → HTML.

В коммите или в шапке файла укажите дату выгрузки. Иначе через месяц в репозитории окажутся три таблицы с разными ценами. Исходный Excel обновляйте вместе с .md: править только Markdown и завтра снова выгрузить устаревшую книгу значит вернуть поломку.

Как проверить результат

Откройте .md рядом с Excel. Сверьте три зоны: строку заголовков, середину с «сложными» ячейками и последнюю строку с итогами. Так быстрее ловите сдвиг столбца, чем читая всё подряд.

Посчитайте вертикальные черты в трёх строках. Число должно совпасть. Пустая ячейка допустима: | | между разделителями. Лишний | в середине текста ячейки (если в цифре или в названии тарифа затесалась черта) рвёт колонку. Экранируйте или замените символ в исходнике.

Типичные ошибки после «успешной» конвертации: шапка из объединённых ячеек стала пустыми колонками; комментарий с Enter разорвал строку; широкий лист обрезался глазами, хотя в файле все колонки на месте; в разделителе оказались длинные тире из копипаста. Ещё ловушка: править превью глазами и забыть, что GitHub показывает не то же, что локальный редактор с другим диалектом Markdown.

Если результат пустой, вернитесь к исходнику: пароль, повреждённый файл, лист без текстовых ячеек. Если таблица есть, но столбцы съехали, упростите диапазон в Excel и сделайте новый прогон. Бесконечная ручная правка | без сверки с книгой снова разъедется при следующей выгрузке.

Смежные задачи на Тулси

Лист Excel гоните через XLSX → Markdown. Пачку PDF, Word и таблиц удобнее через конвертер в Markdown. Готовый .md в HTML: Markdown → HTML.

Рядом по смыслу: зачем вообще вытаскивать книгу в текст, Excel в Markdown; как встроить таблицу в документацию репозитория, как оформить README; чем смотреть .md без танцев с установкой, чем открыть MD-файл. Общий контекст формата: что такое MarkItDown.

Не грузите .xlsx на страницу «Markdown → HTML» и не ждите объединения ячеек от pipe-таблицы. Сначала прямоугольник в книге, потом текст, потом при необходимости HTML.

Частые вопросы

Markdown таблица: из чего она состоит?

Это текст: столбцы разделяет символ |, под заголовком идёт строка из дефисов. Файл правится в любом редакторе и уходит в Git рядом с кодом. Превью GitHub и большинство редакторов заметок показывают такую сетку как таблицу, если число | в строках совпадает.

Как сделать таблицу в Markdown?

Для короткой сетки наберите | руками: заголовки, строка ---, данные. Для прайса или выгрузки из учёта подготовьте прямоугольный лист Excel и откройте XLSX → Markdown. После вставки откройте превью тем же способом, каким файл будут читать другие, иначе вы правите «красиво у себя» и ломаете сетку в репозитории.

Как выглядит таблица в формате Markdown?

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

Как в Markdown вставить таблицу?

Скопируйте готовый фрагмент pipe-таблицы в .md под нужным заголовком раздела. Не вставляйте бинарный Excel и не рассчитывайте, что GitHub поймёт таблицу из Word с невидимой разметкой. Если фрагмента ещё нет, соберите его на XLSX → Markdown и вставьте результат целиком, включая строку-разделитель.

Как сделать перенос строки в таблице Markdown?

В обычной pipe-таблице GitHub перевод строки внутри ячейки рвёт сетку. Замените внутренний Enter на точку с запятой, на <br> только если ваш движок это явно умеет, либо вынесите длинный текст в абзац под таблицей. Перед конвертацией из Excel уберите Alt+Enter из ячеек, иначе конвертер отдаст сломанные строки.

Какой синтаксис таблиц в Markdown?

Базовый диалект: |, строка дефисов, опционально двоеточия для выравнивания. Расширения с объединением ячеек, цветом и многострочными ячейками зависят от конкретной вики и в README GitHub часто отсутствуют. Пишите под простой диалект, если файл уйдёт в публичный репозиторий и его будут смотреть разные инструменты.

Где сделать таблицы Markdown онлайн?

На Тулси лист Excel переводится на странице XLSX → Markdown в браузере, без установки офиса на эту машину. Для смешанных исходников откройте конвертер в Markdown. После получения текста всё равно откройте превью: генерация «на сайте» не отменяет проверку числа столбцов.

Как создать таблицу Markdown из листа Excel?

Оставьте на листе один прямоугольник без объединения и без Enter в ячейках. Загрузите .xlsx на XLSX → Markdown, сохраните .md. Сверьте заголовки и пару чисел с книгой, затем вставьте таблицу в README или заметки.

Что значит разметка таблицы в Markdown?

Это те же | и дефисы, без скрытого бинарного формата. Разметка видна в исходнике файла, поэтому дифф в Git показывает, какая ячейка изменилась. Если разметка съехала, чините исходную сетку в Excel и повторите выгрузку, а не маскируйте сдвиг пробелами в одной строке.

Можно ли объединение ячеек в таблице Markdown?

В стандартной таблице README объединения нет: каждой колонке нужна ячейка в каждой строке. Общую подпись поставьте обычным текстом над таблицей или разбейте шапку на отдельные столбцы в Excel до конвертации. HTML с colspan внутри .md GitHub часто показывает плохо; для репозитория надёжнее прямоугольник.

Рядом по теме: Excel в Markdown, как оформить README, чем открыть MD-файл. Рабочие точки входа: XLSX → Markdown, конвертер в Markdown, Markdown → HTML.