Справочник

Картинки в Markdown: вставка, подписи, хранение

Картинка в маркдауне записывается одним приёмом — как ссылка, но с восклицательным знаком. Разбираем вставку по пути и по ссылке, подписи для программ чтения с экрана, картинки-ссылки и хранение изображений рядом с документом. Слева — окно режима «Код», справа — тот же документ в визуальном редакторе.

Как вставить картинку в Markdown полностью

Разметка изображения похожа на ссылку, только перед квадратными скобками стоит восклицательный знак. Общий вид: ![альтернативный текст](путь "подсказка"). В круглых скобках — путь к файлу: имя файла из папки документа, относительный путь с подпапками или полный адрес в интернете — тогда изображение вставляется по ссылке, и локальный файл не нужен.

Код
![Знак ProsaMD](znak.svg)

![Знак по ссылке](https://prosamd.ru/assets/img/prosamd-symbol.svg)
Визуальный редактор

Знак ProsaMD

Знак по ссылке

Картинка в документе ProsaMD: знак ProsaMD, вставленный по пути из папки
Картинка по относительному пути — ProsaMD показывает её в документе. Кадр из программы.

Пометка «полностью» — при сохранении ProsaMD не меняет ни путь, ни альтернативный текст, ни подсказку: разметка изображения остаётся в файле как записана.

Подпись к картинке: альтернативный текст и подсказка полностью

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

Код
![Знак ProsaMD](assets/znak.svg "Подсказка при наведении")
Визуальный редактор

Знак ProsaMD

Отдельной команды «текст под изображением» в разметке нет: если нужна подпись под изображением, её ставят обычным абзацем сразу после разметки изображения.

Картинка-ссылка полностью

Картинка становится ссылкой, если обернуть её разметку в ещё одну пару скобок — как обычную ссылку. Разметка сохраняется в файле как записана.

Код
[![Знак ProsaMD](assets/znak.svg)](https://prosamd.ru/)
Визуальный редактор

Знак ProsaMD

Картинки рядом с документом

Путь в круглых скобках отсчитывается от файла документа. Поэтому удобнее всего держать изображения в подпапке рядом с ним — например, assets/ — и писать относительный путь: папку с документом можно перенести или скопировать на другой компьютер, и картинки продолжат открываться.

Код
![Знак ProsaMD](assets/znak.svg)
Визуальный редактор

Знак ProsaMD

ProsaMD — редактор и просмотрщик Markdown — открывает такие изображения прямо в документе. Вставить изображение можно и из буфера обмена: скопируйте файл в Проводнике и нажмите Ctrl+V в документе — ProsaMD сохранит файл рядом с документом и запишет в разметку путь к нему.

Если картинка не нашлась

Битый путь — опечатка в имени, переименованный или удалённый файл — не ломает документ. ProsaMD показывает на месте изображения пунктирную коробку, а не «сломанный значок» браузера. Откройте режим «Код» и поправьте путь: например, в записи ![Знак](znakk.svg) достаточно исправить лишнюю букву — и картинка вернётся на место.

Дальше по справочнику: как устроены таблицы и что важно знать о блоках кода. Вся разметка на одной странице — шпаргалка по синтаксису; остальные статьи о разметке собраны в разделе Markdown.

Открыть пример в ProsaMD

Бесплатно и открыто · установщик около 4 МБ · Windows 10/11

Скачать ProsaMD