Ссылки

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

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

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

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

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

[{#T}](./index.md)

Результат

Синтаксис

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

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

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

Предыдущая
Следующая