Основы · Блог
Как вставить картинку в Markdown: файл, ссылка, размер
Картинка в Markdown — строка : файл рядом, ссылка из интернета, картинка-ссылка. Размер и выравнивание — через HTML, там где площадка разрешает.
# Как вставить картинку в Markdown: файл, ссылка, размер
Картинка в Markdown вставляется строкой : восклицательный знак говорит «показать содержимое», в квадратных скобках — описание, в круглых — путь к файлу или ссылка. Markdown — язык разметки, поэтому документ остаётся обычным текстом: изображение подтягивается при отрисовке — из папки рядом с файлом или из интернета. Ниже — каждый способ: файл рядом, ссылка, картинка-ссылка, размер и выравнивание — и почему картинка иногда не показывается.
<!-- СХЕМА (заявка дизайнеру): «Адрес картинки → строка в Markdown → что увидит читатель». Три ветки адреса: файл рядом (images/shema.png), ссылка из интернета (https://…), HTML-тег с шириной. Результат: отрисованная картинка в предпросмотре. Крупный текст, минимум деталей. -->
| Способ | Строка | Когда подходит |
|---|---|---|
| Файл рядом |  | README, документация, заметки: изображения едут вместе с документом |
| Ссылка из интернета |  | Картинка доступна по адресу на чужом сервере |
| Картинка-ссылка | [](images/full.png) | Обложка, превью, переход к полному размеру |
| HTML-тег | <img src="images/shema.png" width="400"> | Нужен размер или выравнивание, и площадка разрешает HTML |
Вставить картинку из файла рядом
Изображение из папки рядом вставляется относительным путём от файла документа: . Так живут вместе README проекта, заметки с иллюстрациями и документация. Файлы изображений принято складывать в подпапку — путь от документа до изображения по папкам и есть адрес в круглых скобках.
Скопируйте файл в папку документа до вставки строки — путь сразу окажется правильным, и предпросмотр покажет изображение с места. В ProsaMD предпросмотр показывает документ с форматированием: заголовки, списки и изображения из папки рядом; полный набор приёмов — в справочнике по картинкам.
В README на GitHub относительные пути работают, пока файл лежит в репозитории: перемещаете .md — переносите и папку images. Отправляете документ кому-то — присылайте архивом: один .md без папки изображений у получателя покажет текст с пустыми местами. Как открыть такой файл — в статье «Чем открыть файл .md на Windows».
Вставить картинку по ссылке
Изображение из интернета — тот же синтаксис с полным адресом: . Способ для скриншота, уже выложенного в облако, логотипа сайта, рисунка из задачи.
Ссылка только отсылает к чужому серверу: изображение удалили — в документе остался текст с пустым местом. Для документов, которые должны пережить годы, надёжнее файл рядом. На GitHub есть обратный приём: перетащите изображение прямо в поле комментария или описания задачи — GitHub зальёт её на свой CDN и подставит готовую ссылку в текст.
Сделать картинку ссылкой
Картинка-ссылка — это обычная ссылка, внутрь которой вложено изображение: [](images/full.png). Читатель видит компактное превью, щелчок открывает полный размер. Так делают обложки статей и «нажми, чтобы увеличить»: в тексте — миниатюра, по щелчку — оригинал.
<!-- СКРИН (заявка дизайнеру): ProsaMD, предпросмотр документа с двумя картинками — из папки рядом и по ссылке; светлая тема. Рядом — исходные строки ![]() из этого раздела. -->
Подписать изображение: alt-текст и нейросети
Описание в квадратных скобках — альтернативный текст: его читают программы для незрячих, он виден, пока рисунок не загрузился, и по нему нейросети понимают, что на изображении. Когда документация попадает в ответ ИИ-помощника, alt часто остаётся единственным источником, откуда модель узнаёт содержимое рисунка, — поэтому описание пишется содержательно: «Схема экспорта: из JSON в таблицу», а не «Картинка 1».
В кавычках после адреса можно добавить подсказку, всплывающую при наведении: .
Отдельной строки-подписи под рисунком в чистом Markdown нет: роль подписи выполняет alt или строка курсивом сразу под изображением.
Задать размер и выравнивание
В чистом Markdown у изображения нет размера: спецификация CommonMark не предусматривает атрибутов, и документ рисуется одинаково на любом рендере. Это защищает документ от «у меня всё разъехалось» — но когда схема крупная и должна стоять по центру, размеры нужны.
Там, где площадка разрешает HTML, изображение записывается тегом:
<img src="images/shema.png" width="400">По центру — тег оборачивается в абзац с выравниванием:
<p align="center">
<img src="images/shema.png" width="400">
</p>GitHub разрешает <img> с шириной в README и комментариях. Discord, Telegram и чат-боты HTML не отрисовывают — там изображение пойдёт как есть, размер остаётся заботой исходной картинки. Универсальный способ без HTML: уменьшить сам файл изображения. Шпаргалка по синтаксису — в справочнике Markdown.
<!-- ВИДЕО (заявка в конвейер записи, prosa-work#27, порт :1420): 15–60 с, без звука. Сценарий: в ProsaMD открыть документ с папкой images → вставить строку
→ предпросмотр показывает картинку; затем записать ту же картинку через <img> с width и показать выравнивание по центру. Кадры из реального приложения, светлая тема. -->
Если картинка не показывается
Чаще всего виноват путь: он считается от файла документа, а не от того места, откуда вы его писали. Дальше по списку — от частого к редкому.
Путь не доходит от документа до файла. Откройте предпросмотр и проверьте адрес в круглых скобках: от .md он должен дойти до файла по папкам. Изменили расположение документа — поправьте пути.
Пробелы и русские буквы в имени файла. Часть рендеров такой адрес не собирает: скриншот 1.png превращается в битую ссылку. Переименуйте файл латиницей или замените пробелы на %20.
Картинки нет рядом с документом. Документ прислали одним вложением без папки — показать рисунки не сможет ни одна программа: попросите архив вместе с папкой изображений.
Хотлинк-защита чужого сервера. Некоторые серверы не отдают изображение чужим страницам: в браузере оно открывается, в документе — нет. Скачайте и положите рядом с документом.
---
<!-- CTA-ПЛАШКА: «Открыть пример в ProsaMD» → https://prosamd.ru -->
Скачать ProsaMD — бесплатный редактор Markdown для Windows и Linux. Документ с изображениями открывается двойным щелчком: предпросмотр показывает и текст, и изображения из папки рядом.
Частые вопросы
Как вставить картинку в Markdown?
Строкой  с описанием в квадратных скобках и адресом в круглых. Файл рядом с документом записывается относительным путём (images/shema.png), картинка в интернете — полным адресом https://…
Как вставить картинку в Markdown по ссылке?
Напишите  — полный адрес из адресной строки браузера. Удалите файл с сервера — в документе останется пустое место; для долгих документов надёжнее хранить изображение рядом с .md.
Почему картинка в Markdown не отображается?
Чаще всего путь посчитан не от файла документа: проверьте адрес в круглых скобках от .md до файла по папкам. Затем — пробелы и русские буквы в имени файла и наличие папки изображений рядом. Сервер может показывать изображение только внутри своего сайта — тогда скачайте его и положите рядом с документом.
Как выровнять картинку по центру в Markdown?
В чистом Markdown выравнивания нет — используется HTML, если площадка его разрешает: абзац с тегом img и шириной width=400. В README на GitHub это работает; в чатах и мессенджерах HTML не отрисовывается.
Можно ли задать размер картинки в Markdown?
В синтаксисе  размера нет. Там, где разрешён HTML, изображение ставится тегом img с width — GitHub разрешает такой тег в README. В маркдауне без HTML — Discord, Telegram — изображение уменьшают заранее в графическом редакторе.
Попробуйте в ProsaMD
ProsaMD — бесплатный редактор и просмотрщик Markdown: открывает .md двойным нажатием и показывает заголовки, списки и таблицы как готовый документ. Бесплатно и открыто · установщик около 4 МБ · Windows и Linux