Медиа
Изображения
Важно
Изображения должны храниться в каталоге, имя которого начинается с символа _
, иначе они будут удалены при сборке.
Стандартная разметка для вставки изображения имеет вид:
![alt-текст](_images/image.png "текст_подсказки" =100x100)
-
alt-текст
— название изображения, задается автором. В сборке не отображается. -
_images/image.png
— URL или путь до файла изображения. -
"текст_подсказки"
— подсказка, которая будет отображаться при наведении на изображение. Необязательный параметр. -
=100x100
— размер изображения. Необязательный параметр.Совет
Если вы хотите сохранить оригинальное соотношение сторон изображения, укажите только его ширину:
=100x
.
Изображение-ссылка
Вы можете сделать изображение кликабельным, используя правила оформления ссылок. Для этого добавьте стандартную разметку изображения в ту часть, которая предназначена для указания текста ссылки.
[![An old rock in the desert](../../_images/mountain.jpg "Mountain" =100x200)](https://yandex.com/images/search?text=mountain)
Результат:
Reference-style разметка для изображений
Аналогично reference-style ссылкам, вы можете один раз объявить изображение в специальном месте, а в остальном документе обращаться к нему по метке. Это позволит использовать изображение несколько раз, не перегружая текст длинными URL или другими параметрами.
![An old rock in the desert][image1]
[image1]: ../../_images/mountain.jpg "Mountain"
Результат:
Видео
Чтобы добавить на страницу видео, используйте разметку:
@[название_видеохостинга](id_видео_или_ссылка_на_него)
Ознакомиться с вариантами оформления и перечнем доступных видеохостингов можно на странице плагина markdown-it-video.