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

Заголовки Ссылка на заголовок

# Заголовок первого уровня
## Заголовок второго уровня
### Заголовок третьего уровня
#### Заголовок четвёртого уровня
##### Заголовок пятого уровня
###### Заголовок шестого уровня

Пример:

Заголовок первого уровня Ссылка на заголовок

Заголовок второго уровня Ссылка на заголовок

Заголовок третьего уровня Ссылка на заголовок

Заголовок четвёртого уровня Ссылка на заголовок

Заголовок пятого уровня Ссылка на заголовок

Заголовок шестого уровня Ссылка на заголовок

Параграфы и переносы строк Ссылка на заголовок

Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста.

Это первая строка  
И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки.

Пример:

Это параграф. Чтобы создать новый параграф, оставьте пустую строку между двумя строками текста.

Это первая строка
И это вторая строка, но они находятся в одном параграфе. Для переноса строки используйте два пробела в конце предыдущей строки.

Выделение текста Ссылка на заголовок

*курсив*  
_курсив_

**жирный**  
__жирный__

***жирный курсив***  
___жирный курсив___

~~зачеркнутый~~

Пример:

курсив
курсив

жирный
жирный

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

~~зачеркнутый~~

Списки Ссылка на заголовок

Нумерованный список Ссылка на заголовок

1. Пункт первый
2. Пункт второй
3. Пункт третий

Пример:

Пункт первый
Пункт второй
Пункт третий

Маркированный список Ссылка на заголовок

- Пункт первый
- Пункт второй
- Пункт третий

Пример:

Пункт первый
Пункт второй
Пункт третий

Вложенные списки Ссылка на заголовок

Также можно делать вложенные списки, добавляя 4 пробела перед пунктом:

1. Пункт первый
    - Подпункт первый
    - Подпункт второй
2. Пункт второй

Пример:

Пункт первый
- Подпункт первый
- Подпункт второй
Пункт второй

Ссылки Ссылка на заголовок

[Текст ссылки](https://www.example.com)

Пример:

Текст ссылки

Изображения Ссылка на заголовок

![Текст описания](https://www.example.com/image.jpg)

Пример:

Текст описания

Блоки кода Ссылка на заголовок

Строка кода Ссылка на заголовок

`строка кода`

Пример:

строка кода

Блок кода Ссылка на заголовок

Удалите символы \

\```
Блок кода
\```

Пример:

Блок кода

Подсветка кода Ссылка на заголовок

Для блоков кода можно указывать язык программирования.

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

Удалите символы \

\```python
print("Привет, мир!")
\```

Пример:

print("Привет, мир!")

Цитаты Ссылка на заголовок

> Первый уровень цитирования
>> Второй уровень цитирования
>>> Третий уровень цитирования

Пример:

Первый уровень цитирования

Второй уровень цитирования

Третий уровень цитирования

Горизонтальная линия Ссылка на заголовок

---

Пример:

Таблицы Ссылка на заголовок

| Заголовок 1 | Заголовок 2 |
| ----------- | ----------- |
| Ячейка 1    | Ячейка 2   |
| Ячейка 3    | Ячейка 4   |

Пример:

Заголовок 1	Заголовок 2
Ячейка 1	Ячейка 2
Ячейка 3	Ячейка 4

Таблица как HTML Ссылка на заголовок

<table>
    <tr>
        <th>Заголовок 1</th>
        <th>Заголовок 2</th>
    </tr>
    <tr>
        <td>Ячейка 1.1</td>
        <td>Ячейка 2.1</td>
    </tr>
    <tr>
        <td>Ячейка 1.2</td>
        <td>Ячейка 2.2</td>
    </tr>
</table>

Пример:

Чек-листы Ссылка на заголовок

- [x] Задача 1
- [ ] Задача 2
- [ ] Задача 3

Пример:

Задача 1
Задача 2
Задача 3

Внутренние ссылки Ссылка на заголовок

[Перейти к Заголовку 1](#title1)

## <a id="title1">Заголовок 1</a>
Какой-то контент

Пример:

Перейти к Заголовку 1

Заголовок 1 Ссылка на заголовок

Какой-то контент

Ссылка на заголовок на английском Ссылка на заголовок

[Some title 1](#some-title-1)

## Some Title 1
Some content

Пример:

Some title 1

Some Title 1 Ссылка на заголовок

Some content

Автоматические ссылки Ссылка на заголовок

<http://example.com/>

<address@example.com>

Пример

http://example.com/

address@example.com

HTML Ссылка на заголовок

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

<kbd>CTRL</kbd> + <kbd>P</kbd>

Пример:

CTRL + P

HTML-коды Ссылка на заголовок

Например, вы можете использовать HTML-код ¯ для добавления черты над буквой:

A&macr;

Пример:

A¯

Комментарии Ссылка на заголовок

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

[//]: # (Это комментарий, он не будет отображаться)

Пример:

Эмодзи (Github) Ссылка на заголовок

Вы можете использовать эмодзи в своих Markdown-файлах. Существует множество эмодзи, которые вы можете использовать, вот некоторые из них:

:smile:
:laughing:
:blush:

Пример:

😄 😆 😊