Справочник

Таблицы в Markdown: синтаксис, выравнивание, ошибки

Минимальная конструкция, выравнивание столбцов, разметка внутри ячеек и шесть частых ошибок. Слева — окно режима «Код», справа — тот же документ в визуальном редакторе: типографика один в один как в приложении.

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

Таблицы в маркдауне — расширение GitHub Flavored Markdown: его понимают GitHub, генераторы сайтов и ProsaMD. Чтобы вставить или создать таблицу, достаточно трёх строк: заголовки, разделитель с дефисами, данные. Ячейки в строке разделены вертикальными чертами.

Код
| Режим | Что делает |
| --- | --- |
| Код | правите разметку |
| Просмотр | читаете документ |
Визуальный редактор
РежимЧто делает
Кодправите разметку
Просмотрчитаете документ

Строка с дефисами обязательна — именно она превращает строки с чертами в таблицу. Про остальную разметку — в разделе Markdown на сайте.

Выравнивание столбцов: влево, по центру, вправо

Двоеточия в строке с дефисами задают выравнивание колонки: :--- — влево, :---: — по центру, ---: — вправо. Таблица без двоеточий оставляет все колонки прижатыми влево.

Код
| Столбец | Как записать | Куда прижмётся |
|:--------|:------------:|---------------:|
| Левый   | `:---`       | к левому краю  |
| Центр   | `:---:`      | к центру       |
| Правый  | `---:`       | к правому краю |
Визуальный редактор
СтолбецКак записатьКуда прижмётся
Левый:---к левому краю
Центр:---:к центру
Правый---:к правому краю
Таблица Markdown в ProsaMD: три колонки с выравниванием влево, по центру и вправо
Та же таблица в ProsaMD — режим «Просмотр». Кадр из программы.

Разметка внутри ячеек

Ячейка — обычный текст 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

Скачать ProsaMD