Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Создание и выделение блоков кода

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

Огороженные блоки кода

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

```
function test() {
  console.log("notice the blank line before this function?");
}
```

Отрисованный блок кода с ограждением

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

Чтобы показать три обратных штриха в блоке кода с ограждением, заключите их в четыре обратных штриха.

````
```
Look! You can see my backticks.
```
````

Отрисованный код с ограждением с блоком из обратных штрихов

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

Выделение синтаксиса

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

Например, так можно задать выделение синтаксических конструкций Ruby:

```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

Отрисованный блок кода с выделением синтаксических конструкций Ruby

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

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