Skip to content

Internal Note links not working in User Guide #5631

@draperbr

Description

@draperbr

Description

Description

Internal note links within the User Guide are not functioning as expected. When hovering over these links in a browser, they display URLs in the format https://[my-server]/[relative-path-to-link], such as:

  • https://[my-server]/Advanced Usage/Attributes.html
  • https://[my-server]/Basic Concepts/Note/Read-Only Notes.html

Clicking these links results in no action—no navigation occurs, and no errors are visibly displayed in the UI. In contrast:

  • External links within the User Guide work correctly.
  • Internal links in my personal notes and the Trilium Demos function as expected, showing URLs in the format https://[my-server]/#root/[note-ID]/[note-ID], which successfully navigate to the intended notes.

This is a known issue due to the User Guide being a set of “fake” notes, so all the features need to be implemented separately from the main application, and this includes the links. 

Steps to Reproduce

  1. Open Trilium in a browser or desktop app.
  2. Navigate to the User Guide section (e.g., via F1, or the menu).
  3. Locate an internal link.  Examples:
    1. User Guide > Installation & Setup > Desktop Installation
      1. “TLS Certificates” link
      2. “data directory” link
      3. “Synchronization” Guide link
  4. Hover over the link to observe the URL in the browser’s status bar.
  5. Click the link.

Expected Behavior

Clicking an internal link in the User Guide should navigate to the corresponding section or note within Trilium, similar to how internal links work in personal notes or the Trilium Demos.

Actual Behavior

Nothing happens when clicking the internal links. The page does not change, and no error message appears in the UI.

Possible Workaround

Manually navigating to the intended section by searching for the note title in Trilium’s search bar works, but this defeats the purpose of the hyperlinks.

TriliumNext Version

0.92.4

What operating system are you using?

Ubuntu

What is your setup?

Local + server sync

Operating System Version

24.04 LTS

Error logs

Nothing found reported in logs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions