Код

Любой фрагмент между тремя обратными кавычками Docara оформляет как блок кода. Это может быть HTML, PHP, JSON, команда терминала, конфигурация или обычный текст. Блок ничего не выполняет: он сохраняет пробелы и переносы, подсвечивает синтаксис, позволяет скопировать содержимое и при необходимости мягко перенести длинные строки в пределах доступной ширины.

Блок с указанным языком

Язык задаётся сразу после открывающих обратных кавычек. Он появляется в заголовке и выбирает правила подсветки.

<article class="p-2 radius-2 bg-surface-container">
    <h2 class="sf-h-3 m-0">Карточка интерфейса</h2>
    <p class="m-0 m-top-1">Одна разметка, понятные модификаторы.</p>
</article>

Блок без указанного языка

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

composer install

Язык и оформление

После открывающих обратных кавычек укажите язык: php, json, bash, javascript или другой поддерживаемый идентификатор. Он появляется в заголовке блока и помогает подсветке синтаксиса.

По умолчанию длинная строка прокручивается внутри блока и не растягивает всю страницу. Кнопка «Переносить длинные строки» включает только визуальный CSS-перенос. Исходный текст, отступы и результат копирования не меняются. Когда перенос включён, значок меняется на команду возврата к исходным строкам. Видимая рамка фокуса появляется при переходе клавиатурой, но не после щелчка мышью. Выбор общий для обычных блоков и вкладок исходника в Example, сохраняется в браузере и синхронно применяется ко всем таким блокам на странице.

Возможность переноса включена встроенным параметром code.wrap. Её можно отключить для сайта, раздела или страницы:

{
  "code": {
    "wrap": false
  }
}

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

Как записать в Markdown

```php
echo 'Готово';
```

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