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

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

### Заголовки

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

***Пример:***

## Заголовок первого уровня

### Заголовок второго уровня

#### Заголовок третьего уровня

**Заголовок четвёртого уровня**

**Заголовок пятого уровня**

**Заголовок шестого уровня**

***

### Параграфы и переносы строк

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

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

***Пример:***

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

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

***

### Выделение текста

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

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

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

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

***Пример:***

*курсив*\
\&#xNAN;*курсив*

**жирный**\
**жирный**

***жирный курсив***\
\&#xNAN;***жирный курсив***

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

***

### Списки

#### Нумерованный список

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

***Пример:***

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

***

#### Маркированный список

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

***Пример:***

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

***

#### Вложенные списки

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

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

***Пример:***

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

***

### Ссылки

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

***Пример:***

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

***

### Изображения

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

***Пример:***

![Текст описания](https://assets.simpleviewinc.com/simpleview/image/upload/c_fill,h_720,q_75,w_1400/v1/clients/newyorkcity/Coronavirus_Info_midtown_manhattan_skyline_nyc_3000x2000_364fa9b8-86ce-4f95-907a-4bd8ea32f232.jpg)

***

### Блоки кода

#### Строка кода

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

***Пример:***

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

***

#### Блок кода

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

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

***Пример:***

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

***

#### Подсветка кода

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

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

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

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

***Пример:***

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

***

### Цитаты

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

***Пример:***

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

***

### Горизонтальная линия

```
---
```

***Пример:***

***

***

### Таблицы

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

***Пример:***

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

***

#### Таблица как HTML

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

***Пример:***

| Заголовок 1 | Заголовок 2 |
| ----------- | ----------- |
| Ячейка 1.1  | Ячейка 2.1  |
| Ячейка 1.2  | Ячейка 2.2  |

***

### Чек-листы

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

***Пример:***

* [x] Задача 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-теги для более сложного оформления:

```html
<kbd>CTRL</kbd> + <kbd>P</kbd>
```

***Пример:***

CTRL + P

***

### HTML-коды

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

```html
A&macr;
```

***Пример:***

A¯

***

### Комментарии

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

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

***Пример:***

***

### Эмодзи (Github)

Вы можете использовать эмодзи в своих Markdown-файлах. [Существует множество эмодзи](https://gist.github.com/rxaviers/7360908), которые вы можете использовать, вот некоторые из них:

```
:smile:
:laughing:
:blush:
```

***Пример:***

:smile: :laughing: :blush:

***

### Cards

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td></tr><tr><td></td><td></td><td></td></tr></tbody></table>

***

### Tabs

{% tabs %}
{% tab title="First Tab" %}
1
{% endtab %}

{% tab title="Second Tab" %}
2
{% endtab %}
{% endtabs %}

***

## Drawing

Ввел

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

<img src="https://content.gitbook.com/content/PdMzadPci40RiGEtsqeu/blobs/L1c92Dl7U7914rGoq1lW/file.excalidraw%20(1).svg" alt="Википедия" class="gitbook-drawing">

***

## Math & TeX

$$
f(x) = x \* e^{2 pi i \xi x}
$$

***

### Google Forms

{% embed url="<https://forms.gle/nzXUcc7HfixZSu5YA>" %}

***

### Google таблица

{% embed url="<https://docs.google.com/spreadsheets/d/18kMnomghHm5KymUKk2Sopc5tpZaH_qLrEQttPttFafw/edit?usp=sharing>" %}

***

### Папка в Google Drive

{% embed url="<https://drive.google.com/drive/folders/1XQZicnzzjZxVF4shJKpEDmndd8qnJPZB?usp=sharing>" %}

***

### Google Slides

{% embed url="<https://docs.google.com/presentation/d/1bKP2w1r_ZNkNGV253JEu1icGCg18EYn7z1bRLinNRWI/edit?usp=sharing>" %}

***

### Slides.com

{% embed url="<https://slides.com/nikolai11111111333/deck>" %}

***

### Рисунок

<img src="https://content.gitbook.com/content/PdMzadPci40RiGEtsqeu/blobs/a4C0lm9hIZFzAzFI603r/file.excalidraw%20(2).svg" alt="" class="gitbook-drawing">