---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/support/wiki/en/static-markup/links.md
  - https://yandex.ru/support/wiki/ru/static-markup/links.md
title: "How to format links in Yandex\_Wiki"
description: "Follow this guide to format links in Yandex\_Wiki."
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/wiki/en/llms.txt


# Links in the old editor

{% note info "" %}

For information on how to work with links in the new editor, see [Formatting text](https://yandex.ru/support/wiki/en/wysiwyg/text-format.md#links-wysiwyg).

{% endnote %}

To design links, use the markup:

```
[<link_text>](<address>)
```

For example:

| Markup | Result |
--- | ---
| `[Yandex](https://yandex.com)` | [Yandex](https://yandex.com) |

If you paste an address with no markup, it will be converted into a hyperlink anyway:

| Markup | Result |
--- | ---
| `https://yandex.com` | [https://yandex.com](https://yandex.com) |

## Links to Wiki pages {#wiki-ref}

To link to a Wiki page, you can use that page's relative address instead of the full page or cluster address.

### Links to pages {#page-link}

- Specify the address relative to the Wiki homepage. Add the `/` symbol before the address.

   | Destination | Markup |
   --- | ---
   | `wiki.yandex.com/users/John/page` | `[John's notes](/users/John/page)` |

- Specify the address relative to the parent of the page where you are placing the link. Do not add `/` before the address.

   | Page URLs | Markup |
   --- | ---
   | Links from: `wiki.yandex.com/users/John/newpage`<br/><br/>Links to: `wiki.yandex.com/users/John/page` | `[John's notes](page)` |
   | Links from: `wiki.yandex.com/users/John/page/page1`<br/><br/>Links to: `wiki.yandex.com/users/John/newpage` | `[New page](../newpage)` |

### Links to clusters {#section-link}

Each page title automatically gets its own *anchor*, which is the cluster ID. Anchors are used for direct links to clusters on the page.

The anchor is generated from the name of a cluster. For example, a cluster named `My cluster` will be assigned the `my-section` anchor.

To add a link to a cluster, enter the page address followed by the `#` symbol and the anchor:

```
[<link_text>](/<page_address>/#m-mojjrazdel)
```

Find out the value of the cluster anchor:

1. Hover over the cluster title and click **§** that appears to the right of the title.

1. Copy the cluster address from the browser's address bar.

The anchor is shown after the `#` symbol at the end of the address.

### Link to any place on a page {#place-link}

If you want to link to a specific place on a page, you can always create an anchor ID wherever you need. To set an anchor, use the [`{{anchor}}` dynamic block](https://yandex.ru/support/wiki/en/actions/anchor.md):

```
{{anchor name="my-anchor"}}
```

To add a link to such an anchor, add it to the page address after the `#` symbol:

```
[link text](http://page URL/#my-anchor)
```

## Links to images {#ref-to-image}

If you paste an image link with no markup, the image itself will be displayed on the page.

To add a link to an image, use the link markup:

```
[<link_text>](<image_address>)
```

| Markup | Result |
--- | ---
| `[Yandex logo](http://img.yandex.net/i/logo95x37x8.png)` | [Yandex logo](http://img.yandex.net/i/logo95x37x8.png) |

## Turning an image into a link {#image-as-ref}

You can turn the image into a link so that clicking on it will open a page or file. To do this, [insert an image](https://yandex.ru/support/wiki/en/static-markup/files.md#add-image) in the link markup element instead of text:

```
[![<alternative_text>](<image_URL>)](<file_or_page_link>)
```

| Markup | Result |
--- | ---
| `[![Logo](http://img.yandex.net/i/logo95x37x8.png)](https://yandex.com)` | [![Logo](../_assets/logo95x37x8.png)](https://yandex.com) |


## Links to email addresses {#mail-ref}

To add a link to an email address:

- Enclose the email address in angle brackets (`< >`).

- Use the link markup. Add `mailto:` before the mail address.

   `[<link_text>](mailto:<email_address>)`

## Footnotes {#footnotes}

A footnote is a note to the text, usually found at the bottom of the page. To add a footnote to the page:

1. Add double square brackets, an <q>asterisk</q>, and a footnote symbol after the words covered by the footnote. You can use numbers and other symbols or just <q>asterisks</q> for your footnotes.

1. Add double square brackets, the `#` symbol, and the same footnote sign before the footnote text.

For example:

```
Text, then a footnote[[*]] and the second[[**]].

Text, then a digital footnote[[*1]] and the second[[*2]].

[[#*]] First footnote definition.
[[#**]] Second footnote definition.
[[#1]] First digital footnote definition.
[[#2]] Second digital footnote definition.
```