---
metadata:
  - name: generator
    content: Diplodoc Platform v5.62.0
style:
  - _assets/styles/custom.css
  - _assets/fonts-golos-text.css
  - _assets/styles/hero-gradient.css
  - _assets/styles/hero-decoration.css
script:
  - _assets/scripts/latex-trust.js
description: Руководство пользователя (новая версия) - Таблицы
title: Таблицы
vcsPath: sintaksis-shablonov/tablitsy-i-izobrazheniia/tablitsy.md
alternate:
  - href: sintaksis-shablonov/tablitsy-i-izobrazheniia/tablitsy.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    rel: describedby
theme: _assets/style/theme.css
---

# Таблицы

## Базовая структура
Таблица начинается со строки-разделителя «|---|», а столбцы разделяются знаком «|»: сколько промежутков между знаками «|», столько и столбцов. Таблица заканчивается на первой строке без «|».
```jinja
|---|---|
|Беларусь|Минск|
|Франция|Париж|
|Италия|Рим|
```
**Результат:**
![](_assets/content-images/f8038f1e0d852899.png)

## Заголовки
Чтобы добавить заголовки столбцов, поставьте строку таблицы над строкой-разделителем.
```jinja
|Страна|Столица|
|---|---|
|Беларусь|Минск|
|Франция|Париж|
|Италия|Рим|
```
**Результат:**
![](_assets/content-images/042625c6b1814a84.png)

## Объединение ячеек
Чтобы объединить ячейки в строке, оставьте следующую ячейку пустой.
```jinja
|Страна|Столица|
|---|---|
|Европа||
|Беларусь|Минск|
|Франция|Париж|
|Италия|Рим|
|Азия||
|Индия|Нью-Дели|
|Таиланд|Бангкок|
```
**Результат:**
![](_assets/content-images/4bad9c50253836ad.png)

Чтобы объединить ячейки в столбце, введите «^^» в нижней ячейке.
```jinja
|Континент|Страна|Столица|
|---|---|---|
|Европа|Беларусь|Минск|
|^^|Франция|Париж|
|^^|Италия|Рим|
|Азия|Индия|Нью-Дели|
|^^|Таиланд|Бангкок|
```
**Результат:**
![](_assets/content-images/c6c771a31d3ba705.png)

## Выравнивание текста — по столбцу
Задается прямо в строке-разделителе. Двоеточие указывает на сторону, к которой прижимается содержимое всех ячеек этого столбца:

| Маркер в разделителе | Эффект |
|---|---|
| `:---`               | По левому краю                                  |
| `---:`               | По правому краю                                 |
| `:---:`              | По центру                                       |
| `---`                | По умолчанию (в теле — по левому краю, в заголовке — по центру)  |

```jinja
|Слева|По центру|Справа|По умолчанию|
|:---|:---:|---:|---|
|a|b|c|d|
|e|f|g|h|
```
**Результат:**
![](_assets/content-images/6638868805da8a97.png)

## Выравнивание текста — по отдельной ячейке
Иногда одну ячейку (или строку) нужно выровнять иначе, чем весь столбец. Для этого внутри ячейки ставят двоеточие, **примыкающее к краю** ячейки. Выравнивание ячейки **перекрывает** выравнивание столбца. Пробел между двоеточием и текстом не важен:

- `: текст` или `:текст` (двоеточие в начале ячейки) — по левому краю
- `текст :` или `текст:` (двоеточие в конце ячейки) — по правому краю
- `: текст :` или `:текст:` (двоеточия с обеих сторон) — по центру
- обычный текст без двоеточий по краям — берется выравнивание столбца


{% note info "Что считается маркером" %}

Маркером считается **только то двоеточие, которое стоит прямо у края ячейки** (после убирания пробелов вокруг). Двоеточие в середине ячейки маркером не считается: `Note: ok`, `Время: 12:00`, `Файл: a.csv` остаются обычным текстом.

{% endnote %}



{% note alert "Внимание" %}

Одиночная ячейка вида `| Note: |` или `| Статус: |` будет интерпретирована как выравнивание по правому краю: двоеточие стоит у правой границы. Если это просто текст-заголовок, добавьте содержимое после двоеточия (`| Note: важно |`) или уберите двоеточие.

{% endnote %}


```jinja
|Слева по столбцу|По центру по столбцу|Справа по столбцу|
|:---|:---:|---:|
|обычная|обычная|обычная|
|:все влево|:все влево|:все влево|
|все вправо:|все вправо:|все вправо:|
|:все по центру:|:все по центру:|:все по центру:|
|Note: ok|Время: 12:00|Файл: a.csv|
```
**Результат:**
![](_assets/content-images/ae3982c59f8c21b5.png)

В последней строке двоеточия стоят в середине ячейки (`:` не примыкает к границе), поэтому каждая ячейка наследует выравнивание своего столбца.