Рисунки

Назначение

Рисунки используются для вставки изображений в документ с автоматической сквозной нумерацией и возможностью сослаться на конкретный рисунок из любого места текста. Это касается фотографий, схем, скриншотов, графиков — любого растрового или векторного изображения, которое нужно показать в документе с подписью вида «Рисунок 4 — Схема установки».

Отдельно стоит отметить, что вставка рисунка в документ не обязательно требует загрузки файла на сторонний хостинг вручную: изображение можно вставить прямо из буфера обмена сочетанием клавиш ctrl + v — редактор сам загрузит картинку и подставит на её место рабочую ссылку.

Формат

Рисунок объявляется почти как обычное изображение в Markdown, но с двумя дополнениями — именем переменной и подписью в кавычках:

![ImageVariableName](http://address/image.png "Название рисунка")

Здесь ImageVariableName — это уникальная в пределах документа переменная, по которой на рисунок можно будет сослаться позже, а текст в кавычках — подпись, которая появится под рисунком в готовом Word-файле.

Ссылка в тексте

Чтобы упомянуть номер рисунка где-то ещё в тексте — например, во фразе «см. рисунок» — используется конструкция Liquid JS:

{{ ImageVariableName.index }}

При рендеринге вместо неё подставится актуальный номер рисунка, даже если до этого вы добавили или удалили другие рисунки выше по тексту.

TIP

Используйте осмысленные имена переменных, отражающие содержание рисунка, например SchemeSetup вместо Image1. Через полгода работы над документом такое имя будет гораздо понятнее и вам, и любому, кто продолжит текст.