Skip to main content

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

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

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

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

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

Снимок экрана: отрисованный GitHub Markdown, показывающий, как тройные обратные знаки вызывают отрисовку блока кода в необработанном форматировании. Блок начинается с "function test() {".

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

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

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

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

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

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

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

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

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

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

Откроется блок кода с выделением синтаксиса:

Снимок экрана: три строки кода Ruby, отображаемые на GitHub. Элементы кода отображаются в фиолетовом, синем и красном типе, что делает линии более визуально сканируемыми.

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

Создание схем

С помощью блоков кода также можно создавать схемы в Markdown. GitHub поддерживает синтаксис Mermaid, GeoJSON, TopoJSON и ASCII STL. Дополнительные сведения см. в разделе Создание схем.

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