Руководство по оформлению Markdown файлов Link to heading

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

Заголовки Link to heading

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

Пример:

Заголовок первого уровня Link to heading

Заголовок второго уровня Link to heading

Заголовок третьего уровня Link to heading

Заголовок четвёртого уровня Link to heading

Заголовок пятого уровня Link to heading

Заголовок шестого уровня Link to heading

Параграфы и переносы строк Link to heading

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

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

Пример:

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

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

Выделение текста Link to heading

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

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

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

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

Пример:

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

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

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

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

Списки Link to heading

Нумерованный список Link to heading

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

Пример:

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

Маркированный список Link to heading

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

Пример:

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

Вложенные списки Link to heading

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

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

Пример:

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

Ссылки Link to heading

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

Пример:

Текст ссылки

Изображения Link to heading

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

Пример:

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

Блоки кода Link to heading

Строка кода Link to heading

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

Пример:

строка кода

Блок кода Link to heading

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

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

Пример:

Блок кода

Подсветка кода Link to heading

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

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

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

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

Пример:

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

Цитаты Link to heading

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

Пример:

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

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

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

Горизонтальная линия Link to heading

---

Пример:

Таблицы Link to heading

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

Пример:

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

Таблица как HTML Link to heading

<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>

Пример:

Чек-листы Link to heading

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

Пример:

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

Внутренние ссылки Link to heading

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

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

Пример:

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

Заголовок 1 Link to heading

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

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

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

## Some Title 1
Some content

Пример:

Some title 1

Some Title 1 Link to heading

Some content

Автоматические ссылки Link to heading

<http://example.com/>

<address@example.com>

Пример

http://example.com/

address@example.com

HTML Link to heading

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

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

Пример:

CTRL + P

HTML-коды Link to heading

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

A&macr;

Пример:

A¯

Комментарии Link to heading

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

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

Пример:

Эмодзи (Github) Link to heading

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

:smile:
:laughing:
:blush:

Пример:

:smile: :laughing: :blush: