Генератор таблиц Markdown

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

Базовая таблица:

| Столбец A | Столбец B | Столбец C |
|-----------|-----------|-----------|
| ячейка 1  | ячейка 2  | ячейка 3  |
| ячейка 4  | ячейка 5  | ячейка 6  |

Выравнивание задаётся двоеточиями в строке-разделителе:

| Слева | По центру | Справа |
|:------|:---------:|-------:|
| a     | b         | c      |

• :--- выравнивание по левому краю
• :---: по центру
• ---: выравнивание по правому краю

Что генератор делает за вас

• Дополняет каждую ячейку до ширины самого длинного элемента в её столбце, чтобы вертикальные черты выравнивались в исходнике. На отображаемый результат это не влияет, Markdown игнорирует лишние пробелы, но тот, кто читает diff, скажет вам спасибо.
• Экранирует вертикальные черты внутри ячеек как \|, чтобы ячейка, содержащая a|b, не разбивалась на два столбца.
• Сохраняет выравнивание при изменении ширины столбцов.
• Принимает вставку CSV и TSV; распознаёт поля в кавычках и запятые внутри кавычек.

Распространённые ошибки

• Строка-разделитель обязательна. Таблицы Markdown без строки |---|---| отображаются как обычный текст.
• Нет многострочных ячеек. Каждая строка, это одна строка текста; вставьте <br>, если нужен внутренний перенос, поскольку переносы строк Markdown внутри ячеек таблицы не поддерживаются.
• Нет вложенных таблиц. Если они нужны, используйте HTML.
• Пустые ячейки требуют пробела (или хотя бы пустой пары вертикальных черт). Избегайте || напрямую.

Когда лучше использовать HTML

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

Где таблицы Markdown работают хорошо

• README на GitHub, GitLab, Gitea.
• Описания задач и пул-реквестов (PR).
• Obsidian, Bear и большинство приложений для заметок.
• Docusaurus, MkDocs, Hugo, все поддерживают таблицы GFM.