Ссылки

Стандартная разметка для ссылки имеет вид:

[текст_ссылки](ссылка "текст_подсказки")

• текст_ссылки — явное указание текста ссылки.
• ссылка — URL или путь до файла.
• "текст_подсказки" — подсказка, которая будет отображаться при наведении на текст ссылки. Необязательный параметр.

В зависимости от вида ссылки допускаются упрощения и другие варианты оформления.

Ссылка на md-файл

Вы можете оформить ссылку на md-файл без явного указания текста ссылки. Для этого добавьте сочетание символов {#T} на место текста, и он подставится автоматически из заголовка указанного файла.

[Синтаксис](./index.md)

Результат

Синтаксис

Ссылка на раздел в md-файле

Вы можете сослаться:

• на раздел текущей страницы;

  [text](#anchor)

  Результат

  Начертание текста ссылки

• на раздел другой страницы.

  [text](base.md#anchor)

  Результат

  Заголовки

URL или адрес электронной почты

Чтобы преобразовать URL или адрес электронной почты в ссылку, добавьте с двух сторон угловые скобки <>.

<https://yandex.com/>

<alice.the.girl@yandex.com>

Результат

https://yandex.com/

alice.the.girl@yandex.com

Reference-style разметка для ссылок

Используйте reference-style ссылки, чтобы упростить восприятие исходного текста документа. Ссылки такого типа состоят из двух частей, связанных метками:

• краткое описание ссылки в тексте.

  [текст_ссылки][метка_ссылки]

• длинный URL, размещенный в специальном месте в конце параграфа или документа.

  [метка_ссылки]: URL

My favorite search engine is [Yandex][1].

[1]: https://yandex.com/ "The best search engine"

Результат

My favorite search engine is Yandex.

Начертание текста ссылки

К тексту ссылки можно применять строчное форматирование.

I love the **[Yandex Cloud](https://cloud.yandex.com)**.
This is the _[YFM Guide](https://yadocs.tech)_.
See the section on [`code`](#code).
Super [^men^](https://en.wikipedia.org/wiki/Major_Grom_(2017_film)).

Результат

I love the Yandex Cloud.
This is the YFM Guide.
See the section on code.
Super ^men.

Файлы

Чтобы выложить файлы для скачивания, загрузите их на внешнее хранилище.

Затем используйте ссылку на внешний источник как ссылку на файл. Можно воспользоваться специальной ссылкой с иконкой файла. После клика на такую ссылку браузер начнет скачивать указанный файл на устройство.

{% file src="data:text/plain;base64,Cg==" name="empty.txt" %}

empty.txt