Многострочные таблицы

Таблицы с поддержкой внутри ячеек не только простого контента, такого как строчное форматирование, ссылки и т.п., но и сложного, например, списков, блоков кода и даже других таблиц.

Многострочные таблицы поддерживают объединение ячеек.

Синтаксис

• таблица начинается #| и заканчивается |#;
• строки начинаются и заканчиваются ||;
• ячейки отделяются символом |.

#|
|| **Заголовок1** | **Заголовок2** ||
|| Текст | Текст ||
|#

Результат:

Многострочный текст

В ячейке таблицы можно размещать любой многострочный текст. Например, списки.

#|
||Текст
на двух строчках
|
- Текст 1
- Текст 2[cell_merging_guide.md](..%2F..%2F..%2F..%2F..%2FDocuments%2Fcell_merging_guide.md)
- Текст 3
- Текст 4||
|#

Результат:

Или даже другую таблицу:

#|
|| 1
|

Текст выше вложенной таблицы

#|
|| 5
| 6||
|| 7
| 8||
|#

Текст под вложенной таблицей||
|| 3
| 4||
|#

Результат

Объединение ячеек

Ячейки можно объединять вертикально с помощью ячейки с символом "^":

#|
|| Заголовок1         | Заголовок2   ||
|| Текст на два ряда  | Другой текст ||
|| ^                  | Еще текст    ||
|#

Результат

Горизонтальное объединение поддерживается через символ ">":

#|
|| Заголовок1            | Заголовок2   ||
|| Текст на две колонки  | >            ||
|| Другой текст          | Еще текст    ||
|#

Результат

Символы объединения ячеек можно использовать вместе:

#|
|| Заголовок1                       | Заголовок2   | Заголовок3 || 
|| Текст на две колонки и два ряда  | >            | Текст      ||
|| ^                                | >            | Еще текст  ||
|#

Результат

Выравнивание текста в ячейках

Для контроля за выравниванием ячеек можно использовать синтаксис атрибутов внутри ячеек:

#|
|| Заголовок1                                           | Заголовок2   | Заголовок3 || 
|| Текст на две колонки и два ряда {.cell-align-center} | >            | Текст      ||
|| ^                                                    | >            | Еще текст  ||
|#

Результат

Доступны следующие опции для выравнивания:

• cell-align-top-left
• cell-align-top-center
• cell-align-top-right
• cell-align-center
• cell-align-bottom-left
• cell-align-bottom-center
• cell-align-bottom-right

Экранирование символов объединения ячеек

Для того чтобы получить клетку с одним из символов объединения ячеек, внутри можно использовать экранирование через "",
т.е. "^" и ">".

#|
|| Заголовок1                       | Заголовок2 | Заголовок3 || 
|| Текст на одну ячейку             | \>         | Текст      ||
|| \^                               | \>         | Еще текст  ||
|#

Результат

Открытие широких таблиц в модальном окне

Широкие таблицы удобно открывать в модальном окне. В многострочных таблицах это реализуется с помощью атрибута {wide-content}. Атрибут добавляется сразу после символов, закрывающих таблицу |#.

#|
|| **Заголовок1** | **Заголовок2** ||
|| Текст | Текст ||
|| Текст | Текст ||
|| Текст | Текст ||
|# {wide-content}

Результат