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

Ссылки являются важными элементами в Markdown для связывания контента. Освоение различных синтаксисов ссылок делает ваши документы более связанными и практичными.

Базовый синтаксис ссылок

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

Создайте ссылку, используя формат [текст ссылки](URL):

Это ссылка на [Google](https://www.google.com).
Посетите [GitHub](https://github.com), чтобы увидеть проекты с открытым исходным кодом.

Результат:

Это ссылка на Google. Посетите GitHub, чтобы увидеть проекты с открытым исходным кодом.

Ссылки с заголовком

Добавьте заголовок после URL, который появляется при наведении:

Это [ссылка с заголовком](https://www.example.com "Это заголовок ссылки").

Результат:

Это ссылка с заголовком.

Ссылки в стиле ссылок

Базовые ссылки в стиле ссылок

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

Это [ссылка со ссылкой][1].
Это еще одна [ссылка со ссылкой][название-ссылки].

[1]: https://www.example.com
[название-ссылки]: https://www.google.com "Поиск Google"

Результат:

Это ссылка со ссылкой. Это еще одна ссылка со ссылкой.

Неявные метки ссылок

Текст ссылки используется в качестве метки:

Посетите [Google][], чтобы найти информацию.
Посмотрите проекты на [GitHub][].

[Google]: https://www.google.com
[GitHub]: https://github.com

Результат:

Посетите Google, чтобы найти информацию. Посмотрите проекты на GitHub.

Автоссылки

Автоссылки URL

Просто введите URL, обернутый в угловые скобки:

<https://www.example.com>
<https://github.com/user/repo>

Результат:

https://www.example.comhttps://github.com/user/repo

Автоссылки электронной почты

Свяжитесь со мной: <user@example.com>
Поддержка: <support@company.com>

Результат:

Свяжитесь со мной: user@example.com Поддержка: support@company.com

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

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

Ссылка на заголовок на той же странице:

Перейти к [Базовому синтаксису ссылок](#базовый-синтаксис-ссылок)
Смотрите [Лучшие практики](#лучшие-практики)

Результат:

Перейти к Базовому синтаксису ссылок Смотрите Лучшие практики

Ссылки с относительным путем

Ссылка на другие файлы:

Смотрите [Синтаксис заголовков](headings.md)
Вернуться на [Главную страницу](../index.md)

Специальные ссылки

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

Обернуть изображение в ссылку:

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

Ссылки для загрузки

Ссылка на файлы для загрузки:

Загрузить [Руководство пользователя](files/manual.pdf)
Получить [Пример кода](examples/demo.zip)

Форматирование текста ссылок

Форматированный текст ссылок

Это [**жирная ссылка**](https://www.example.com)
Это [*курсивная ссылка*](https://www.example.com)
Это [`ссылка в стиле кода`](https://www.example.com)

Результат:

Это жирная ссылка Это курсивная ссылка Это ссылка в стиле кода

Многострочный текст ссылки

Это [очень длинный текст ссылки,
который может потребовать переноса](https://www.example.com)

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

1. Несоответствующие скобки

❌ Ошибка:
[Текст ссылки(https://www.example.com)  ← Отсутствует правая скобка

✅ Правильно:
[Текст ссылки](https://www.example.com)

2. Проблемы с пробелами

❌ Ошибка:
[ Текст ссылки ]( https://www.example.com )  ← Лишние пробелы

✅ Правильно:
[Текст ссылки](https://www.example.com)

3. Кодирование URL

Для URL со специальными символами:

❌ Потенциальная проблема:
[Поиск](https://www.google.com/search?q=markdown)

✅ Безопаснее:
[Поиск](https://www.google.com/search?q=markdown)
Или использовать стиль ссылок:
[Поиск][google-поиск]

[google-поиск]: https://www.google.com/search?q=markdown

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

1. Использование описательного текста ссылок

✅ Рекомендуется: Описательный текст
Смотрите [Официальную документацию по синтаксису Markdown](https://daringfireball.net/projects/markdown/syntax)

❌ Не рекомендуется: Общий текст
Нажмите [здесь](https://daringfireball.net/projects/markdown/syntax), чтобы просмотреть документацию

2. Использование ссылок в стиле ссылок для длинных документов

✅ Рекомендуется: Использовать стиль ссылок для длинных документов
В нашем исследовании мы обратились к [работе Смита и др.][smith2020],
[теории Джонса][jones2019] и [последнему отраслевому отчету][industry2021].

[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-2021

3. Сохранение URL краткими

✅ Рекомендуется: Использовать короткие URL-адреса или пользовательские домены
[Домашняя страница проекта](https://myproject.com)

✅ Приемлемо: Использовать стиль ссылок для длинных URL
Смотрите наш [подробный аналитический отчет][подробный-отчет]

[подробный-отчет]: https://company.com/reports/2023/detailed-analysis-q4-performance-metrics