Last modified by Eleni Cojocariu on 2026/10/02 09:11

Show last authors
1 To insert a link with the [[BlockNote editor>>xwiki:documentation.xs.user.base.page.edit.blocknote-editor.WebHome]]:
2
3 1. Select the text to turn into a link.
4 1. Click the link button of the formatting toolbar, or press ##Ctrl+K## (##Cmd+K## on macOS).(((
5 {{image reference="create-link-toolbar.png" size="large" alt="The formatting toolbar of the BlockNote editor with the Create link button highlighted"/}}
6 )))
7 1. Type the address of the target in the field of the popover. It accepts a URL as well as the reference of a Page or of an Attachment.(((
8 {{image reference="link-popover.png" size="large" alt="The link popover of the BlockNote editor, opened below the formatting toolbar, with its address field highlighted"/}}
9 )))
10 1. Press ##Enter##. The link appears in the content, ready to be followed once the Page is saved.(((
11 {{image reference="link-rendered.png" size="large" alt="A link inserted in the content of the BlockNote editor, shown inside the sentence it belongs to"/}}
12 )))
13
14 {{version since="18.7.0RC1"}}
15 The field suggests the Pages and the Attachments matching what you type, and a modal replaces the popover, offering a display text, a link type ("URL", "Page", "Attachment" or "E-mail") and options such as opening the link in a new tab. Its fields are listed in [[BlockNote Link Options>>xwiki:documentation.xs.user.base.page.edit.blocknote-editor.insert-link.options.WebHome]].
16 {{/version}}
17
18 {{version since="18.8.0RC1"}}
19 A link can also be inserted without selecting any text first: type ##/link## to open the "slash menu" and select "Link". The link modal opens with its display text field focused; fill in the display text and the target, then submit. The link replaces what you typed, at the cursor position.
20
21 {{image reference="slash-menu-link.png" size="medium" alt="The slash menu of the BlockNote editor with /link typed and the Link entry highlighted"/}}
22 {{/version}}

Get Connected