Шпаргалка по ссылкам и изображениям

Синтаксис ссылок

Встроенные ссылки

[Текст ссылки](https://www.markdownlang.com)
[Ссылка с заголовком](https://www.markdownlang.com "Заголовок ссылки")

Ссылки по ссылке

[Текст ссылки][ref]
[Текст ссылки][]

[ref]: https://www.markdownlang.com "Необязательный заголовок"
[Текст ссылки]: https://www.markdownlang.com

Автоссылки

<https://www.markdownlang.com>
<email@example.com>

Якорные ссылки

[Перейти к заголовку](#имя-заголовка)
[Наверх](#top)

Синтаксис изображений

Встроенные изображения

![Альтернативный текст](image.jpg)
![Альтернативный текст](image.jpg "Заголовок изображения")

Изображения по ссылке

![Альтернативный текст][img-ref]

[img-ref]: image.jpg "Необязательный заголовок"

Ссылки на изображения

[![Альтернативный текст](image.jpg)](https://www.markdownlang.com)

Указание размера

<img src="image.jpg" alt="Альтернативный текст" width="300" height="200">

Распространенные комбинации

Ссылка на изображение

[![Логотип проекта](logo.png)](https://github.com/user/repo)

Центрированное изображение

<div align="center">
  <img src="image.jpg" alt="Описание">
</div>

Изображения рядом

<img src="img1.jpg" width="48%"> <img src="img2.jpg" width="48%">

Лучшие практики

Тип	Рекомендация	Пример
Текст ссылки	Используйте описательный текст	✅ [Руководство пользователя]()
Текст ссылки	Избегайте "нажмите здесь"	❌ [Нажмите здесь]()
Файл изображения	Используйте относительный путь	✅ ./images/pic.jpg
Альтернативный текст	Описывайте содержимое изображения	✅ ![Скриншот интерфейса]()
Формат файла	Веб-дружественные форматы	✅ JPG, PNG, WebP

HTML-вывод

Markdown	HTML
[текст](url)	<a href="url">текст</a>
	<img src="img" alt="alt">
<url>	<a href="url">url</a>

Распространенные ошибки

❌ Неправильные примеры:
[Ссылка(https://www.markdownlang.com)     ← Отсутствует правая круглая скобка
![Изображение](image.jpg         ← Отсутствует правая круглая скобка
[ Ссылка ]( https://www.markdownlang.com ) ← Лишние пробелы

✅ Правильные примеры:
[Ссылка](https://www.markdownlang.com)
![Изображение](image.jpg)
[Ссылка](https://www.markdownlang.com)