From 51bbf71577ef2911210198dffc411a29a6e5302d Mon Sep 17 00:00:00 2001 From: Chris Cavalluzzi Date: Sun, 14 Dec 2025 19:30:21 -0700 Subject: [PATCH 1/2] feat(docs): improve link docs organization --- .../User Guide/Note Types/Text/Links.html | 30 +-------- .../Links/1_Internal (reference) links.png | Bin 0 -> 178 bytes .../Note Types/Text/Links/External links.html | 25 +++---- .../Links/Internal (reference) links.html | 62 +++++++++++------- docs/User Guide/!!!meta.json | 22 +++++-- .../User Guide/Note Types/Text/Links.md | 16 +---- .../Links/1_Internal (reference) links.png | Bin 0 -> 178 bytes .../Text/Links/Internal (reference) links.md | 40 +++++++---- 8 files changed, 99 insertions(+), 96 deletions(-) create mode 100644 apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png create mode 100644 docs/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html index 52ab39530..6d9677e7d 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html @@ -1,34 +1,10 @@

There are two types of links:

-

Pasting links

- -

In-place linking

-

Trilium also provides "inline" linking - type @ and you'll - see an autocomplete, just type few characters from the desired note title, - press enter and you have a link.

Note map

-

Trilium provides a visualisation of incoming and outgoing links for a +

Trilium provides a visualization of incoming and outgoing links for a particular note. See note map for details.

\ No newline at end of file diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png new file mode 100644 index 0000000000000000000000000000000000000000..614c755b294448694effaf13a6327384ec2e97f3 GIT binary patch literal 178 zcmeAS@N?(olHy`uVBq!ia0vp^N

To create a link without a custom text:

To create a link with a custom text:

Once a link is inserted:

diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html index f4070a1b5..29b942c92 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html @@ -1,33 +1,51 @@ -

Unlike external notes, internal links (links to other notes) can be created - at the current position by :

+

Internal links are links to other notes within Trilium.

+

You can open an internal link by clicking it. You can also see a read-only + preview of an internal link's contents by hovering over it.

+

Inserting internal links

+

Internal links can be created at the current position in a text note by:

    -
  1. Pressing Ctrl + L or the +
  2. Pressing Ctrl + L or the button from the Formatting toolbar.
    3. -
  3. Filling in the desired note to link. It's also possible to create notes - from this dialog by typing a non-existing note title and selecting Create and link child note.
    4. + width="20" height="17">button underneath the + menu in the Formatting toolbar. +
  4. Searching for the title of the desired note to link. It's also possible + to create new notes from this dialog by typing a non-existing note title + and selecting Create and link child note.
-

There are two link types, adjustable when creating the link to the note:

+

There are two link types which you can select when creating the link to + the note:

    -
  1. link title mirrors the note's current title +
  2. Link title mirrors the note's current title
      -
    1. This is sometimes also called "reference link".
      2. -
    2. Title of such links cannot be changed, instead it is always mirroring - the title of linked note.
      3. -
    3. The icon of the note is also displayed.
      4. -
    4. The link title will automatically update if the title of the note is changed.
      5. +
    5. This is sometimes also called "reference link".
      6. +
    6. The title of these links cannot be changed. Instead, it will always show + the current title of linked note.
      7. +
    7. The icon of the linked note will also be displayed.
    3. -
  3. link title can be changed arbitrarily +
  4. Link title can be changed arbitrarily
      -
    1. This is the traditional hyperlink, where the text of the link can be different - to the note title.
      2. +
    2. This will create a traditional hyperlink, where the text of the link can + be different from the note title.
-

Once an internal link is created:

- \ No newline at end of file +

In-place linking

+

You can also insert internal links “inline” by using the @ symbol:

+
    +
  1. Type @ in a text note, which will open the + note search menu.
    2. +
  2. Search for the desired note's title by typing a few characters. Use Up and Down to + select the correct note, and press Enter or Tab to create + the link. It's also possible to create new notes with this method by typing + a non-existing note title and selecting Create and link child note.
    3. +
+

Pasting internal links

+

You can also insert internal links by copying a note from the note tree.

+
    +
  1. In the Note Tree, + select a note and press Ctrl + C.
    2. +
  2. In a text note, paste the link by pressing Ctrl + V.
    3. +
\ No newline at end of file diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json index d846c6d27..25e63f267 100644 --- a/docs/User Guide/!!!meta.json +++ b/docs/User Guide/!!!meta.json @@ -7621,13 +7621,6 @@ "isInheritable": false, "position": 20 }, - { - "type": "relation", - "name": "internalLink", - "value": "oPVyFC7WL2Lp", - "isInheritable": false, - "position": 30 - }, { "type": "relation", "name": "internalLink", @@ -7760,6 +7753,13 @@ "value": "reference-links", "isInheritable": false, "position": 30 + }, + { + "type": "relation", + "name": "internalLink", + "value": "oPVyFC7WL2Lp", + "isInheritable": false, + "position": 40 } ], "format": "markdown", @@ -7772,6 +7772,14 @@ "mime": "image/png", "position": 10, "dataFileName": "Internal (reference) links.png" + }, + { + "attachmentId": "VWmqBZtLxTJH", + "title": "image.png", + "role": "image", + "mime": "image/png", + "position": 10, + "dataFileName": "1_Internal (reference) links.png" } ] } diff --git a/docs/User Guide/User Guide/Note Types/Text/Links.md b/docs/User Guide/User Guide/Note Types/Text/Links.md index 93d9bfcc9..e4db27f4f 100644 --- a/docs/User Guide/User Guide/Note Types/Text/Links.md +++ b/docs/User Guide/User Guide/Note Types/Text/Links.md @@ -4,20 +4,6 @@ There are two types of links: * External links, for standard hyperlinks to websites or other resources. * Internal (reference) links for links to other notes within Trilium. -## Pasting links - -* For internal links (links to notes in Trilium), press Ctrl+C in the Note Tree: - * Pasting directly in a text note will create a reference link (with an icon to the note and the actual note title). - * Pasting over an existing text will create a traditional link. -* For external links: - * Paste the raw URL directly and press space to turn it into a link. - * Select a text and paste the URL over it to turn that text into a link. - * If you are pasting a formatted link (e.g. from the a webpage in a browser), simply paste it and it will keep the original text and URL. - -## In-place linking - -Trilium also provides "inline" linking - type `@` and you'll see an autocomplete, just type few characters from the desired note title, press enter and you have a link. - ## Note map -Trilium provides a visualisation of incoming and outgoing links for a particular note. See [note map](../../Advanced%20Usage/Note%20Map%20\(Link%20map%2C%20Tree%20map\).md) for details. \ No newline at end of file +Trilium provides a visualization of incoming and outgoing links for a particular note. See [note map](../../Advanced%20Usage/Note%20Map%20\(Link%20map%2C%20Tree%20map\).md) for details. \ No newline at end of file diff --git a/docs/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png b/docs/User Guide/User Guide/Note Types/Text/Links/1_Internal (reference) links.png new file mode 100644 index 0000000000000000000000000000000000000000..614c755b294448694effaf13a6327384ec2e97f3 GIT binary patch literal 178 zcmeAS@N?(olHy`uVBq!ia0vp^NCtrl + L or the button from the Formatting toolbar. -2. Filling in the desired note to link. It's also possible to create notes from this dialog by typing a non-existing note title and selecting _Create and link child note_. +You can open an internal link by clicking it. You can also see a read-only preview of an internal link's contents by hovering over it. -There are two link types, adjustable when creating the link to the note: +## Inserting internal links -1. _link title mirrors the note's current title_ +Internal links can be created at the current position in a text note by: + +1. Pressing Ctrl + L or the button underneath the menu in the Formatting toolbar. +2. Searching for the title of the desired note to link. It's also possible to create new notes from this dialog by typing a non-existing note title and selecting _Create and link child note_. + +There are two link types which you can select when creating the link to the note: + +1. _Link title mirrors the note's current title_ 1. This is sometimes also called "reference link". - 2. Title of such links cannot be changed, instead it is always mirroring the title of linked note. - 3. The icon of the note is also displayed. - 4. The link title will automatically update if the title of the note is changed. -2. _link title can be changed arbitrarily_ - 1. This is the traditional hyperlink, where the text of the link can be different to the note title. + 2. The title of these links cannot be changed. Instead, it will always show the current title of linked note. + 3. The icon of the linked note will also be displayed. +2. _Link title can be changed arbitrarily_ + 1. This will create a traditional hyperlink, where the text of the link can be different from the note title. -Once an internal link is created: +## In-place linking -* You can follow the note link by double clicking it. -* Alternatively if you only wish to quickly preview the content, you can hover over the link and will see read only preview. \ No newline at end of file +You can also insert internal links “inline” by using the `@` symbol: + +1. Type `@` in a text note, which will open the note search menu. +2. Search for the desired note's title by typing a few characters. Use Up and Down to select the correct note, and press Enter or Tab to create the link. It's also possible to create new notes with this method by typing a non-existing note title and selecting _Create and link child note_. + +## Pasting internal links + +You can also insert internal links by copying a note from the note tree. + +1. In the Note Tree, select a note and press Ctrl + C. +2. In a text note, paste the link by pressing Ctrl + V. \ No newline at end of file From 55649c3750ceaa0ca52ec2acf7e6f9cd3e09e9db Mon Sep 17 00:00:00 2001 From: Chris Cavalluzzi Date: Sun, 14 Dec 2025 21:17:59 -0700 Subject: [PATCH 2/2] fix(docs): mismatching phrasing in reference link notes --- .../User Guide/Note Types/Text/Links.html | 4 +-- .../Note Types/Text/Links/External links.html | 25 +++++++++--------- .../Links/Internal (reference) links.html | 26 +++++++++---------- docs/User Guide/!!!meta.json | 16 ++++++------ .../Text/Links/Internal (reference) links.md | 2 +- 5 files changed, 36 insertions(+), 37 deletions(-) diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html index 6d9677e7d..bde71988f 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links.html @@ -1,8 +1,8 @@

There are two types of links:

Note map

diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html index 07a6e7828..4bb65ae95 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/External links.html @@ -3,37 +3,36 @@ an external link to a Wikipedia page.

To create a link without a custom text:

    -
  • Press +
  • Press in the Formatting toolbar:
      -
    • A popup will appear, type or paste the URL in the box.
      • -
    • Press Enter or the check mark icon to confirm.
      • +
    • A popup will appear, type or paste the URL in the box.
      • +
    • Press Enter or the check mark icon to confirm.
    • -
  • Alternatively, press Ctrl+K to trigger the aforementioned +
  • Alternatively, press Ctrl+K to trigger the aforementioned popup.
    • -
  • A simpler way is to paste the raw link and press space to turn it automatically +
  • A simpler way is to paste the raw link and press space to turn it automatically into a link.

To create a link with a custom text:

    -
  • First, type and select the text which will be turned into a link.
    • -
  • Follow the previous steps to open the link interface (via the formatting +
  • First, type and select the text which will be turned into a link.
    • +
  • Follow the previous steps to open the link interface (via the formatting toolbar, or Ctrl+K).
    • -
  • Alternatively, simply paste (Ctrl+V) over the selected - text to turn it into a link.
    • +
  • Alternatively, simply paste (Ctrl+V) over the selected + text to turn it into a link.

Once a link is inserted:

    -
  • The text inside the link can be changed if needed but the link itself +
  • The text inside the link can be changed if needed but the link itself will remain.
    • -
  • To modify the link, click on the link to display the popup and press the +
  • To modify the link, click on the link to display the popup and press the Edit link button.
    • -
  • To remove a link, click on it and press the +
  • To remove a link, click on it and press the Unlink button.
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html index 29b942c92..3f481a4d7 100644 --- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html +++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.html @@ -4,30 +4,30 @@

Inserting internal links

Internal links can be created at the current position in a text note by:

    -
  1. Pressing Ctrl + L or the +
  2. Pressing Ctrl + L or the button underneath the menu in the Formatting toolbar.
  3. Searching for the title of the desired note to link. It's also possible + data-list-item-id="ec4d17a840f8ad96ad9a1344fae1b08aa">Searching for the title of the desired note to link. It's also possible to create new notes from this dialog by typing a non-existing note title and selecting Create and link child note.

There are two link types which you can select when creating the link to the note:

    -
  1. Link title mirrors the note's current title +
  2. Link title mirrors the note's current title
      -
    1. This is sometimes also called "reference link".
      2. -
    2. The title of these links cannot be changed. Instead, it will always show - the current title of linked note.
      3. -
    3. The icon of the linked note will also be displayed.
      4. +
    4. This is sometimes also called "reference link".
      5. +
    5. The title of this link cannot be changed. Instead, it will always show + the current title of the linked note.
      6. +
    6. The icon of the linked note will also be displayed.
    3. -
  3. Link title can be changed arbitrarily +
  4. Link title can be changed arbitrarily
      -
    1. This will create a traditional hyperlink, where the text of the link can +
    2. This will create a traditional hyperlink, where the text of the link can be different from the note title.
    5. @@ -35,9 +35,9 @@

    In-place linking

    You can also insert internal links “inline” by using the @ symbol:

      -
    1. Type @ in a text note, which will open the +
    2. Type @ in a text note, which will open the note search menu.
      3. -
    3. Search for the desired note's title by typing a few characters. Use Up and Down to +
    4. Search for the desired note's title by typing a few characters. Use Up and Down to select the correct note, and press Enter or Tab to create the link. It's also possible to create new notes with this method by typing a non-existing note title and selecting Create and link child note.
      5. @@ -45,7 +45,7 @@

      Pasting internal links

      You can also insert internal links by copying a note from the note tree.

        -
      1. In the Note Tree, +
      2. In the Note Tree, select a note and press Ctrl + C.
        3. -
      3. In a text note, paste the link by pressing Ctrl + V.
        4. +
      4. In a text note, paste the link by pressing Ctrl + V.
      \ No newline at end of file diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json index 25e63f267..bf60bb5bd 100644 --- a/docs/User Guide/!!!meta.json +++ b/docs/User Guide/!!!meta.json @@ -7626,7 +7626,7 @@ "name": "internalLink", "value": "BCkXAVs63Ttv", "isInheritable": false, - "position": 40 + "position": 30 }, { "type": "label", @@ -7740,6 +7740,13 @@ "isInheritable": false, "position": 10 }, + { + "type": "relation", + "name": "internalLink", + "value": "oPVyFC7WL2Lp", + "isInheritable": false, + "position": 20 + }, { "type": "label", "name": "iconClass", @@ -7753,13 +7760,6 @@ "value": "reference-links", "isInheritable": false, "position": 30 - }, - { - "type": "relation", - "name": "internalLink", - "value": "oPVyFC7WL2Lp", - "isInheritable": false, - "position": 40 } ], "format": "markdown", diff --git a/docs/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.md b/docs/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.md index 7188fa43a..fdefca194 100644 --- a/docs/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.md +++ b/docs/User Guide/User Guide/Note Types/Text/Links/Internal (reference) links.md @@ -14,7 +14,7 @@ There are two link types which you can select when creating the link to the note 1. _Link title mirrors the note's current title_ 1. This is sometimes also called "reference link". - 2. The title of these links cannot be changed. Instead, it will always show the current title of linked note. + 2. The title of this link cannot be changed. Instead, it will always show the current title of the linked note. 3. The icon of the linked note will also be displayed. 2. _Link title can be changed arbitrarily_ 1. This will create a traditional hyperlink, where the text of the link can be different from the note title.