Учебник VuePress

# Синтаксис таблицы в Markdown

VuePress использует разметку таблицы в стиле GitHub.

# Упрощенный синтаксис таблицы

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

  • Как минимум один заголовок, состоящий из строки, окруженной символами канала: | Заголовок |
  • Строка тире, окруженная символами трубы: | ------ |
  • Ноль или более строк текста, окруженных символами канала, например: | Ряд 1 |

Давайте сложим все это вместе.

# Простой пример таблицы

Чтобы получить таблицу, которая выглядит следующим образом:

Результат:

Заголовок
Строка 1, столбец 1 Строка 1, столбец 2

Вы бы использовали следующую разметку:

Markdown:

| Заголовок | |
| --------------------- | -------------------------- |
| Строка 1, столбец 1 | Строка 1, столбец 2 |
1
2
3

# Минимальная таблица: только заголовок

Таблица абсолютного минимума будет состоять из одного заголовка без строк:

Markdown:

| Заголовок |
| --------------------- |
1
2

Результат:

Заголовок

# Таблица с одним заголовком и одной строкой:

Давайте расширим предыдущий пример одной строкой:

Markdown:

| Заголовок |
| --------------------- |
| Одиночная клетка |
1
2
3

Результат:

Заголовок
Одиночная клетка

# Типичная таблица с несколькими строками

Большинство таблиц имеют несколько столбцов и строк, например:

Колонка 1 Колонка 2
Строка 1, столбец 1 Строка 1, столбец 2
Строка 2, столбец 1 Строка 2, столбец 2
Строка 3, столбец 1 Строка 3, Столбец 2
Строка 4, столбец 1 Строка 4, Столбец 2

Markdown:

    | Колонка 1 | Колонка 2 |
    | --------------- | ---------------- |
    | Строка 1, столбец 1 | Строка 1, столбец 2 |
    | Строка 2, столбец 1 | Строка 2, столбец 2 |
    | Строка 3, столбец 1 | Ряд 3, Столбец 2 |
    | Строка 4, столбец 1 | Ряд 4, Столбец 2 |
1
2
3
4
5
6

# Тире и пробел не имеют значения

Количество черточек, используемых для указания заголовка, и количество пробелов, окружающих символы трубы не имеют значения. Возьмите следующую таблицу:

Колонка 1 Колонка 2
строка 1 2-й столбец
строка 2 2-й столбец

Вы могли бы использовать эту разметку для этого:

    | Колонка 1 | Колонка 2 |
    | --------- | --- |
    | строка 1 | 2-й столбец |
    | строка 2 | 2-й столбец |
1
2
3
4

Или вы можете использовать эту разметку:

    | Колонка 1 | Колонка 2 |
    | ------------ | ---------------- |
    | строка 1 | 2-й столбец |
    | строка 2 | 2-й столбец |
1
2
3
4

И они оба будут производить один и тот же результат.

# Выравнивание текста внутри столбцов

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

  • Чтобы выровнять столбец по левому краю, замените крайнюю левую черту двоеточием
  • Чтобы выровнять столбец вправо, замените крайнюю правую черту двоеточием
  • Чтобы выровнять столбец по центру, крайний левый и правый штрихи с двоеточием

Вот таблица, показывающая выравнивание:

Выравнивание Колонка 2 Колонка 3
Выровнять по центру столбец 2 *
Выровнять столбец 3 по правому краю Бу
Выровнять цифры по правому краю 1
123
456,67 $

Markdown:

    | Выравнивание | Колонка 2 | Колонка 3 |
    | --------------------- |: --------------: | -------------: |
    | Выровнять по центру столбец 2 | * | |
    | Выровнять столбец 3 по правому краю | | Бу |
    | Выровняйте цифры по правому краю: | | 1 |
    | | | 123 |
    | | | 456,67 $ |
1
2
3
4
5
6
7

← Эмодзи в markdown →