Справочник
Таблицы в Markdown: синтаксис, выравнивание, ошибки
Минимальная конструкция, выравнивание столбцов, разметка внутри ячеек и шесть частых ошибок. Слева — окно режима «Код», справа — тот же документ в визуальном редакторе: типографика один в один как в приложении.
Как сделать таблицу в Markdown с нормализацией
Таблицы в маркдауне — расширение GitHub Flavored Markdown: его понимают GitHub, генераторы сайтов и ProsaMD. Чтобы вставить или создать таблицу, достаточно трёх строк: заголовки, разделитель с дефисами, данные. Ячейки в строке разделены вертикальными чертами.
| Режим | Что делает |
| --- | --- |
| Код | правите разметку |
| Просмотр | читаете документ || Режим | Что делает |
|---|---|
| Код | правите разметку |
| Просмотр | читаете документ |
Строка с дефисами обязательна — именно она превращает строки с чертами в таблицу. Про остальную разметку — в разделе Markdown на сайте.
Выравнивание столбцов: влево, по центру, вправо
Двоеточия в строке с дефисами задают выравнивание колонки: :--- — влево, :---: — по центру, ---: — вправо. Таблица без двоеточий оставляет все колонки прижатыми влево.
| Столбец | Как записать | Куда прижмётся |
|:--------|:------------:|---------------:|
| Левый | `:---` | к левому краю |
| Центр | `:---:` | к центру |
| Правый | `---:` | к правому краю || Столбец | Как записать | Куда прижмётся |
|---|---|---|
| Левый | :--- | к левому краю |
| Центр | :---: | к центру |
| Правый | ---: | к правому краю |
Разметка внутри ячеек
Ячейка — обычный текст Markdown: работают жирный, курсив, строчный код и ссылки. Подробнее про строчный и блочный код в Markdown — в соседней статье.
| Файл | Что это |
| --- | --- |
| **README.md** | описание проекта |
| *черновик* | `todo.md` |
| [Сайт](https://prosamd.ru) | главная || Файл | Что это |
|---|---|
| README.md | описание проекта |
| черновик | todo.md |
| Сайт | главная |
Частые ошибки
Почти все проблемы с таблицами сводятся к шести ситуациям.
Нет строки с дефисами
| Режим | Действие |
| Редактор | правка разметки |Не таблица. Если разделителя нет или в нём нет дефисов — перед вами обычный абзац: ProsaMD покажет вертикальные черты текстом.
Двоеточие с одной стороны
| Пункт | Цена |
| :- | -: |Выравнивание не сработает: двоеточие с одной стороны ProsaMD не считает командой выравнивания (с версии 0.1.10) — колонки останутся прижатыми влево. Ставьте двоеточия с двух сторон: :---, :---:, ---:.
Число ячеек различается
| Имя | Роль |
| --- | --- |
| Аня | редактор |
| Борис || Имя | Роль |
|---|---|
| Аня | редактор |
| Борис |
Таблица сработает, но честно: недостающие ячейки дорисуются пустыми, лишние — пропадут. Так ведёт себя и GFM, и ProsaMD.
Пробелы вокруг черт
|Режим|Что делает|
|---|---|
|Код|правите разметку|Это тоже таблица: пробелы вокруг вертикальных черт не обязательны. При сохранении из визуального редактора ProsaMD выровняет колонки пробелами сам — таблица станет читаемее, содержимое не изменится.
Объединение ячеек
Разметка GFM не умеет объединять ячейки: команд вроде colspan в таблице маркдауна нет. Если шапке нужны объединённые столбцы, соберите таблицу в генераторе markdown-таблиц и вставьте готовую разметку, либо напишите HTML-таблицу в режиме «Код» — ProsaMD сохранит её дословно.
Перенос строки внутри ячейки
Разрывать ячейку обычным переносом строки нельзя — строка таблицы сломается. Для переноса внутри ячейки используйте тег <br>: | Пункт<br>со скидкой | — ProsaMD покажет перенос, а при сохранении запишет тег дословно.
Что ProsaMD делает с таблицей при сохранении с нормализацией
Режим «Код» сохраняет файл побайтово — как написали, так и лежит. Визуальный редактор при сохранении выравнивает ширину колонок пробелами: меняются только пробелы, содержимое ячеек то же.
|Режим|Действие|
|---|---|
|Код|правка разметки|| Режим | Действие |
| ----- | --------------- |
| Код | правка разметки |
Таблица та же, меняются только пробелы с нормализацией
Пометки и поведение описывают ProsaMD 0.2.0. Нормализация затрагивает только пробелы и только при сохранении из визуального редактора. Про остальную разметку — шпаргалка по синтаксису.
Открыть пример в ProsaMD
Бесплатно и открыто · установщик около 4 МБ · Windows 10/11