Гиперссылки в Markdown

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

Основной синтаксис ссылок

Основной синтаксис для ссылки в Markdown:

[Текст ссылки](URL)

Примеры

[Google](https://www.google.com)

Результат: Google

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

Вы можете добавить заголовок к вашим ссылкам, который появляется при наведении курсора:

[Google](https://www.google.com "Поисковая система")

Результат: Google

Справочные ссылки

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

Это [справочная ссылка][1] и это [еще одна][github].

Вы также можете использовать [текст ссылки сам по себе] в качестве справочной.

[1]: https://www.google.com
[github]: https://github.com
[текст ссылки сам по себе]: /

Результат:

Это справочная ссылка и это еще одна.

Вы также можете использовать текст ссылки сам по себе в качестве справочной.

Автоматические ссылки

Markdown может автоматически создавать ссылки для URL и email адресов:

https://www.google.com
[email protected]

Результат:

• •
  https://www.google.com
• •
  [email protected]

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

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

Вы можете ссылаться на заголовки внутри того же документа:

[Перейти к основному синтаксису](#основной-синтаксис-ссылок)
[Перейти к примерам](#примеры)

Правила для ссылок на заголовки:

• •
  Конвертировать в нижний регистр
• •
  Заменить пробелы дефисами
• •
  Удалить специальные символы

Ссылки на другие страницы

[Гиперссылки в Markdown](/markdown-guide/hyperlink)

Результат: Гиперссылки в Markdown

Лучшие практики ссылок

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

❌ Не делайте так:

Нажмите [здесь](https://example.com), чтобы посетить наш сайт.
Читайте больше [здесь](https://example.com/blog).

✅ Делайте так:

Посетите наш [корпоративный сайт](https://example.com).
Прочитайте наш [последний пост в блоге](https://example.com/blog).

2. Сохраняйте краткость текста ссылки

❌ Слишком длинно:

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

✅ В самый раз:

[Посетите наш сайт](https://example.com)

3. Используйте справочные ссылки для читаемости

Когда у вас много ссылок, справочный стиль сохраняет читаемость контента:

Я люблю использовать [Markdown][md] для написания документации.
Он отлично работает с [GitHub][gh] и [GitLab][gl].
[md]: https://daringfireball.net/projects/markdown/
[gh]: https://github.com
[gl]: https://gitlab.com

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

Email ссылки

[Напишите мне](mailto:[email protected])
[Email с темой](mailto:[email protected]?subject=Привет)

Телефонные ссылки

[Позвоните нам](tel:+7-555-123-4567)

Советы по доступности

1. Указывайте внешние ссылки

Дайте пользователям знать, когда ссылки ведут на внешние сайты:

[Посетите Google](https://www.google.com) (внешняя ссылка)

2. Описывайте типы файлов

При ссылке на файлы упоминайте формат:

[Скачать отчет](report.pdf) (PDF, 2МБ)

Ссылки необходимы для соединения вашего контента с более широким вебом. Овладейте этими техниками, и ваши Markdown документы будут более привлекательными и полезными!

Хотите узнать о создании списков задач? Ознакомьтесь с нашим руководством по флажкам.