Skip to main content

Организация информации с помощью таблиц

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

Кто может использовать эту функцию?

Markdown можно использовать в веб-интерфейсе GitHub .

Создание таблицы

Вы можете создавать таблицы с вертикальной чертой | и дефисами -. Дефисы используются, чтобы создать для каждого столбца заголовок. Вертикальные черты разделяют столбцы. Необходимо включить пустую строку перед таблицей, чтобы она правильно преобразовалась для просмотра.


| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

Снимок экрана: таблица Markdown с двумя столбцами равной ширины, отображаемыми на GitHub. Заголовки отображаются в полужирном шрифте и альтернативные строки содержимого имеют серую заливку.

Вертикальные черты на обоих концах таблицы не являются обязательными.

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

| Command | Description |
| --- | --- |
| git status | List all new or modified files |
| git diff | Show file differences that haven't been staged |

Снимок экрана: таблица Markdown с двумя столбцами разной ширины, отображаемыми на GitHub. Строки перечисляют команды "состояние git" и "git diff" и их описания.

Если вы часто редактируете фрагменты кода и таблицы, может быть удобно включить моноширинный шрифт во всех полях комментариев в GitHub. Дополнительные сведения см. в разделе Сведения о написании и форматировании текста на GitHub.

Форматирование содержимого в таблице

В таблице можно использовать форматирование, например ссылки, встроенные блоки кода и оформление текста:

| Command | Description |
| --- | --- |
| `git status` | List all *new or modified* files |
| `git diff` | Show file differences that **haven't been** staged |

Снимок экрана: таблица Markdown с двумя столбцами разной ширины, отображаемыми на GitHub. Команды "Состояние Git" и "Git diff" форматируются как блоки кода.

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

| Left-aligned | Center-aligned | Right-aligned |
| :---         |     :---:      |          ---: |
| git status   | git status     | git status    |
| git diff     | git diff       | git diff      |

Снимок экрана: таблица Markdown с тремя столбцами, отображаемыми на GitHub, показывающая, как текст в ячейках можно выровнять по левому краю, центру или правому краю.

Чтобы включить вертикальную черту | ​​в качестве содержимого в вашу ячейку, используйте \ перед вертикальной чертой:

| Name     | Character |
| ---      | ---       |
| Backtick | `         |
| Pipe     | \|        |

Снимок экрана: таблица Markdown, отображаемая на GitHub, показывающая, как каналы, которые обычно закрывают ячейки, могут отображаться внутри ячеек при появлении обратной косой черты.

Дополнительные материалы