From 22c4fba665567cb37f4fababebdbbc5cfb94a237 Mon Sep 17 00:00:00 2001
From: Elian Doran
Date: Thu, 27 Nov 2025 14:22:45 +0200
Subject: [PATCH] docs(user): improve documentation on tree keyboard shortcuts
---
.../Keyboard Shortcuts.html | 101 ++++++++----------
.../Note Tree/Keyboard shortcuts.html | 78 +++++++++-----
.../User Guide/Collections/List View.html | 13 ++-
.../Developer Guide/Documentation.md | 2 +-
docs/User Guide/!!!meta.json | 56 ++++++----
.../Keyboard Shortcuts.md | 69 +++++-------
.../Note Tree/Keyboard shortcuts.md | 47 +++++---
7 files changed, 195 insertions(+), 171 deletions(-)
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html
index a9c2d7c65..c50cd159a 100644
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html
+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.html
@@ -5,69 +5,50 @@
Keyboard shortcuts. Using global: prefix, you can assign a shortcut
which will work even without Trilium being in focus (requires app restart
to take effect).
+Tree
+See the corresponding section: Keyboard shortcuts
+
Note navigation
- ↑ , ↓ - go up/down in the
- list of notes, Ctrl + Shift + ↑ and Ctrl + Shift + ↓ work
- also from editor
- ← , → - collapse/expand node
- Alt + ← , Alt + → -
+ Alt + ← , Alt + → –
go back / forwards in the history
- Ctrl + J - show "Jump to" dialog
+ Ctrl + J – show "Jump to" dialog
- Ctrl + . - scroll to current note (useful when you
+ Ctrl + . – scroll to current note (useful when you
scroll away from your note or your focus is currently in the editor)
- Backspace - jumps to parent note
- Alt + C - collapse whole note tree
- Alt + - (alt with minus sign) - collapse subtree (if
- some subtree takes too much space on tree pane you can collapse it)
- you can define a label #keyboardShortcut with
- e.g. value Ctrl + I . Pressing this keyboard combination
- will then bring you to the note on which it is defined. Note that Trilium
- must be reloaded/restarted (Ctrl + R ) for changes to
- be in effect.
+ Backspace – jumps to parent note
+ Alt + C – collapse whole note tree
+ Alt + - (alt with minus sign) – collapse subtree (if
+ some subtree takes too much space on tree pane you can collapse it)
+ you can define a label #keyboardShortcut with
+ e.g. value Ctrl + I . Pressing this keyboard combination
+ will then bring you to the note on which it is defined. Note that Trilium
+ must be reloaded/restarted (Ctrl + R ) for changes to
+ be in effect.
See demo of some of these features in note navigation .
Tabs
- Ctrl + 🖱 Left click - (or middle mouse click) on note
+ Ctrl + 🖱 Left click – (or middle mouse click) on note
link opens note in a new tab
Only in desktop (electron build):
- Ctrl + T - opens empty tab
- Ctrl + W - closes active tab
- Ctrl + Tab - activates next tab
- Ctrl + Shift + Tab - activates previous tab
+ Ctrl + T – opens empty tab
+ Ctrl + W – closes active tab
+ Ctrl + Tab – activates next tab
+ Ctrl + Shift + Tab – activates previous tab
Creating notes
- CTRL+O - creates new note after the current note
- CTRL+P - creates new sub-note into current note
- F2 - edit prefix of current
- note clone
-
-Moving / cloning notes
-
- Ctrl + ↑ , Ctrl + ↓ -
- move note up/down in the note list
- Ctrl + ← - move note up in the note tree
- Ctrl +→ - move note down in the note
- tree
- Shift +↑ , Shift +↓ -
- multi-select note above/below
- Ctrl +A - select all notes in the current level
- Shift +🖱 Left click - multi select note which you
- clicked on
- Ctrl +C - copies current note (or current selection)
- into clipboard (used for cloning
-
- Ctrl +X - cuts current (or current selection) note
- into clipboard (used for moving notes)
- Ctrl +V - pastes note(s) as sub-note into current
- note (which is either move or clone depending on whether it was copied
- or cut into clipboard)
- Del - delete note / sub-tree
+ CTRL +O – creates new note after the current note
+ CTRL +P – creates new sub-note into current note
+ F2 – edit Branch prefix of
+ current note clone
Editing notes
@@ -77,30 +58,32 @@
class="reference-link" href="#root/_help_QrtTYPmdd1qq">Markdown-like formatting.
- Enter in tree pane switches from tree pane into note title.
+ Enter in tree pane switches from tree pane into note title.
Enter from note title switches focus to text editor. Ctrl +. switches
back from editor to tree pane.
- Ctrl +. - jump away from the editor to tree pane and
+ Ctrl +. – jump away from the editor to tree pane and
scroll to current note
Runtime shortcuts
These are hooked in Electron to be similar to native browser keyboard
shortcuts.
- F5 , Ctrl -R - reloads Trilium front-end
- Ctrl +Shift +I - show developer tools
- Ctrl +F - show search dialog
- Ctrl +- - zoom out
- Ctrl += - zoom in
+ F5 , Ctrl +R – reloads Trilium front-end
+ Ctrl +Shift +I – show developer tools
+ Ctrl +F – show search dialog
+ Ctrl +- – zoom out
+ Ctrl += – zoom in
Other
- Alt +O - show SQL console (use only if you know what
+ Alt + O – show SQL console (use only if you know what
you're doing)
- Alt +M - distraction-free mode - display only note
+ Alt + M – distraction-free mode - display only note
editor, everything else is hidden
- F11 - toggle full screen
- Ctrl + S - toggle search form
+ F11 – toggle full screen
+ Ctrl + S – toggle search form
in tree pane
- Alt +A - show note attributes dialog
+ Alt +A – show note attributes dialog
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html
index befdaae03..833792e85 100644
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html
+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.html
@@ -1,33 +1,53 @@
The Note Tree comes
with multiple keyboard shortcuts to make editing faster:
+Navigation within the tree
- Opening notes:
-
- Click to open the note in the current tab.
- Ctrl +Click or Middle click to open the note
- in a new tab.
- Ctrl +Right click to open the note in Quick edit .
-
-
- Navigation within the tree:
-
- Up and Down to navigate between notes.
- Left to collapse a note, or Right to expand it.
-
-
- Clipboard management:
-
- Ctrl +C to copy a note.
- Ctrl +X to cut a note.
- Ctrl +V to paste it somewhere.
-
-
- For Multiple selection :
-
- Alt +Click to add a single note to the current selection.
- Shift +Click to select a range of notes, starting
- from the current note (the highlighted one) to the one that is being clicked.
-
-
+ ↑ and ↑ to navigate between
+ notes.
+ ← to collapse a note with children, or → to
+ expand it.
+ ← on a note with no children to navigate to its
+ parent.
+
+Opening notes
+
+ Click to open the note in the current tab.
+ Ctrl +Click or Middle click to open the note
+ in a new tab.
+ Ctrl +Right click to open the note in Quick edit .
+
+Clipboard management
+
+ Ctrl +C to copy one or more notes based on selection
+ (see Cloning Notes ).
+ Ctrl +X to cut one or more notes (for moving them).
+ Ctrl +V to paste them somewhere (which results in
+ a copy or move based on the shortcut used).
+
+Moving notes
+
+ Ctrl + ↑ , Ctrl + ↓ -
+ move note up/down in the note list.
+ Ctrl + ← - move note up in the note tree.
+ Ctrl +→ - move note down in the note
+ tree.
+ Del - deletes note and optionally its subtree (asked in the
+ dialog).
+
+Multiple selection
+See Multiple selection for
+ more information about how selection works.
+
+ Alt +Click – add a single note to the current selection.
+ Shift +Click – select a range of notes, starting from
+ the current note (the highlighted one) to the one that is being clicked.
+ Shift +↑ , Shift +↓ –
+ multi-select not above/below.
+ Ctrl +A – select all notes in the current level
\ No newline at end of file
diff --git a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html
index 6ff3dc0a4..034f3c653 100644
--- a/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html
+++ b/apps/server/src/assets/doc_notes/en/User Guide/User Guide/Collections/List View.html
@@ -12,9 +12,9 @@
as a single continuous document.
Interaction
- Each note can be expanded or collapsed by clicking on the arrow to the
+ Each note can be expanded or collapsed by clicking on the arrow to the
left of the title.
- In the Ribbon ,
+ In the Ribbon ,
in the Collection tab there are options to expand and to collapse
all notes easily.
@@ -25,16 +25,15 @@
If exported to PDF within the desktop application, there is additional
functionality:
- The table of contents of the PDF will reflect the structure of the notes.
- Reference and inline links to other notes within the same hierarchy will
+ The table of contents of the PDF will reflect the structure of the notes.
+ Reference and inline links to other notes within the same hierarchy will
be functional (will jump to the corresponding page). If a link refers to
a note that is not in the printed hierarchy, it will be unlinked.
Expanding and collapsing multiple notes at once
Apart from individually expanding or collapsing notes, it's also possible
to expand or collapse them all at once. To do so, go to the Collection Properties tab
- in the Ribbon and
+ in the Ribbon and
look for the corresponding button.
By default, the Expand button will only expand the direct children
(first level) of the collection. Starting with v0.100.0, it's possible
@@ -45,7 +44,7 @@
By design, the UI provides only a handful of levels of depth for expanding
notes (direct children, 2-5, all levels). It's also possible to specify
- any desired depth by manually setting the corresponding label .
+ any desired depth by manually setting the corresponding label .
For example: #expanded=100 to expand up to 100 levels of depth.
diff --git a/docs/Developer Guide/Developer Guide/Documentation.md b/docs/Developer Guide/Developer Guide/Documentation.md
index 4092f4004..9fb14206e 100644
--- a/docs/Developer Guide/Developer Guide/Documentation.md
+++ b/docs/Developer Guide/Developer Guide/Documentation.md
@@ -1,5 +1,5 @@
# Documentation
-There are multiple types of documentation for Trilium:
+There are multiple types of documentation for Trilium:
* The _User Guide_ represents the user-facing documentation. This documentation can be browsed by users directly from within Trilium, by pressing F1 .
* The _Developer's Guide_ represents a set of Markdown documents that present the internals of Trilium, for developers.
diff --git a/docs/User Guide/!!!meta.json b/docs/User Guide/!!!meta.json
index 96ac8d3a1..2d8e47cb5 100644
--- a/docs/User Guide/!!!meta.json
+++ b/docs/User Guide/!!!meta.json
@@ -2380,13 +2380,6 @@
"isInheritable": false,
"position": 20
},
- {
- "type": "relation",
- "name": "internalLink",
- "value": "yTjUdsOi4CIE",
- "isInheritable": false,
- "position": 30
- },
{
"type": "label",
"name": "iconClass",
@@ -2400,6 +2393,20 @@
"value": "keyboard-shortcuts",
"isInheritable": false,
"position": 40
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "IakOLONlIfGI",
+ "isInheritable": false,
+ "position": 50
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "yTjUdsOi4CIE",
+ "isInheritable": false,
+ "position": 60
}
],
"format": "markdown",
@@ -5211,13 +5218,6 @@
"isInheritable": false,
"position": 20
},
- {
- "type": "relation",
- "name": "internalLink",
- "value": "IakOLONlIfGI",
- "isInheritable": false,
- "position": 30
- },
{
"type": "relation",
"name": "internalLink",
@@ -5259,6 +5259,20 @@
"value": "bx bxs-keyboard",
"isInheritable": false,
"position": 80
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "DvdZhoQZY9Yd",
+ "isInheritable": false,
+ "position": 90
+ },
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "TBwsyfadTA18",
+ "isInheritable": false,
+ "position": 100
}
],
"format": "markdown",
@@ -10576,6 +10590,13 @@
"isInheritable": false,
"position": 30
},
+ {
+ "type": "relation",
+ "name": "internalLink",
+ "value": "HI6GBBIduIgv",
+ "isInheritable": false,
+ "position": 40
+ },
{
"type": "label",
"name": "iconClass",
@@ -10589,13 +10610,6 @@
"value": "list",
"isInheritable": false,
"position": 30
- },
- {
- "type": "relation",
- "name": "internalLink",
- "value": "HI6GBBIduIgv",
- "isInheritable": false,
- "position": 40
}
],
"format": "markdown",
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.md b/docs/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.md
index 6b6ed97ca..13259152f 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/Keyboard Shortcuts.md
@@ -3,49 +3,38 @@ This is supposed to be a complete list of keyboard shortcuts. Note that some of
It is also possible to configure most keyboard shortcuts in Options -> Keyboard shortcuts. Using `global:` prefix, you can assign a shortcut which will work even without Trilium being in focus (requires app restart to take effect).
+## Tree
+
+See the corresponding section: Keyboard shortcuts
+
## Note navigation
-* ↑ , ↓ - go up/down in the list of notes, Ctrl + Shift + ↑ and Ctrl + Shift + ↓ work also from editor
-* ← , → - collapse/expand node
-* Alt + ← , Alt + → - go back / forwards in the history
-* Ctrl + J - show ["Jump to" dialog](Navigation/Note%20Navigation.md)
-* Ctrl + . - scroll to current note (useful when you scroll away from your note or your focus is currently in the editor)
-* Backspace - jumps to parent note
-* Alt + C - collapse whole note tree
-* Alt + - (alt with minus sign) - collapse subtree (if some subtree takes too much space on tree pane you can collapse it)
+* Alt + ← , Alt + → – go back / forwards in the history
+* Ctrl + J – show ["Jump to" dialog](Navigation/Note%20Navigation.md)
+* Ctrl + . – scroll to current note (useful when you scroll away from your note or your focus is currently in the editor)
+* Backspace – jumps to parent note
+* Alt + C – collapse whole note tree
+* Alt + - (alt with minus sign) – collapse subtree (if some subtree takes too much space on tree pane you can collapse it)
* you can define a [label](../Advanced%20Usage/Attributes.md) `#keyboardShortcut` with e.g. value Ctrl + I . Pressing this keyboard combination will then bring you to the note on which it is defined. Note that Trilium must be reloaded/restarted (Ctrl + R ) for changes to be in effect.
See demo of some of these features in [note navigation](Navigation/Note%20Navigation.md).
## Tabs
-* Ctrl + 🖱 Left click - (or middle mouse click) on note link opens note in a new tab
+* Ctrl + 🖱 Left click – (or middle mouse click) on note link opens note in a new tab
Only in desktop (electron build):
-* Ctrl + T - opens empty tab
-* Ctrl + W - closes active tab
-* Ctrl + Tab - activates next tab
-* Ctrl + Shift + Tab - activates previous tab
+* Ctrl + T – opens empty tab
+* Ctrl + W – closes active tab
+* Ctrl + Tab – activates next tab
+* Ctrl + Shift + Tab – activates previous tab
## Creating notes
-* `CTRL+O` - creates new note after the current note
-* `CTRL+P` - creates new sub-note into current note
-* `F2` - edit [prefix](Navigation/Note%20Navigation.md) of current note clone
-
-## Moving / cloning notes
-
-* Ctrl + ↑ , Ctrl + ↓ - move note up/down in the note list
-* Ctrl + ← - move note up in the note tree
-* Ctrl +→ - move note down in the note tree
-* Shift +↑ , Shift `+`↓ - multi-select note above/below
-* Ctrl +A - select all notes in the current level
-* Shift +🖱 Left click - multi select note which you clicked on
-* Ctrl +C - copies current note (or current selection) into clipboard (used for [cloning](Notes/Cloning%20Notes.md)
-* Ctrl +X - cuts current (or current selection) note into clipboard (used for moving notes)
-* Ctrl +V - pastes note(s) as sub-note into current note (which is either move or clone depending on whether it was copied or cut into clipboard)
-* Del - delete note / sub-tree
+* CTRL +O – creates new note after the current note
+* CTRL +P – creates new sub-note into current note
+* F2 – edit Branch prefix of current note clone
## Editing notes
@@ -53,22 +42,22 @@ Only in desktop (electron build):
> For keyboard shortcuts specific to Text notes, refer to Keyboard shortcuts and Markdown-like formatting .
* Enter in tree pane switches from tree pane into note title. Enter from note title switches focus to text editor. Ctrl +. switches back from editor to tree pane.
-* Ctrl +. - jump away from the editor to tree pane and scroll to current note
+* Ctrl +. – jump away from the editor to tree pane and scroll to current note
## Runtime shortcuts
These are hooked in Electron to be similar to native browser keyboard shortcuts.
-* F5 , Ctrl \-R - reloads Trilium front-end
-* Ctrl +Shift +I - show developer tools
-* Ctrl +F - show search dialog
-* Ctrl +- - zoom out
-* Ctrl += - zoom in
+* F5 , Ctrl +R – reloads Trilium front-end
+* Ctrl +Shift +I – show developer tools
+* Ctrl +F – show search dialog
+* Ctrl +- – zoom out
+* Ctrl += – zoom in
## Other
-* Alt +O - show SQL console (use only if you know what you're doing)
-* Alt +M - distraction-free mode - display only note editor, everything else is hidden
-* F11 - toggle full screen
-* Ctrl + S - toggle [search](Navigation/Search.md) form in tree pane
-* Alt +A - show note [attributes](../Advanced%20Usage/Attributes.md) dialog
\ No newline at end of file
+* Alt + O – show SQL console (use only if you know what you're doing)
+* Alt + M – distraction-free mode - display only note editor, everything else is hidden
+* F11 – toggle full screen
+* Ctrl + S – toggle [search](Navigation/Search.md) form in tree pane
+* Alt +A – show note [attributes](../Advanced%20Usage/Attributes.md) dialog
\ No newline at end of file
diff --git a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.md b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.md
index ffcb3fc0b..89e5e72c8 100644
--- a/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.md
+++ b/docs/User Guide/User Guide/Basic Concepts and Features/UI Elements/Note Tree/Keyboard shortcuts.md
@@ -1,17 +1,36 @@
# Keyboard shortcuts
The Note Tree comes with multiple keyboard shortcuts to make editing faster:
-* Opening notes:
- * Click to open the note in the current tab.
- * Ctrl +Click or Middle click to open the note in a new tab.
- * Ctrl +Right click to open the note in Quick edit .
-* Navigation within the tree:
- * Up and Down to navigate between notes.
- * Left to collapse a note, or Right to expand it.
-* Clipboard management:
- * Ctrl +C to copy a note.
- * Ctrl +X to cut a note.
- * Ctrl +V to paste it somewhere.
-* For Multiple selection :
- * Alt +Click to add a single note to the current selection.
- * Shift +Click to select a range of notes, starting from the current note (the highlighted one) to the one that is being clicked.
\ No newline at end of file
+## Navigation within the tree
+
+* ↑ and ↑ to navigate between notes.
+* ← to collapse a note with children, or → to expand it.
+* ← on a note with no children to navigate to its parent.
+
+## Opening notes
+
+* Click to open the note in the current tab.
+* Ctrl +Click or Middle click to open the note in a new tab.
+* Ctrl +Right click to open the note in Quick edit .
+
+## Clipboard management
+
+* Ctrl +C to copy one or more notes based on selection (see Cloning Notes ).
+* Ctrl +X to cut one or more notes (for moving them).
+* Ctrl +V to paste them somewhere (which results in a copy or move based on the shortcut used).
+
+## Moving notes
+
+* Ctrl + ↑ , Ctrl + ↓ - move note up/down in the note list.
+* Ctrl + ← - move note up in the note tree.
+* Ctrl +→ - move note down in the note tree.
+* Del - deletes note and optionally its subtree (asked in the dialog).
+
+## Multiple selection
+
+See Multiple selection for more information about how selection works.
+
+* Alt +Click – add a single note to the current selection.
+* Shift +Click – select a range of notes, starting from the current note (the highlighted one) to the one that is being clicked.
+* Shift +↑ , Shift +↓ – multi-select not above/below.
+* Ctrl +A – select all notes in the current level
\ No newline at end of file