Настройка размера изображений в Markdown (ширина и высота)

Почему базовый синтаксис ![alt](url) не поддерживает размер

Классический синтаксис Джона Грубера ![Описание](image.png) намеренно минималистичен: в нем вообще нет параметров ширины или высоты. В результате при вставке скриншота высокого разрешения (Retina или 4K) картинка распахивается на всю ширину экрана или вовсе вылезает за границы печатной страницы PDF.

К счастью, спецификация CommonMark разрешает бесшовную интеграцию HTML-тегов прямо в тело Markdown-документа.

Изменить размер картинки markdown width: использование тега img

Самый надежный и кроссплатформенный способ, как изменить размер картинки markdown width — заменить стандартную скобочную запись на тег <img>:

Markdown

Панель настроек


Логотип проекта

Браузер и PDF-генераторы автоматически сохраняют пропорции изображения: если вы указали только width="450", высота пересчитается пропорционально без сплющивания.

Подгонка изображения md html: адаптивные проценты (width="50%")

Для адаптивных документов и мобильного чтения идеальна подгонка изображения md html через относительные единицы измерения:

Markdown

График

При таком подходе на смартфонах картинка красиво масштабируется, а на десктопе не растягивается до гигантских размытых размеров.

Центрирование иллюстраций и подрисуночные подписи

Чтобы выровнять уменьшенное изображение строго по центру страницы и добавить красивую подпись курсивом (по аналогии со стандартами оформления скриншотов программ в отчете ГОСТ):

Markdown

Архитектура сервиса
Рисунок 1 — Структурная схема микросервисов

Расширенный синтаксис в Obsidian, Kramdown и Labkeeper

В продвинутых редакторах поддерживается удобный компактный синтаксис пайпа: ![Скриншот|400](image.png) или фигурных скобок атрибутов: ![Скриншот](image.png){width=400px}, что делает документ идеально готовым к экспорту Markdown в PDF.

Практические советы

1

Векторный формат SVG

Для схем, графиков и логотипов используйте формат .svg: при любом значении width он сохраняет идеальную векторную четкость без пикселей.

2

Пустые строки вокруг HTML

Всегда отделяйте теги <p align="center"> и <img> пустыми строками от предшествующего и последующего Markdown-текста.

Попробуйте прямо сейчас

Оформляйте иллюстрированные заметки в Labkeeper

Онлайн-редактор Markdown с поддержкой ресайза изображений, вставкой скриншотов из буфера обмена и экспортом в PDF.

LaTeX editor screenshot
  • Полновесная компиляция: Получайте PDF профессионального качества с помощью встроенного LaTeX-компилятора.
  • 60 секунд на выполнение: Работайте со сложными документами без ограничений — лимит времени компиляции в разы выше, чем в аналогичных сервисах.
  • Умная конвертация: Любые вычислительные формулы автоматически преобразовываются в красивый LaTeX
  • Гибридный синтаксис: Используйте легковесные вставки Markdown прямо в сложном LaTeX-коде для ускорения работы.
bg

Другие статьи