# Markdown

**Markdown** — это легкий язык разметки, который используется для оформления текста в читаемом виде, а также его преобразования в HTML и другие форматы. Он удобен благодаря простоте синтаксиса и широкому применению: Markdown используют в блогах, форумах, документации, а также в системах контроля версий.

### Основные элементы синтаксиса Markdown

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

Заголовки создаются с помощью символа `#`. Чем больше символов `#`, тем ниже уровень заголовка.

```markdown
# Заголовок 1
## Заголовок 2
### Заголовок 3
```

**Результат**:

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

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

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

#### Форматирование текста

Markdown позволяет легко выделять текст **полужирным** или _курсивом_, а также делать ~~зачёркивание~~.

* **Полужирный**: используйте `**текст**` или `__текст__`
* _Курсив_: используйте `*текст*` или `_текст_`
* ~~Зачёркнутый~~: используйте `~~текст~~`

```markdown
**Полужирный текст**
*Курсивный текст*
~~Зачёркнутый текст~~
```

**Результат**:

**Полужирный текст**\
&#xNAN;_&#x41A;урсивный текст_\
~~Зачёркнутый текст~~

#### Списки

Markdown поддерживает маркированные и нумерованные списки.

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

```markdown
- Элемент 1
- Элемент 2
  - Подэлемент
```

**Результат**:

* Элемент 1
* Элемент 2
  * Подэлемент

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

```markdown
1. Первый элемент
2. Второй элемент
   1. Подэлемент
```

**Результат**:

1. Первый элемент
2. Второй элемент
   1. Подэлемент

#### Ссылки и изображения

Markdown упрощает вставку ссылок и изображений.

* **Ссылки**: `[текст ссылки](URL)`
* **Изображения**: `![альтернативный текст](URL изображения)`

```markdown
[Перейти на Google](https://www.google.com)

![Логотип Markdown](https://markdown-here.com/img/icon256.png)
```

**Результат**:

[Перейти на Google](https://www.google.com)

#### Блоки кода и выделение кода

Код можно выделить как внутри текста, так и отдельным блоком.

* **Встроенное выделение**: используйте `` `код` ``
* **Блок кода**: используйте тройные обратные кавычки (\`\`\`) перед и после блока кода.

```markdown
Пример встроенного выделения: `код`

Пример блока кода: function example() { console.log("Привет, Markdown!"); }
```

**Результат**:

Пример встроенного выделения: `код`

Пример блока кода:

```javascript
function example() {
    console.log("Привет, Markdown!");
}
```

#### Цитаты

Цитаты создаются с помощью символа `>`.

```markdown
> Это пример цитаты.
> Она может занимать несколько строк.
```

**Результат**:

> Это пример цитаты.\
> Она может занимать несколько строк.

#### Горизонтальные линии

Чтобы разделить содержимое, можно вставить горизонтальную линию, используя три или больше тире (`---`), подчеркивания (`___`), или звездочки (`***`).

```markdown
---
```

**Результат**:

***

### Пример использования Markdown для создания документации

Markdown отлично подходит для создания документации благодаря его читабельности и легкости форматирования. Вот пример простого руководства с использованием Markdown:

```markdown
# Руководство по установке

## Шаг 1: Загрузка
Скачайте программу с [официального сайта](https://example.com).

## Шаг 2: Установка
1. Откройте загруженный файл.
2. Следуйте инструкциям мастера установки.

## Шаг 3: Запуск
После завершения установки запустите программу из меню "Пуск".

> **Примечание**: Убедитесь, что ваше устройство соответствует системным требованиям.
```

