Markdown 基本语法

段落

Очень естественно, одна строка текста — это один абзац.

Например:

Это абзац.

Будет интерпретировано как:

<p>Это абзац.</p>

Если вам нужен новый абзац, пожалуйста, оставьте пустую строку между двумя абзацами.

Этот абзац.

Это другой абзац.

Интерпретируется как:

<p>Этот абзац</p>
<p>Это другой абзац</p>

Без пустой строки между строками, в некоторых редакторах это будет интерпретироваться как перенос строки, то есть вставка тега <br />. В других редакторах это может быть интерпретировано как вставка пробела. Для последнего случая, если вы хотите вставить тег переноса строки, добавьте два пробела в конце текущей строки.

Жирный и курсив

Используйте звёздочку * или подчёркивание _ для выделения текста жирным шрифтом или курсивом.

*Это курсив.*
_Это тоже курсив._
**Это жирный шрифт.**
***Это жирный + курсив.***

Будет интерпретировано как:

<em>Это курсив.</em>
<em>Это тоже курсив.</em>
<strong>Это жирный шрифт.</strong>
<strong><em>Это жирный + курсив</strong></em>

Зачёркивание

Некоторые редакторы поддерживают зачёркивание, которое не является частью классического синтаксиса Markdown. Используйте волнистую линию ~ для зачёркивания.

~~Вот так~~

Будет интерпретировано как:

<strike>Вот так</strike>

Заголовок

Markdown поддерживает от одного до шести уровней заголовков, обозначаемых количеством знаков # перед строкой.

# Это H1 #

## Это H2 ##

### Это H3 ###

...

###### Это H6 ######

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

Кроме того, H1 и H2 также могут быть реализованы путём добавления линии под текстом, например:

Это H1
=======

Это H2
-------

Цитата

Добавьте знак > в начале строки для создания цитаты.

> Это блок-цитата с двумя абзацами. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Готово. Алипсум семпер ипсум сидит амет велит. Suspendisse
id sem consectetuer libero luctus adipiscing.

Цитаты могут быть вложенными:

> Это первый уровень цитирования.
>
> > Это вложенная цитата.
>
> Вернёмся к первому уровню.

Также можно вкладывать другие форматы:

> ## Это заголовок.
>
> 1.   Это первый элемент списка.
> 2.   Это второй элемент списка.
>
> Приведите несколько примеров кода:
>
>     return shell_exec("echo $input | $markdown_script");

Список

Неупорядоченный список использует звёздочки, знаки «плюс» или «минус» в качестве маркеров списка:

*   Красный
*   Зелёный
*   Синий

Эквивалентно:

+   Красный
+   Зелёный
+   Синий

И:

-   Красный
-   Зелёный
-   Синий

Упорядоченный список использует цифры, за которыми следует точка:

1.  Bird
2.  McHale
3.  Parish

Цифры не влияют на результат HTML, поэтому приведённый выше пример эквивалентен:

1.  Bird
1.  McHale
1.  Parish

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

Используйте обратные кавычки ` для обозначения встроенного кода, который будет интерпретирован как тег <code>. Если в коде есть обратные кавычки, используйте две обратные кавычки для их заключения. Символы &, < и > автоматически экранируются, что позволяет безопасно использовать их.

Область кода

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

Это обычный абзац:

    Это блок кода.

Будет интерпретировано как:

<p>Это обычный абзац:</p>

<pre><code>Это блок кода.</code></pre>

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

Существует также стиль GitHub, где блок кода обозначается тремя обратными кавычками в начале и в конце одной строки.

Большинство современных редакторов поддерживают этот стиль.

Разделительная линия

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

* * *
***
*****
- - -
---------------------------------------

Ссылка

[пример](http://example.com/)
[пример](http://example.com/ "Заголовок")

Будут интерпретированы как:

<a href='http://example.com/'>пример</a>
<a href='http://example.com/' title="Заголовок">пример</a>

Помимо стиля в строке, также можно использовать ссылочный стиль:

[пример][id]

Затем определите его в любом месте:

[id]: http://example.com/ "Заголовок"

Изображение

![Альтернативный текст](/путь/к/изображению.jpg)
![Альтернативный текст](/путь/к/изображению.jpg "Заголовок")

Будут интерпретированы как:

<img src='/путь/к/изображению.jpg' alt='Альтернативный текст' />
<img src='/путь/к/изображению.jpg' alt='Альтернативный текст' title='Заголовок' />

Аналогично, изображения также имеют ссылочный синтаксис.

Автоматическая ссылка

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

<http://example.com/>

Соответствует:

[http://example.com/](http://example.com/)

Обратите внимание, что большинство редакторов автоматически рассматривают URL-адреса как ссылки и интерпретируют их как таковые. Во многих случаях из-за невнимательности автора ссылка и следующий за ней текст на китайском языке не разделяются пробелом, что приводит к неправильной работе ссылки. Поэтому рекомендуется либо добавлять квадратные скобки, либо добавлять пробелы с обеих сторон.

Экранирование

Markdown позволяет вставлять обратную косую черту перед следующими символами:

\   Обратная косая черта
`   Апостроф
*   Звёздочка
_   Линия
{}  Фигурные скобки
[]  Квадратные скобки
()  Круглые скобки
#   Знак номера
+   Знак плюса
-   Знак минуса
.   Точка
!   Восклицательный знак

После вставки эти символы больше не анализируются, а выводятся как есть.

Таблица

Таблицы являются частью синтаксиса GitHub, но в последнее время всё больше редакторов их поддерживают.

| Элемент     | Значение | Количество |
| :---------- | -------: | :--------: |
| Компьютер   | 1600     | 5          |
| Телефон     | 12       | 12         |
| Труба       | 1        | 234        |

Будут интерпретированы как:

<table>
<thead>
<tr>
  <th align="left">Элемент</th>
  <th align="right">Значение</th>
  <th align="center">Количество</th>
</tr>
</thead>
<tbody><tr>
  <td align="left">Компьютер</td>
  <td align="right">1600</td>
  <td align="center">5</td>
</tr>
<tr>
  <td align="left">Телефон</td>
  <td align="right">12</td>
  <td align="center">12</td>
</tr>
<tr>
  <td align="left">Труба</td>
  <td align="right">1</td>
  <td align="center">234</td>
</tr>
</tbody></table>

Второй ряд определяет выравнивание (по левому краю, по правому краю или по центру), если вы не добавляете двоеточие, выравнивание по умолчанию — по левому краю.

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

Встроенные HTML

Markdown