Skip to main content

Эта версия GitHub Enterprise Server была прекращена 2024-07-09. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Базовый синтаксис записи и форматирования

Создавайте расширенное форматирование текста и кода в GitHub с помощью простого синтаксиса.

Заголовки

Чтобы создать заголовок, добавьте от одного до шести символов # перед его текстом. Количество используемых # элементов определяет уровень иерархии и размер шрифта заголовка.

# A first-level heading
## A second-level heading
### A third-level heading

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

При использовании двух или более заголовков GitHub автоматически создает оглавление, которое можно получить, щелкнув в заголовке файла. В оглавлении приводится каждый заголовок. Щелкнув по нему, можно перейти к соответствующему разделу.

Снимок экрана: файл README в репозитории документов GitHub открытый код с раскрывающимся меню для оглавлений, предоставляемых. Значок оглавление выделен темным оранжевым цветом.

Текст стилей

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

СтильСинтаксисСочетания клавишПримерВыходные данные
Жирный** ** или __ __COMMAND+B (Mac) или CTRL+B (Windows и Linux)**This is bold text**Это полужирный текст
Italic* * или _ _     COMMAND+I (Mac) или CTRL+I (Windows и Linux)_This text is italicized_Этот курсивный текст
Зачеркнутый~~ ~~нет~~This was mistaken text~~Это был неправильный текст
Полужирный и вложенный курсив** ** и _ _.нет**This text is _extremely_ important**Этот текст очень важен
Весь полужирный и курсивный*** ***нет***All this text is important***Весь этот текст важен
Подстрочный индекс<sub> </sub>нетThis is a <sub>subscript</sub> textЭто подстрочный текст
Надстрочный индекс<sup> </sup>нетThis is a <sup>superscript</sup> textЭто надстрочный текст

Текст в кавычках

Цитировать текст можно с помощью >.

Text that is not a quote

> Text that is a quote

В кавычках текст отступен с другим цветом типа.

Снимок экрана: отрисованный GitHub Markdown с примером текста с кавычками. Цитата отступлена вертикальной линией слева, а его текст темно-серый, а не черный.

Примечание. При просмотре беседы можно автоматически кавычекировать текст в комментарии, выделите текст, а затем введите R. Вы можете процитировать весь комментарий, щелкнув , а затем цитата ответа. Дополнительные сведения о сочетаниях клавиш см. в разделе "сочетания клавиш;".

Цитирование кода

Вы можете выделить код или команду в предложении с помощью одинарных грависов. Текст, заключенный в обратные кавычки, не форматируется. Кроме того, вы можете использовать сочетание клавиш COMMAND+E (Mac) или CTRL+E (Windows/Linux) для вставки обратных кавычек для блока кода в строке Markdown.

Use `git status` to list all new or modified files that haven't yet been committed.

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

Чтобы выделить код или текст в отдельный блок, используйте тройные грависы.

Some basic Git commands are:
```
git status
git add
git commit
```

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

Дополнительные сведения см. в разделе Создание и выделение блоков кода.

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

Поддерживаемые цветовые модели

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

The background color is `#ffffff` for light mode and `#000000` for dark mode.

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

Ниже указаны поддерживаемые сейчас цветовые модели.

ColorСинтаксисПримерВыходные данные
HEX`#RRGGBB``#0969DA`Снимок экрана: отрисованный GitHub Markdown, показывающий, как значение HEX #0969DA отображается синим кругом.
RGB`rgb(R,G,B)``rgb(9, 105, 218)`Снимок экрана: отрисованный GitHub Markdown, показывающий, как rgb-значение 9, 105, 218 отображается синим кругом.
HSL`hsl(H,S,L)``hsl(212, 92%, 45%)`Снимок экрана: отрисованный GitHub Markdown, показывающий, как значение HSL 212, 92%, 45% отображается синим кругом.

Примечания:

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

Чтобы создать встроенную ссылку, заключите ее текст в квадратные скобки [ ], а затем заключите URL-адрес в обычные скобки ( ). Чтобы создать ссылку, можно также использовать сочетание клавиш Command+K. При выборе текста можно вставить URL-адрес из буфера обмена, чтобы автоматически создать ссылку из выделенного фрагмента.

Вы также можете создать гиперссылку Markdown, выделите текст и с помощью сочетания клавиш Command+V. Если вы хотите заменить текст ссылкой, используйте сочетание клавиш Command+Shift+V.

This site was built using [GitHub Pages](https://pages.github.com/).

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

Примечание. GitHub Enterprise Server автоматически создает ссылки при написании допустимых URL-адресов в комментарии. Дополнительные сведения см. в разделе Автосвязанные ссылки и URL-адреса.

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

Снимок экрана: README для репозитория. Слева от заголовка раздела значок ссылки описан в темно-оранжевый.

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

Относительная ссылка — это ссылка, заданная относительно текущего файла. Например, если есть файл сведений в корне репозитория и еще один файл в docs/CONTRIBUTING.md, относительная ссылка на CONTRIBUTING.md в файле сведений может выглядеть следующим образом:

[Contribution guidelines for this project](docs/CONTRIBUTING.md)

GitHub Enterprise Server автоматически преобразует относительную ссылку или путь к изображению с учетом текущей ветви, чтобы ссылка или путь всегда работали. Путь ссылки будет относительным к текущему файлу. Ссылки, начинающиеся с /, будут относительными к корневому каталогу репозитория. Можно использовать любые операнды относительных ссылок, например ./ и ../.

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

[Contribution 
guidelines for this project](docs/CONTRIBUTING.md)

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

Изображения

Вы можете включить изображение, добавив ! и заключив замещающий текст в [ ]. Замещающий текст — это короткий текст, эквивалентный информации на изображении. Затем оставьте ссылку на изображение в скобках ().

![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://myoctocat.com/assets/images/base-octocat.svg)

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

GitHub Enterprise Server поддерживает внедрение изображений в проблемы, запросы на вытягивание, комментарии и файлы .md. Вы можете отобразить изображение из репозитория, добавить ссылку на изображение в Интернете или отправить изображение. Дополнительные сведения см. в разделе Отправка ресурсов.

Примечание. Если вы хотите отобразить изображение, которое находится в репозитории, используйте относительные ссылки вместо абсолютных ссылок.

Ниже приведены некоторые примеры использования относительных ссылок для отображения изображений.

КонтекстОтносительная ссылка
В файле .md в той же ветви/assets/images/electrocat.png
В файле .md в другой ветви/../main/assets/images/electrocat.png
В проблемах, запросах на вытягивание и комментариях репозитория../blob/main/assets/images/electrocat.png?raw=true
В файле .md в другом репозитории/../../../../github/docs/blob/main/assets/images/electrocat.png
В проблемах, запросах на вытягивание и комментариях другого репозитория../../../github/docs/blob/main/assets/images/electrocat.png?raw=true

Примечание. Последние две относительные ссылки в таблице выше будут работать для изображений в частном репозитории, только если средство просмотра имеет по крайней мере доступ на чтение к частному репозиторию, содержащему эти изображения.

Дополнительные сведения см. в разделе Относительные ссылки.

Указание темы, в которой отображается изображение

Вы можете указать тему, для которой отображается изображение, в Markdown с помощью HTML-элемента <picture> в сочетании с функцией мультимедиа prefers-color-scheme. Имеется два цветовых режима: светлый и темный, поэтому доступны два варианта. Эти варианты можно использовать для отображения изображений, оптимизированных для темных или светлых фонов. Особенно полезно это в случае с прозрачными изображениями в формате PNG.

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

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/25423296/163456776-7f95b81a-f1ed-45f7-b7ab-8fa810d529fa.png">
  <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
  <img alt="Shows an illustrated sun in light mode and a moon with stars in dark mode." src="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png">
</picture>

Старый метод указания изображений на основе темы с помощью фрагмента, добавленного к URL-адресу (#gh-dark-mode-only или #gh-light-mode-only), объявлен нерекомендуемым и будет заменен новым методом, который описан выше.

Списки

Вы можете сделать неупорядоченный список, выполнив одну или несколько строк текста с -помощью ,* или.+

- George Washington
* John Adams
+ Thomas Jefferson

Снимок экрана: отрисованный GitHub Markdown с маркированный список имен первых трех американских президентов.

Чтобы упорядочить список, поставьте перед каждой строкой номер.

1. James Madison
2. James Monroe
3. John Quincy Adams

Снимок экрана: отрисованный GitHub Markdown с нумерованным списком имен четвертых, пятых и шестых американских президентов.

Вложенные списки

Чтобы создать вложенный список, добавьте отступы для одного или нескольких элементов списка под другим элементом.

Чтобы создать вложенный список с помощью веб-редактора GitHub Enterprise Server или текстового редактора, использующего монопространстванный шрифт, например Visual Studio Code, можно визуально выровнять список. Введите пробелы перед вложенным элементом списка, пока символ маркера списка (- или *) находится непосредственно под первым символом текста в элементе над ним.

1. First list item
   - First nested list item
     - Second nested list item

Примечание. В веб-редакторе можно добавить или убрать отступы для одной или нескольких строк текста, сначала выделив нужные строки, а затем нажав клавиши TAB или SHIFT+TAB соответственно.

Снимок экрана: Markdown в Visual Studio Code с отображением отступных маркеров по вертикали с первой буквой текстовых строк над ними.

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

Чтобы создать вложенный список в редакторе комментариев на GitHub Enterprise Server, в котором не используется моноширинный шрифт, можно подсчитать количество символов перед содержимым элемента списка непосредственно над вложенным списком. Затем введите такое же число пробелов перед элементом вложенного списка.

В этом примере можно добавить элемент вложенного списка под элементом 100. First list item списка, отступив от начала строки не менее чем на пять пробелов, так как перед текстом First list item пять символов (100 .).

100. First list item
     - First nested list item

Снимок экрана: отрисованный GitHub Markdown, показывающий элемент списка, предшествующий номеру 100, за которым следует маркированный элемент, вложенный один уровень справа.

Таким же образом можно создавать несколько уровней вложения списков. Например, так как первый вложенный элемент списка имеет семь символов (␣␣␣␣␣-␣) перед вложенным содержимым First nested list itemсписка, необходимо отступить второй вложенный элемент списка по крайней мере двумя символами (девять пробелов).

100. First list item
       - First nested list item
         - Second nested list item

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

Дополнительные примеры см. в спецификации GitHub Flavored Markdown.

Списки задач

Чтобы создать список задач, добавьте к элементам списка префикс — дефис, пробел, а затем [ ]. Чтобы пометить задачу как завершенную, используйте [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Снимок экрана: отрисованная версия markdown. Ссылки на проблемы отображаются в виде заголовков проблем.

Если описание элемента списка задач начинается с круглой скобки, необходимо экранировать ее с помощью символа \:

- [ ] \(Optional) Open a followup issue

Дополнительные сведения см. в разделе Сведения о списках задач.

Упоминание людей и команд

Вы можете упомянуть пользователя или команду на GitHub Enterprise Server, введя @ перед их именем. Пользователь или команда получит уведомление, которое привлечет их внимание к беседе. Пользователи также получают уведомления, когда вы изменяете комментарий, упоминая имя пользователя или команды. Дополнительные сведения о уведомлениях см. в разделе "Об уведомлениях".

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

@github/support What do you think about these updates?

Снимок экрана: отрисованный GitHub Markdown, показывающий, как команда упоминает "@github/support" отрисовывается как полужирный, щелкаемый текст.

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

При вводе символа @ отображается список людей или команд, участвующих в проекте. Список фильтруется по мере ввода, поэтому после того, как вы найдете имя нужного человека или команды, можно выбрать его с помощью клавиш со стрелками и нажать клавишу TAB или ВВОД, чтобы завершить имя. Для команд введите @organization/team-name, и все члены этой команды будут подписаны на беседу.

Результаты автозавершения ограничены участниками репозитория и любыми другими участниками беседы.

Ссылка на проблемы и запросы на вытягивание

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

Дополнительные сведения см. в разделе Автосвязанные ссылки и URL-адреса.

Ссылка на внешние ресурсы

Если для репозитория настроены пользовательские автоматические ссылки, то ссылки на внешние ресурсы, такие как проблема JIRA или тикет Zendesk, конвертируются в сокращенные ссылки. Чтобы узнать, какие автоматические ссылки доступны в репозитории, обратитесь к кому-то, у кого есть разрешения администратора в отношении репозитория. Дополнительные сведения см. в разделе Настройка автоматической привязки для отсылок на внешние ресурсы.

Отправка ресурсов

Вы можете отправлять такие ресурсы, как изображения, путем перетаскивания, выбора в обозревателе файлов или вставки. Вы можете отправлять ресурсы в проблемы, запросы на вытягивание, комментарии и файлы .md в репозитории.

Использование эмодзи

Вы можете добавить эмодзи к написанию, введя :EMOJICODE:двоеточие, за которым следует имя эмодзи.

@octocat :+1: This PR looks great - it's ready to merge! :shipit:

Снимок экрана: отрисованный GitHub Markdown, показывающий, как коды эмодзи для +1 и shipit визуализировать как эмодзи.

При вводе : отображается список предлагаемых эмодзи. Список фильтруется по мере ввода, поэтому после того, как вы найдете нужный эмодзи, нажмите клавишу TAB или ВВОД, чтобы завершить выделенный результат.

Полный список доступных эмодзи и кодов см . в Emoji-Cheat-Sheet.

Абзацы

Чтобы создать абзац, оставьте пустую строку между строками текста.

Сноски

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

Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference.
[^2]: To add line breaks within a footnote, prefix new lines with 2 spaces.
  This is a second line.

Сноски отрисовываются следующим образом:

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

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

Сноски на вики-сайтах не поддерживаются.

Скрытие содержимого с помощью комментариев

Вы можете сообщить GitHub Enterprise Server, что необходимо скрыть содержимое в отрисованном файле Markdown, поместив это содержимое в комментарий HTML.

<!-- This content will not appear in the rendered Markdown -->

Игнорирование форматирования Markdown

Вы можете сообщить GitHub Enterprise Server, что необходимо игнорировать (или экранировать) форматирование Markdown, используя символ \ перед символом Markdown.

Let's rename \*our-new-project\* to \*our-old-project\*.

Снимок экрана: отрисованный GitHub Markdown, показывающий, как обратная косая черта предотвращает преобразование звездочек в курсив. Текст считывает: "Давайте переименуем наш новый проект в наш старый проект".

Дополнительные сведения о обратных косых чертах см. в статье "Синтаксис Markdown" Даринга Fireball.

Примечание. Форматирование Markdown не будет игнорироваться в заголовке проблемы или запроса на вытягивание.

Отключение отрисовки Markdown

При просмотре файла Markdown можно щелкнуть в верхней части файла, чтобы отключить отрисовку Markdown и просмотреть источник файла.

Снимок экрана: файл Markdown в репозитории GitHub с параметрами взаимодействия с файлом. Кнопка для отображения исходного большого двоичного объекта выделена темно-оранжевым цветом.

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

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