Markdown
Код

Синтаксис

• inline : «Код между backticks» или <code> Код между этими HTML-тегами </ code>
• multiline : ____Код, который имеет отступы в каждой строке или <pre> <code> Несколько строк кода между этими тегами HTML </ code> </ pre>

Встроенный код

Markdown поддерживает добавление встроенного кода, полученного like this , путем обертывания текста в обратные ссылки:

`code here`

Кроме того, вы можете поместить свой встроенный код между тегами HTML <code> и </code> .

Рассмотрим следующий код уценки:

`This` is an inline code block! <code>This</code> is one too!

Это даст следующий результат:

This встроенный блок кода! This тоже!

Если вам нужно включить обратную линию внутри встроенного кода, вы можете использовать несколько backticks для начала и завершения встроенного блока кода, например:

``code containing a backtick (`) character``

Это даст следующий результат:

code containing a backtick (`) character

Используйте \ чтобы избежать обратных шагов. Например:

\`a\`

будут представлены как

`a`

Выделение синтаксиса (StackExchange)

На сайтах StackExchange фрагменты кода могут предоставлять необязательную подсветку синтаксиса. На таких сайтах, как Stack Overflow, язык по умолчанию выводится из тегов, используемых в соответствующем вопросе (если применимо). Кроме того, язык подсветки синтаксиса кода фрагмента кода также может быть определен путем добавления комментария HTML к тексту .

<!-- language: lang-vb -->

    Sub ShowVB()
    Dim i As Long
    For i = 1 To 2
        If i = 3 Then
            MsgBox "How did that happen?"
        End If
    Next
    End Sub

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

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

Sub ShowVB()
Dim i As Long
For i = 1 To 2
    If i = 3 Then
        MsgBox "How did that happen?"
    End If
Next
End Sub

Отступные кодовые блоки

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

    #include <stdio.h>

    int main() {
      printf("Hello World!\n");
      return 0;
    }

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

Некоторые парсеры позволяют назначать код, добавляя три обратных элемента до и после раздела кода.

```
<p><em>This</em> is an HTML example!</p>
```

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

```html
<p><em>This</em> is an HTML example!</p>
```

Результат:

<p><em>This</em> is an HTML example!</p>

Блокированные блоки кода внутри списков

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

1. StackExchange требует, чтобы код был отступом на 8 символов вместо обычного 4. (Пространства заменены на * для ясности) :

    1.*Listitem1
    2.*Listitem2
    
    ********code here
    3.*Listitem3
   

2. В таких спецификациях, как CommonMark, требуется, чтобы в блоке кода было отложено 4 символа, из которых начинается текст элемента списка. (Для ясности пробелы заменены на * ) :

    1.****Listitem1
    2.****Listitem2
    
    **********code here
    3.****Listitem3