---
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: en/syntax/links.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
updatedAt: '2023-10-23T16:12:38.000Z'
---
> **Documentation Index:** Fetch the complete configuration index at https://3y3.dev/en/llms.txt

# Links

The standard markup for a link is:

```
[link_text](link "hint_text")
```

  * `link_text`: The link text.
  * `link`: A URL or path to a file.
  * `"hint_text"`: A hint that will be displayed when you hover over the link text. Optional.

Depending on the type of link, simplifications and other design options are allowed.

## Link to MD file {#autotitle}

You can create a link to an MD file without explicitly specifying the link text. To do this, add the symbols `{#T}` in place of the text, and they will automatically be substituted with the title of the specified file.

```markdown
[Syntax](./index.md)
```

**Result**

[Syntax](https://3y3.dev/en/syntax/index.md)


## Link to MD file section {#auto-section-title}

You can refere:

* To the section of the current page.

  `[text](#anchor)`

  **Result**

  [Link text style](#formatting)

* To a section of another page.

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

  **Result**

  [Headers](https://3y3.dev/en/syntax/base.md#headers)

## A URL or an email address {#url-email}

To convert a URL or an email address to a link, add angle brackets `<>` on both sides.

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

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

**Result**

<https://yandex.com/>

<alice.the.girl@yandex.com>

## Reference-style markup for links {#reference-style}

Use reference-style links to make the source text of a document easier to read. These links consist of two parts connected by tags:

* A brief link description in the text.

  `[link_text][link_tag]`

* A long URL placed in a special place at the end of a paragraph or document.

  `[link_tag]: URL`

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

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

**Result**

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

[1]: https://yandex.com/ "The best search engine"
## Link text style {#formatting}

You can apply [line formatting](https://3y3.dev/en/syntax/base.md#line) to the link text.

```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)).
```

**Result**

I love **[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 {#files}

If you need to specify a link to a file, you can use a special link with a file icon. After clicking on such a link, the browser will start downloading the specified file to the device.

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

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