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

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

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

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

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

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

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

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

и в readme.md:

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

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

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

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

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

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

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

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

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

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

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

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

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

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