В зависимости от объёма кода существуют следующие способы разметки:
разметка фрагмента кода;
разметка блока кода от одной строки и более.
Для того чтобы указать фрагмент кода внутри абзаца, следует поставить обратные кавычки (`).
Пример фрагмента года:
Используйте функцию `printf()`.
При публикации получим следующий код HTML:
<p>Используйте функцию <code>printf()</code>.</p>
Разметка чрезвычайна полезна в случае, если в тексте есть фрагменты с угловыми кавычками. Угловые скобки тега автоматически заменены на последовательности < и >, что не приводит к конфликту внутри HTML страницы.
Пример текста с угловыми кавычками:
Текст с упоминанием тега '<div>'.
При публикации получим следующий код HTML:
<p>Текст с упоминанием тега <code><div></code>.</p>
Аналогичная ситуация с кодами символов.
Пример фрагмента с кодом символа:
`—` представляет собой код символа `—`
При публикации получим следующий код HTML:
<p><code>&#8212;</code> представляет собой код символа <code>&mdash;</code></p>
Если фрагмент кода включает обратную кавычку, то следует:
окружить обратную кавычку кода пробелами;
в начале и конце фрагмента поставить по две обратные кавычки.
Пример фрагмента кода с кавычкой:
Используйте функцию `` `foo()` ``.
При публикации получим следующий код HTML:
<p>Используйте функцию <code>`foo()`</code>.</p>
Строка или блок кода размечаются тремя обратными кавычками (```) в начале и конце кода.
Пример строки кода в тексте:
``` <Строка кода> ```
При публикации получим следующий код HTML:
<p><code><Строка кода></code></p>
Пример блока (нескольких строк) кода в тексте:
```
# Комментарий в коде
print 'для удобства чтения'
print 'добавьте 4 пробела'
```
При публикации получим следующий код HTML:
<pre><code> # Комментарий в коде
print 'для удобства чтения'
print 'добавьте 4 пробела'
</code></pre>
В каждом языке программирования существует своя подсветка (выделение цветом) конструкций кода. Если в блоке кода указать язык программирования, то при публикации код будет подсвечен в соответствии с правилами указанного языка.
Пример подсветки кода для JSON:
```json
{
"firstName": "Иван",
"secondName": "Иванович",
"lastName": "Иванов",
"age": 25
}
```
При публикации получим следующий код HTML:
<pre><code class="language-json">{
"firstName": "Иван",
"secondName": "Иванович",
"lastName": "Иванов",
"age": 25
}
</code></pre>
Разметка кода в списке подробно описана в разделе «Список».