Ссылки

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

[текст_ссылки](ссылка "текст_подсказки")
  • текст_ссылки — явное указание текста ссылки.
  • ссылка — 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

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