Освоєння форматування зображень у Markdown: синтаксис, вирівнювання, розміри та найкращі практики
Markdown став загальноприйнятим стандартом для технічного писання, документації розробників, репозиторіїв GitHub та блог-платформ, таких як Hugo, Jekyll, Gatsby та Next.js. Попри його простоту, однією з найпоширеніших проблем є ефективна робота із зображеннями.
Стандартний синтаксис зображень Markdown
У найпростішому вигляді вставка зображення вимагає спеціального синтаксису:

- Знак оклику (
!): Сигналізує парсеру, що елемент є зображенням, а не звичайним посиланням. - Квадратні дужки (
[...]): Містять альтернативний текст (alt text), критично важливий для скрінрідерів та SEO. - Круглі дужки (
(...)): Містять URL-адресу або відносний шлях до файлу зображення.
Обмеження стандартних зображень у Markdown
Хоча цей синтаксис підходить для базових завдань, він не дає змоги керувати стилями:
- Точні розміри: Встановлення ширини у пікселях або відсотках (наприклад,
width="600"). - Вирівнювання: Розміщення зображення по центру, ліворуч або праворуч.
- Підписи: Відображення відформатованих підписів під зображенням.
- Адаптивна поведінка: Встановлення атрибутів
loading="lazy"абоsrcset.
Альтернатива на HTML проти чистого коду
Щоб обійти ці обмеження, автори часто використовують HTML-теги:
<img src="https://example.com/image.png" alt="Descriptive Alt Text" width="600" align="center" />
За допомогою Utiliome Free Markdown Image Formatter ви можете миттєво перемикатися між чистим синтаксисом Markdown, оптимізованими тегами HTML та семантичними блоками <figure>. Інструмент автоматично очищає вхідні дані та форматує синтаксис під вимоги вашої платформи (GFM, CommonMark або MDX).