---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://3y3.dev/en/syntax/links.md
  - https://3y3.dev/ru/syntax/links.md
  - href: ru/syntax/links.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2026-07-23T07:10:07.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/ru/llms.txt

# Ссылки

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

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

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

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

## Открытие в новой вкладке {#target}

По умолчанию, все относительные ссылки открываются в текущей вкладке браузера, все абсолютные ссылки – в новой вкладке. Можно переопределить это поведение с помощью атрибута `target`.

Примеры:

* `[текст](ссылка){target=_blank}` — будет открываться в новой вкладке,
* `[текст](ссылка){target=_self}` — будет открываться в текущей вкладке.

## Ссылка на md-файл {#autotitle}

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

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

**Результат**

[Синтаксис](https://3y3.dev/ru/syntax/index.md)

## Ссылка на раздел в md-файле {#auto-section-title}

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

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

  `[text](#anchor)`

  **Результат**
  
  [Начертание текста ссылки](#formatting)

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

  `[text](base.md#headers)`

  **Результат**

  [Заголовки](https://3y3.dev/ru/syntax/base.md#headers)

## Ограничение относительных путей в HTML {#constraints}

В HTML-ссылках используйте абсолютные пути от корня документации.

Пример:

```html
<a href="/root_folder/path_to_file">Ссылка</a>
```

## URL или адрес электронной почты {#url-email}

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

```markdown
<https://yandex.com/>

<alice.the.girl@yandex.com>
```

**Результат**

<https://yandex.com/>

<alice.the.girl@yandex.com>

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

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

* длинный URL, размещенный в специальном месте в конце параграфа или документа. 
  
  `[метка_ссылки]: URL`

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

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

**Результат**

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

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

## Начертание текста ссылки {#formatting}

К тексту ссылки можно применять [строчное форматирование](https://3y3.dev/ru/syntax/base.md#line).

```markdown
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](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)).

## Ссылки для скачивания файлов {#files}

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

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

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

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