# 07 — Изображения и вложения

🌍 [English](../../en/07-images-and-media/readme.md) · [Türkçe](../../tr/07-images-and-media/readme.md) · [Deutsch](../../de/07-images-and-media/readme.md) · [Français](../../fr/07-images-and-media/readme.md) · **Русский**

## Как вставить изображение в документ

1. Загрузите изображение рядом с документом: откройте каталог, **Добавить файл → Загрузить файл**.
2. Сошлитесь на него из файла Markdown:

```markdown
![Топология сети](topology.png)
```

Текст в квадратных скобках — это описание, которое показывается, если изображение не загрузилось, и которое читают программы для незрячих. Пишите настоящее описание, а не «картинка».

## Где хранить изображения

Предсказуемая структура, которая работает всегда:

```
project/
  readme.md
  assets/
    topology.png
    rack.jpg
```

и в `readme.md`:

```markdown
![Топология сети](assets/topology.png)
```

## Именование — единственное правило, которое стоит запомнить

Для **каталогов** и файлов изображений используйте строчные имена без пробелов:

| Хрупко | Безопасно |
|--------|-----------|
| `Снимок экрана.PNG` | `screenshot.png` |
| `1-) Заметки Inter-VLAN/` | `01-inter-vlan/` |

Если пробелы в имени всё же есть, в ссылке пишите их как `%20`:

```markdown
![Топология](Screen%20Shot.PNG)
```

## Управление размером

В Markdown нет параметра размера, поэтому при необходимости используйте обычный HTML-тег:

```markdown
<img src="assets/topology.png" alt="Топология сети" width="600">
```

## Ссылка на файл вместо его показа

Уберите восклицательный знак — получится ссылка на скачивание:

```markdown
[Файл Packet Tracer](main.pkt)
```

## Вложения в задачах

Во время написания задачи или комментария перетащите файл в текстовое поле. Он загрузится, и ссылка вставится сама. Используйте это для скриншотов и логов, которым не место в самом репозитории.

---

⬅ [Назад: 06 — Основы Markdown](../06-markdown-basics/readme.md) · 📚 [Содержание](../README.md) · [Далее: 08 — Коммиты и история](../08-commits-and-history/readme.md) ➡