Build your personal knowledge base with Trilium Notes
TypeScript electronelectron-appknowledge-baseknowledge-graphknowledge-managementknowledge-management-graphlocal-firstnote-managmentnote-takernote-takingnotebooknotesnotes-apppersonal-knowledge-basepersonal-wikiscriptableself-hostedself-hostingwiki
{
"_help_BOCnjTMBCoxW": "<p>This section presents the most important changes by version. For a full set of changes, please consult the change log of each release. For purposes of brevity, beta versions are skipped and the features gathered to the nearest stable version.</p><ul><li>v0.105.0:<ul><li>Text notes now have a <a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a> for quick proof-reading and other text-based operations that don't require a full chat.</li></ul></li><li>v0.101.0:<ul><li>A new layout has been introduced, making significant modifications to the UI/UX such as integrating the ribbon and the floating buttons into other UI elements and introducing new functionality such as the <a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>.</li></ul></li><li>v0.97.0:<ul><li>Books are now <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> is a new collection type displaying notes and attributes in an editable grid.</li><li><a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> is introduced, adding a new way to edit notes in a popup instead of opening a new tab. It also integrates well with <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li></ul></li><li>v0.96.0:<ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> gain premium features thanks to a collaboration with the CKEditor team:<ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a></li></ul></li></ul></li><li>v0.95.0:<ul><li>A more friendly theme was introduced for <a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, with search, expandable tree, night mode and more.</li></ul></li><li>v0.94.0:<ul><li>Added integration with <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> (using self-hosted LLMs such as Ollama or industry standards such as ChatGPT).</li></ul></li><li>v0.92.5:<ul><li>Windows binaries are now signed.</li><li><a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-factor authentication with TOTP</a> was introduced.</li></ul></li><li>v0.92.4:<ul><li>macOS binaries are now signed.</li><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes can now have adjustable <a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language & Right-to-left support</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing & Exporting as PDF</a></li><li><a class=\"reference-link\" href=\"#root/_help_rC3pL2aptaRE\">Zen mode</a></li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>, allowing notes to be displayed in a monthly grid based on start and end dates.</li></ul></li><li>v0.91.5:<ul><li>Significant improvements for mobile.</li><li><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a> are now supported in <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</li><li>Mermaid diagrams can now be inserted inline within <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</li><li>The TriliumNext theme is introduced, bringing a more modern design to the application.</li><li><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, displaying notes as markers on a geographical map for easy trip planning.</li></ul></li><li>v0.90.8:<ul><li>A new note type was introduced: <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></li></ul></li></ul>",
"_help_poXkQfguuA0U": "<p>To install Trilium on your desktop, follow these steps:</p><ol><li><strong>Download the Latest Release</strong>: Obtain the appropriate binary release for your operating system from the <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">latest release page</a> on GitHub.</li><li><strong>Extract the Package</strong>: Unzip the downloaded package to a location of your choice.</li><li><strong>Run the Application</strong>: Launch Trilium by executing the <code>trilium</code> executable found within the unzipped folder.</li></ol><h2>Installing from Flathub</h2><p>On Linux, Trilium is also available on <a href=\"https://flathub.org/en/apps/org.triliumnotes.Trilium\">Flathub</a>, for both x86_64 and ARM (aarch64). Install it from your software center (e.g. GNOME Software or KDE Discover), or from a terminal:</p><pre><code class=\"language-text-x-sh\">flatpak install flathub org.triliumnotes.Trilium</code></pre><p>Updates arrive through the software center or <code>flatpak update</code>, like any other Flatpak.</p><p>The Flathub version runs in a sandbox and keeps its <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> in <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code>. It cannot see the data directory of a <code>.deb</code>, <code>.rpm</code>, AppImage or <code>.zip</code> installation (<code>~/.local/share/trilium-data</code>), so it starts with an empty database. To bring existing notes over:</p><ol><li><p>Close Trilium, in both the old installation and the Flatpak.</p></li><li><p>Copy the old data directory into the sandbox:</p><pre><code class=\"language-text-x-sh\">mkdir -p ~/.var/app/org.triliumnotes.Trilium/data\ncp -a ~/.local/share/trilium-data ~/.var/app/org.triliumnotes.Trilium/data/</code></pre></li><li><p>Start the Flatpak version.</p></li></ol><p>If <code>~/.var/app/org.triliumnotes.Trilium/data/trilium-data</code> already exists because the Flatpak version was started before, remove or rename it first.</p><p>The sandbox also hides the command-line tools that the <a href=\"#root/_help_eFhxp9laTW1S\">subscription-based AI providers</a> run (Claude Code, GitHub Copilot, OpenAI Codex, Google Antigravity); that page describes the permission that lets the Flatpak start them.</p><h2>Startup Scripts</h2><p>Trilium offers various startup scripts to customize your experience:</p><ul><li><code>trilium-no-cert-check</code>: Starts Trilium without validating <a href=\"#root/_help_l2VkvOwUNfZj\">TLS certificates</a>, useful if connecting to a server with a self-signed certificate.<ul><li>Alternatively, set the <code>NODE_TLS_REJECT_UNAUTHORIZED=0</code> environment variable before starting Trilium.</li></ul></li><li><code>trilium-portable</code>: Launches Trilium in portable mode, where the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> is created within the application's directory, making it easy to move the entire setup. Electron's internal data (caches, dictionaries, etc.) is also stored within the data directory, so no files are written to the system's roaming profile.</li><li><code>trilium-safe-mode</code>: Boots Trilium in \"safe mode,\" disabling any startup scripts that might cause the application to crash.</li></ul><h2>Synchronization</h2><p>For Trilium desktop users who wish to synchronize their data with a server instance, refer to the <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> guide for detailed instructions.</p>",
"_help_nRqcgfTb97uV": "<p>Sometimes, setting up a <a href=\"#root/_help_WOcw2SLH6tbX\">dedicated server installation</a> is not feasible. The desktop application ships with a fully functional server instance by default.</p><p>For security reasons, this feature is <strong>not enabled</strong> by default. To enable it, enable <em>Network access</em> in <a class=\"reference-link\" href=\"#root/_help_fiHicjpHjIRJ\">Security</a>.</p><p>After enabling network access and restarting the application, you can access this web interface locally by navigating to <a href=\"http://localhost:37840/login\">http://localhost:37840/login</a>.</p><aside class=\"admonition note\"><p>The server embedded in the desktop application will only run as long as the desktop application itself is running. So closing the application will also close the server. To overcome this, you can try hiding the application in the system tray.</p></aside><h2>Mobile interface</h2><p>By default, this will display the desktop user interface, even on mobile. To switch to the mobile version, simply go to the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> and select “Switch to the mobile version”.</p><h2>Allowing the port externally on Windows with Windows Defender Firewall</h2><p>First, find out the IP of your desktop server by running <code>ipconfig</code> in your local terminal. Then try accessing <code>http://<ip>:37840/login</code> on another device. If it doesn't work, then most likely the port is blocked by your operating system's firewall.</p><p>If you use Windows Defender Firewall:</p><ol><li>Go to Windows's start menu and look for “Windows Defender Firewall with Advanced Security”.</li><li>Go to “Inbound Rules” on the left tree, and select “New Rule” in the “Actions” sidebar on the right.</li><li>Select “Port” and press “Next”.</li><li>Type in <code>37840</code> in the “Specific local ports” section and then press “Next”.</li><li>Leave “Allow the connection” checked and press “Next”.</li><li>Configure the networks to apply to (check all if unsure) and then press “Next”.</li><li>Add an appropriate name to the rule (e.g. “Trilium Notes”) and press “Finish”.</li></ol><aside class=\"admonition warning\"><p>Since v0.104.0, the port used by Trilium is accessible only on <code>localhost</code>. To enable across the local network, see <a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a>.</p></aside>",
"_help_Rp0q8bSP6Ayl": "<p>The desktop version of Trilium supports all three main operating systems:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span> Windows</p><div class=\"trilium-tab-panel\"><ul><li>Windows 11 is officially supported.</li><li>Windows on ARM is also supported</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span> Linux</p><div class=\"trilium-tab-panel\"><ul><li>Most modern distributions are supported, including NixOS.</li><li>ARM is supported in <code>aarch64</code> (no ARM v7 support).</li></ul></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span> macOS</p><div class=\"trilium-tab-panel\"><ul><li>Minimum supported operating system: macOS Ventura</li><li>Both Intel and Apple Silicon devices are supported.</li></ul></div></section></div>",
"_help_Un4wj2Mak2Ky": "<p>Since TriliumNext 0.94.1, the desktop and server applications can be built using <a href=\"https://nixos.org/\">Nix</a>.</p><h2>System requirements</h2><p>Installation of Nix on Mac or Linux (<a href=\"https://nixos.org/download/\">download page</a>). About 3-4 gigabytes of additional storage space, for build artifacts.</p><h2>Run directly</h2><p>Using <a href=\"https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html\">nix run</a>, the desktop app can be started as: <code>nix run github:TriliumNext/Trilium/v0.95.0</code></p><p>Running the server requires explicitly specifying the desired package: <code>nix run github:TriliumNext/Trilium/v0.95.0#server</code></p><p>Instead of a version (<code>v0.95.0</code> above), you can also specify a commit hash (or a branch name). This makes it easy to test development builds.</p><h2>Install on NixOS</h2><p>Add to your <code>flake.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">{\n inputs = {\n nixpkgs.url = # ...;\n trilium-notes = {\n url = \"github:TriliumNext/Trilium/v0.95.0\";\n inputs.nixpkgs.follows = \"nixpkgs\";\n };\n };\n\n outputs =\n {\n self,\n # ...\n trilium-notes,\n ...\n }:\n {\n nixosConfigurations = {\n \"nixos\" = nixpkgs.lib.nixosSystem {\n system = \"x86_64-linux\";\n modules = [\n ./configuration.nix\n ];\n specialArgs = {\n inherit\n trilium-notes\n ;\n };\n };\n };\n };\n}\n</code></pre><p>Add to your <code>configuration.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">{\n # ...\n trilium-notes,\n ...\n}:\n\n{\n # ...\n\n services.trilium-server.package = trilium-notes.packages.x86_64-linux.server;\n\n environment.systemPackages = [\n trilium-notes.packages.x86_64-linux.desktop\n ];\n}</code></pre><p>The flake aims to be compatible with the latest NixOS stable and unstable.</p>",
"_help_swSFivWk6KkA": "<p>Prior to v0.104.0, the <a href=\"#root/_help_poXkQfguuA0U\">desktop application</a> would also open a network port so that it can offer access to <a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a> or even use it as a web server (see <a class=\"reference-link\" href=\"#root/_help_nRqcgfTb97uV\">Using the desktop application as a server</a>).</p><p>In order to reduce the attack surface, Trilium now enables these services only for the local device (e.g. <code>localhost</code>) instead of serving them over the LAN.</p><p>To better understand what is affected, refer to the following table:</p><figure class=\"table\"><table><thead><tr><th>Feature</th><th>Network access OFF</th><th>Network access ON</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a></td><td>🔒️ <code>localhost</code> only (still accessible to the browser extension on the same device)</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a></td><td>🔒️ <code>localhost</code> only</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a href=\"#root/_help_GBBMSlVSOIGP\">LLM MCP</a> (only if enabled in settings)</td><td>🔒️ <code>localhost</code> only (needs auth)</td><td>🌐 <code>localhost</code> + LAN (needs auth)</td></tr><tr><td><a href=\"#root/_help_nRqcgfTb97uV\">Web app</a></td><td>❌️ completely disabled (403), only the desktop app is usable.</td><td>🌐 <code>localhost</code> + LAN</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a> notes</td><td>❌️ completely disabled (403), if you are using <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> this will still work as part of the <a href=\"#root/_help_WOcw2SLH6tbX\">server</a>.</td><td>🌐 <code>localhost</code> + LAN</td></tr></tbody></table></figure>",
"_help_7iwde4lsKc6O": "<aside class=\"admonition note\"><p>Automatic startup and better integration with the system tray was introduced in v0.104.0. Versions prior to that only have the system tray option which could be found in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Others</em>.</p></aside><h2>Tray icon</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:332/71;\" src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Desktop%20Installation/Tray%20icon%20%26%20automatic%20startup_image.png\" width=\"332\" height=\"71\"></figure><p>The desktop application has native integration with the system tray on all operating systems.</p><p>The tray icon is enabled by default, but it can be toggled from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Desktop</em>.</p><p>The tray icon has the following functionality:</p><ul><li>When clicked, the last window is hidden (minimized to the tray icon). Clicking it again will reveal that window.</li><li>Right clicking reveals the following options:<ul><li>Each window can be individually shown or hidden, identified by their active note.</li><li>New windows can be opened.</li><li>A new note can be created directly, which will be created in the <a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a> (or <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a> if an inbox is not available).</li><li>Today's day note can be opened.</li><li>Bookmarks and recent notes are displayed in a sub-menu and clicking them navigates to that note.</li><li>Quitting the application.</li></ul></li></ul><h3>Opening a new window from the taskbar</h3><p>A new window can also be opened without the tray icon, by right-clicking the application's icon:</p><ul><li>On Windows, in the taskbar, select <em>Open New Window</em>.</li><li>On Linux, in the dock or application launcher (such as GNOME's or KDE's), select <em>New Window</em>.</li></ul><h3>Closing to system tray</h3><p>This is an option which is not enabled by default and it allows a specific behavior: instead of exiting the application when the last window has been closed, the last window is instead hidden with the tray icon remaining available.</p><p>This option requires the tray icon to be enabled, otherwise it has no effect.</p><h2>Automatic startup</h2><p>Two options control the automatic startup functionality in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Startup</em>:</p><ul><li>When <em>Launch on startup</em> is enabled, the application will automatically start up when logging into the current user.<ul><li>Note that on Linux support depends on the desktop environment. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report</a> any issues.</li></ul></li><li>If <em>Start minimized to tray</em> is also enabled, the application will start up in the background and can be revealed from the tray icon.<ul><li>This only applies if <em>Launch on startup</em> is enabled, manual starts are not impacted by this option.</li></ul></li></ul><h3>Linux: Flatpak</h3><p>The Flatpak cannot write to the autostart directory itself, so <em>Launch on startup</em> asks the desktop's Background portal instead, which creates <code>~/.config/autostart/org.triliumnotes.Trilium.desktop</code>. If the desktop environment is set to ask before letting applications run in the background, it shows a prompt the first time; denying it leaves <em>Launch on startup</em> without effect, and the permission can be changed later from the system settings.</p><h3>Linux: custom launch command for packagers</h3><p>On Linux, <em>Launch on startup</em> writes a <code>trilium.desktop</code> entry to the user's autostart directory (<code>$XDG_CONFIG_HOME/autostart</code>, usually <code>~/.config/autostart</code>). Its <code>Exec</code> line points to the AppImage when running from one, or to the running executable otherwise.</p><p>Distribution packages that run Trilium on a system-wide Electron (for example <code>electron /usr/lib/trilium/app.asar</code>) cannot rely on the running executable, since it is the bare Electron binary, which starts without Trilium. Such packages can set the <code>TRILIUM_LAUNCH_EXEC</code> environment variable, typically in their wrapper script, to the full command that starts Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_LAUNCH_EXEC='electron \"/usr/lib/trilium/app.asar\"'</code></pre><p>The value is written to the <code>Exec</code> line as-is, so any paths containing spaces must already be quoted. When <em>Start minimized to tray</em> is enabled, <code>--start-hidden</code> is appended to it. <code>TRILIUM_LAUNCH_EXEC</code> takes precedence over both the AppImage path and the running executable.</p>",
"_help_hvRfsDr591WP": "<h2>Trilium only shows a blank window</h2><p>Trilium uses Electron which is based on Chromium (the open-source alternative to Google Chrome); in order to improve performance it makes use of <em>GPU acceleration</em>. In some cases, a GPU incompatibility (especially on older models of integrated graphics) can cause nothing to render at all, resulting in a blank window. </p><p>To bypass this, try running Trilium with the following command line argument:</p><pre><code class=\"language-text-x-trilium-auto\">trilium --disable-gpu</code></pre><p>If that doesn't work, try the following commands as well:</p><ul><li><code>trilium --disable-gpu-compositing</code></li><li><code>ELECTRON_OZONE_PLATFORM_HINT=x11 trilium</code> (this one forces the rendering to X11 on Wayland)</li></ul><p>If Trilium renders fine after this, Trilium offers a built-in option to disable GPU acceleration: go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em>, look for the <em>Performance</em> section and then uncheck <em>Hardware acceleration (GPU)</em>.</p>",
"_help_WOcw2SLH6tbX": "<p>This guide outlines the steps to install Trilium on your own server. You might consider this option if you want to set up <a href=\"#root/_help_cbkrhQjrkKrh\">synchronization</a> or use Trilium in a browser - accessible from anywhere.</p><h2>Installation Options</h2><p>There are several ways to install Trilium on a server, each with its own advantages:</p><ul><li><strong>Recommended</strong>: <a href=\"#root/_help_rWX5eY045zbE\">Docker Installation</a> - Available for <strong>AMD64</strong> and <strong>ARM</strong> architectures.</li><li><a href=\"#root/_help_3tW6mORuTHnB\">Packaged Server Installation</a></li><li><a href=\"https://www.pikapods.com/pods?run=trilium-next\">PikaPods managed hosting</a></li><li><a href=\"#root/_help_J1Bb6lVlwU5T\">Manual Installation</a></li><li><a href=\"#root/_help_DCmT6e7clMoP\">Kubernetes</a></li><li><a href=\"https://www.cloudron.io/store/com.github.trilium.cloudronapp.html\">Cloudron</a></li><li><a href=\"https://homelabos.com/docs/software/trilium/\">HomelabOS</a></li><li><a href=\"#root/_help_moVgBcoxE3EK\">NixOS Module</a></li></ul><p>The server installation includes both web and <a href=\"#root/_help_RDslemsQ6gCp\">mobile frontends</a>.</p><h2>Configuration</h2><p>After setting up your server installation, you may want to configure settings such as the port or enable <a href=\"#root/_help_l2VkvOwUNfZj\">TLS</a>. Configuration is managed via the Trilium <code>config.ini</code> file, which is located in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> by default. To begin customizing your setup, copy the provided <code>config-sample.ini</code> file with default values to <code>config.ini</code>.</p><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead.</p><h3>Config Location</h3><p>By default, <code>config.ini</code>, the <a href=\"#root/_help_wX4HbRucYSDD\">database</a>, and other important Trilium data files are stored in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>. If you prefer a different location, you can change it by setting the <code>TRILIUM_DATA_DIR</code> environment variable:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre><h3>Disabling Authentication</h3><p>See <a class=\"reference-link\" href=\"#root/_help_0hzsNCP31IAB\">Authentication</a>.</p><h2>Reverse Proxy Setup</h2><p>To configure a reverse proxy for Trilium, you can use either <strong>nginx</strong> or <strong>Apache</strong>. You can also check out the documentation stored in the Reverse proxy folder.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">nginx</p><div class=\"trilium-tab-panel\"><p>Add the following configuration to your <code>nginx</code> setup to proxy requests to Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">location /trilium/ {\n proxy_pass http://127.0.0.1:8080/;\n proxy_http_version 1.1;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection 'upgrade';\n proxy_set_header Host $host;\n proxy_cache_bypass $http_upgrade;\n}</code></pre><p>To avoid limiting the size of payloads, include this in the <code>server {}</code> block:</p><pre><code class=\"language-text-x-trilium-auto\"># Set to 0 for unlimited. Default is 1M.\nclient_max_body_size 0;</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Apache</p><div class=\"trilium-tab-panel\"><p>For an Apache setup, refer to the <a class=\"reference-link\" href=\"#root/_help_fDLvzOx29Pfg\">Apache using Docker</a> guide.</p></div></section></div>",
"_help_3tW6mORuTHnB": "<p>This is essentially Trilium sources + node modules + node.js runtime packaged into one 7z file.</p><h2>Steps</h2><ul><li>SSH into your server</li><li>use <code>wget</code> (or <code>curl</code>) to download latest <code>TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code> (copy link from <a href=\"https://github.com/TriliumNext/Trilium/releases\">release page</a>, notice <code>-Server</code> suffix) on your server.</li><li>unpack the archive, e.g. using <code>tar -xf -d TriliumNotes-Server-[VERSION]-linux-x64.tar.xz</code></li><li><code>cd trilium-linux-x64-server</code></li><li><code>./trilium.sh</code></li><li>you can open the browser and open http://[your-server-hostname]:8080 and you should see Trilium initialization page</li><li>the console lists the addresses the server can be reached on, so you can also copy one from there</li></ul><p>The problem with above steps is that once you close the SSH connection, the Trilium process is terminated. To avoid that, you have two options:</p><ul><li>Kill it (with e.g. <kbd>Ctrl</kbd> + <kbd>C</kbd>) and run again like this: <code>nohup ./trilium.sh &</code>. (nohup keeps the process running in the background, <code>&</code> runs it in the background)</li><li>Configure systemd to automatically run Trilium in the background on every boot</li></ul><h2>Configure Trilium to auto-run on boot with systemd</h2><ul><li>After downloading, extract and move Trilium:</li></ul><pre><code class=\"language-text-x-trilium-auto\">tar -xvf TriliumNotes-Server-[VERSION]-linux-x64.tar.xz\nsudo mv trilium-linux-x64-server /opt/trilium</code></pre><ul><li>Create the service:</li></ul><pre><code class=\"language-text-x-trilium-auto\">sudo nano /etc/systemd/system/trilium.service</code></pre><ul><li>Paste this into the file (replace the user and group as needed):</li></ul><pre><code class=\"language-text-x-trilium-auto\">[Unit]\nDescription=Trilium Daemon\nAfter=syslog.target network.target\n\n[Service]\nUser=xxx\nGroup=xxx\nType=simple\nExecStart=/opt/trilium/trilium.sh\nWorkingDirectory=/opt/trilium/\n\nTimeoutStopSec=20\n# KillMode=process leads to error, according to https://www.freedesktop.org/software/systemd/man/systemd.kill.html\nRestart=always\n\n[Install]\nWantedBy=multi-user.target</code></pre><ul><li>Save the file (CTRL-S) and exit (CTRL-X)</li><li>Enable and launch the service:</li></ul><pre><code class=\"language-text-x-trilium-auto\">sudo systemctl enable --now -q trilium</code></pre><ul><li>You can now open a browser to http://[your-server-hostname]:8080 and you should see the Trilium initialization page.</li></ul><h2>Simple auto-update for Server</h2><p>The script is available in <a class=\"reference-link\" href=\"#root/_help_ZNAjFcxqHr9V\">Simple auto-update for server</a>.</p><ul><li><p>Run as the same User Trilium runs.</p><ul><li>If you run as <code>root</code> please remove <code>sudo</code> from the commands.</li></ul></li><li><p>Requires <code>jq</code>:</p><pre><code class=\"language-text-x-sh\">apt install jq</code></pre></li></ul><p>It will stop the service above, overwrite everything (expecting no <code>config.ini</code>), and start service. It also creates a version file in the Trilium directory so it updates only with a newer version.</p><h2>Common issues</h2><h3>Outdated glibc</h3><pre><code class=\"language-text-x-trilium-auto\">Error: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by /var/www/virtual/.../node_modules/@mlink/scrypt/build/Release/scrypt.node)\n at Object.Module._extensions..node (module.js:681:18)\n at Module.load (module.js:565:32)\n at tryModuleLoad (module.js:505:12)</code></pre><p>If you get an error like this, you need to either upgrade your glibc (typically by upgrading to up-to-date distribution version) or use some other <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a> method.</p><h2>TLS</h2><p>Don't forget to <a href=\"#root/_help_l2VkvOwUNfZj\">configure TLS</a>, which is required for secure usage!</p>",
"_help_ZNAjFcxqHr9V": "#!/bin/bash\n\n# Configuration\nREPO=\"TriliumNext/Trilium\"\nPATTERN=\"TriliumNotes-Server-.*-linux-x64.tar.xz\"\nDOWNLOAD_DIR=\"/var/tmp/trilium_download\"\nOUTPUT_DIR=\"/opt/trilium\"\nSERVICE_NAME=\"trilium\"\nVERSION_FILE=\"$OUTPUT_DIR/version.txt\"\n\n# Ensure dependencies are installed\ncommand -v curl >/dev/null 2>&1 || { echo \"Error: curl is required\"; exit 1; }\ncommand -v jq >/dev/null 2>&1 || { echo \"Error: jq is required\"; exit 1; }\ncommand -v tar >/dev/null 2>&1 || { echo \"Error: tar is required\"; exit 1; }\n\n# Create download directory\nmkdir -p \"$DOWNLOAD_DIR\" || { echo \"Error: Cannot create $DOWNLOAD_DIR\"; exit 1; }\n\n# Get the latest release version\nLATEST_VERSION=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r '.tag_name')\nif [ -z \"$LATEST_VERSION\" ]; then\n echo \"Error: Could not fetch latest release version\"\n exit 1\nfi\n\n# Check current installed version (from version.txt or existing tarball)\nCURRENT_VERSION=\"\"\nif [ -f \"$VERSION_FILE\" ]; then\n CURRENT_VERSION=$(cat \"$VERSION_FILE\")\nelif [ -f \"$DOWNLOAD_DIR/TriliumNotes-Server-$LATEST_VERSION-linux-x64.tar.xz\" ]; then\n CURRENT_VERSION=\"$LATEST_VERSION\"\nfi\n\n# Compare versions\nif [ \"$CURRENT_VERSION\" = \"$LATEST_VERSION\" ]; then\n echo \"Latest version ($LATEST_VERSION) is already installed\"\n exit 0\nfi\n\n# Download the latest release\nLATEST_URL=$(curl -sL https://api.github.com/repos/$REPO/releases/latest | jq -r \".assets[] | select(.name | test(\\\"$PATTERN\\\")) | .browser_download_url\")\nif [ -z \"$LATEST_URL\" ]; then\n echo \"Error: No asset found matching pattern '$PATTERN'\"\n exit 1\nfi\n\nFILE_NAME=$(basename \"$LATEST_URL\")\nFILE_PATH=\"$DOWNLOAD_DIR/$FILE_NAME\"\n\n# Download if not already present\nif [ -f \"$FILE_PATH\" ]; then\n echo \"Latest release $FILE_NAME already downloaded\"\nelse\n curl -LO --output-dir \"$DOWNLOAD_DIR\" \"$LATEST_URL\" || { echo \"Error: Download failed\"; exit 1; }\n echo \"Downloaded $FILE_NAME to $DOWNLOAD_DIR\"\nfi\n\n# Extract the tarball\nEXTRACT_DIR=\"$DOWNLOAD_DIR/extracted\"\nmkdir -p \"$EXTRACT_DIR\"\ntar -xJf \"$FILE_PATH\" -C \"$EXTRACT_DIR\" || { echo \"Error: Extraction failed\"; exit 1; }\n\n# Find the extracted directory (e.g., TriliumNotes-Server-0.97.2-linux-x64)\nINNER_DIR=$(find \"$EXTRACT_DIR\" -maxdepth 1 -type d -name \"TriliumNotes-Server-*-linux-x64\" | head -n 1)\nif [ -z \"$INNER_DIR\" ]; then\n echo \"Error: Could not find extracted directory matching TriliumNotes-Server-*-linux-x64\"\n exit 1\nfi\n\n# Stop the trilium-server service\nif systemctl is-active --quiet \"$SERVICE_NAME\"; then\n echo \"Stopping $SERVICE_NAME service...\"\n sudo systemctl stop \"$SERVICE_NAME\" || { echo \"Error: Failed to stop $SERVICE_NAME\"; exit 1; }\nfi\n\n# Copy contents to /opt/trilium, overwriting existing files\necho \"Copying contents from $INNER_DIR to $OUTPUT_DIR...\"\nsudo mkdir -p \"$OUTPUT_DIR\"\nsudo cp -r \"$INNER_DIR\"/* \"$OUTPUT_DIR\"/ || { echo \"Error: Copy failed\"; exit 1; }\necho \"$LATEST_VERSION\" | sudo tee \"$VERSION_FILE\" >/dev/null\necho \"Files copied to $OUTPUT_DIR\"\n\n# Start the trilium-server service\necho \"Starting $SERVICE_NAME service...\"\nsudo systemctl start \"$SERVICE_NAME\" || { echo \"Error: Failed to start $SERVICE_NAME\"; exit 1; }\n\n# Clean up\nrm -rf \"$EXTRACT_DIR\"\necho \"Cleanup complete. Trilium updated to $LATEST_VERSION.\"",
"_help_rWX5eY045zbE": "<p>Official docker images are published on docker hub for <strong>AMD64</strong>, <strong>ARMv7</strong> and <strong>ARM64/v8</strong>: <a href=\"https://hub.docker.com/r/triliumnext/trilium/\">https://hub.docker.com/r/triliumnext/trilium/</a></p><h2>Prerequisites</h2><p>Ensure Docker is installed on your system.</p><p>If you need help installing Docker, reference the <a href=\"https://docs.docker.com/engine/install/\">Docker Installation Docs</a></p><p>By default, the container starts as root, prepares the data directory and then runs Trilium as an unprivileged user. It can also run entirely without root, as described in <em>Running as a non-root user</em> below.</p><aside class=\"admonition warning\"><p>If you're using a SMB/CIFS share or folder as your Trilium data directory, <a href=\"https://github.com/TriliumNext/Notes/issues/415#issuecomment-2344824400\">you'll need</a> to add the mount options of <code>nobrl</code> and <code>noperm</code> when mounting your SMB share.</p></aside><h2>Running with Docker Compose</h2><h3>Grab the latest docker-compose.yml:</h3><pre><code class=\"language-text-x-trilium-auto\">wget https://raw.githubusercontent.com/TriliumNext/Trilium/master/docker-compose.yml</code></pre><p>Optionally, edit the <code>docker-compose.yml</code> file to configure the container settings prior to starting it. Unless configured otherwise, the data directory will be <code>trilium-data</code> next to <code>docker-compose.yml</code> and the container will be accessible at port 8080.</p><p>To keep the data somewhere else, edit the <code>volumes</code> entry in <code>docker-compose.yml</code> and change the host path before the colon (for example <code>- /srv/trilium-data:/home/node/trilium-data</code>). Leave the path after the colon unchanged.</p><h3>Start the container:</h3><p>Run the following command to start the container in the background:</p><pre><code class=\"language-text-x-trilium-auto\">docker compose up -d</code></pre><h2>Running without Docker Compose / Further Configuration</h2><h3>Pulling the Docker Image</h3><p>To pull the image, use the following command, replacing <code>[VERSION]</code> with the desired version or tag, such as <code>v0.91.6</code> or just <code>latest</code>. (See published tag names at <a href=\"https://hub.docker.com/r/triliumnext/trilium/tags\">https://hub.docker.com/r/triliumnext/trilium/tags</a>.):</p><pre><code class=\"language-text-x-trilium-auto\">docker pull triliumnext/trilium:v0.91.6</code></pre><p><strong>Warning:</strong> Avoid using the \"latest\" tag, as it may automatically upgrade your instance to a new minor version, potentially disrupting sync setups or causing other issues.</p><h3>Preparing the Data Directory</h3><p>Trilium requires a directory on the host system to store its data. This directory must be mounted into the Docker container with write permissions.</p><h3>Running the Docker Container</h3><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Local Access Only</p><div class=\"trilium-tab-panel\"><p>Run the container to make it accessible only from the localhost. This setup is suitable for testing or when using a proxy server like Nginx or Apache.</p><pre><code class=\"language-text-x-sh\">sudo docker run -t -i -p 127.0.0.1:8080:8080 \\\n\t-v ~/trilium-data:/home/node/trilium-data \\\n\ttriliumnext/trilium:[VERSION]</code></pre><ol><li>Verify the container is running using <code>docker ps</code>.</li><li>Access Trilium via a web browser at <code>127.0.0.1:8080</code>.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Local Network Access</p><div class=\"trilium-tab-panel\"><p>To make the container accessible only on your local network, first create a new Docker network:</p><pre><code class=\"language-text-x-sh\">docker network create -d macvlan -o parent=eth0 --subnet 192.168.2.0/24 --gateway 192.168.2.254 --ip-range 192.168.2.252/27 mynet</code></pre><p>Then, run the container with the network settings:</p><pre><code class=\"language-text-x-sh\">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre><p>To set a different user ID (UID) and group ID (GID) for the saved data, use the <code>USER_UID</code> and <code>USER_GID</code> environment variables:</p><pre><code class=\"language-text-x-sh\">docker run --net=mynet -d -p 127.0.0.1:8080:8080 -e \"USER_UID=1001\" -e \"USER_GID=1001\" -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:-latest</code></pre><p>Find the local IP address using <code>docker inspect [container_name]</code> and access the service from devices on the local network.</p><pre><code class=\"language-text-x-sh\">docker ps\ndocker inspect [container_name]</code></pre></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Global Access</p><div class=\"trilium-tab-panel\"><p>To allow access from any IP address, run the container as follows:</p><pre><code class=\"language-text-x-sh\">docker run -d -p 0.0.0.0:8080:8080 \\\n\t-v ~/trilium-data:/home/node/trilium-data \\\n\ttriliumnext/trilium:[VERSION]</code></pre><p>Stop the container with <code>docker stop <CONTAINER ID></code>, where the container ID is obtained from <code>docker ps</code>.</p></div></section></div><h3>Custom Data Directory</h3><p>For a custom data directory, use:</p><pre><code class=\"language-text-x-trilium-auto\">-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><p>If you want to run your instance in a non-default way, please use the volume switch as follows: <code>-v ~/YourOwnDirectory:/home/node/trilium-data triliumnext/trilium:<VERSION></code>. It is important to be aware of how Docker works for volumes, with the first path being your own and the second the one to virtually bind to. <a href=\"https://docs.docker.com/storage/volumes/\">https://docs.docker.com/storage/volumes/</a> The path before the colon is the host directory, and the path after the colon is the container's path. More details can be found in the <a href=\"https://docs.docker.com/storage/volumes/\">Docker Volumes Documentation</a>.</p><h2>Reverse Proxy</h2><ol><li><a href=\"#root/_help_ud6MShXL4WpO\">Nginx</a></li><li><a href=\"#root/_help_fDLvzOx29Pfg\">Apache</a></li></ol><h3>Note on timezones</h3><p>If you are having timezone issues and you are not using docker-compose, you may need to add a <code>TZ</code> environment variable with the <a href=\"https://en.wikipedia.org/wiki/List_of_tz_database_time_zones\">TZ identifier</a> of your local timezone.</p><h3>Other environment variables</h3><p>For the complete list of environment variables Trilium reads (network settings, authentication, sync, etc.), see <a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>.</p><h2>Running as a non-root user</h2><p>By default, the container starts as root, gives the data directory to the <code>node</code> user (UID and GID <code>1000</code>, or the values of <code>USER_UID</code> and <code>USER_GID</code>) and then runs Trilium as that user. Some environments do not allow a container to start as root at all, for example rootless Docker or Podman, or Kubernetes with <code>runAsNonRoot</code>. Starting with v0.107.0, the same image can run entirely as a non-root user instead.</p><p>To run Trilium as a non-root user, set the user with Docker's <code>--user</code> flag:</p><pre><code class=\"language-text-x-sh\">docker run -d -p 8080:8080 --user 1000:1000 -v /srv/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><p>With Docker Compose, add <code>user:</code> to the service in <code>docker-compose.yml</code>:</p><pre><code class=\"language-text-x-yaml\">services:\n trilium:\n user: \"1000:1000\"</code></pre><p>The image also runs with a read-only root filesystem and without any capabilities, for example with <code>--read-only --tmpfs /tmp --cap-drop ALL --security-opt no-new-privileges</code>.</p><p>Without root, the container cannot change the ownership of files, so:</p><ul><li><p>The data directory on the host must exist and belong to that user before the container starts. If the directory is missing, Docker creates it as root, and Trilium cannot write to it. For example:</p><pre><code class=\"language-text-x-sh\">mkdir -p /srv/trilium-data\nsudo chown 1000:1000 /srv/trilium-data</code></pre></li><li><p>A named volume instead of a host directory only works for UID <code>1000</code>: Docker gives a new volume the owner of the image's data directory, which is the <code>node</code> user.</p></li><li><p><code>USER_UID</code> and <code>USER_GID</code> are ignored. The user comes from <code>--user</code> or <code>user:</code> alone.</p></li></ul><p>If Trilium cannot use its data directory, it stops at startup and prints which directory or files it cannot use, who owns them, and the command that fixes it.</p><aside class=\"admonition note\"><p>An installation that ran as root leaves its files owned by UID <code>1000</code>, or by <code>USER_UID</code> if it was set. To switch it to <code>--user</code>, either use that same UID, or give the data directory to the new user first, for example with <code>sudo chown -R 1001:1001 /srv/trilium-data</code>.</p></aside>",
"_help_moVgBcoxE3EK": "<p>This page describes configuring the Trilium module included in NixOS.</p><h2>Requirements</h2><p><a href=\"https://nixos.org/\">NixOS</a> installation.</p><h2>Configuration</h2><p>Add this to your <code>configuration.nix</code>:</p><pre><code class=\"language-text-x-trilium-auto\">services.trilium-server.enable = true;\n\n# default data directory: /var/lib/trilium\n#services.trilium-server.dataDir = \"/var/lib/trilium-sync-server\";\n\n# default bind address: 127.0.0.1, port 8080\n#services.trilium-server.host = \"0.0.0.0\";\n#services.trilium-server.port = 12783;</code></pre><p>Uncomment any option you would like to change.</p><p>See the <a href=\"https://search.nixos.org/options?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=trilium-server\">NixOS options list</a> for more options (including nginx reverse proxy configuration).</p>",
"_help_J1Bb6lVlwU5T": "<aside class=\"admonition warning\"><p>This page describes manually installing Trilium on your server. <strong>Note that this is a not well supported way to install Trilium, problems may appear, information laid out here is quite out of date. It is recommended to use either</strong> <a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Docker Server Installation</a> <strong>or</strong> <a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged server installation</a><strong>.</strong></p></aside><h2>Requirements</h2><p>Trilium is a node.js application. Supported (tested) version of node.js is latest 14.X.X and 16.X.X. Trilium might work with older versions as well.</p><p>You can check your node version with this command (node.js needs to be installed):</p><pre><code class=\"language-text-x-trilium-auto\">node --version</code></pre><p>If your Linux distribution has only an outdated version of node.js, you can take a look at the installation instruction on node.js website, which covers most popular distributions.</p><h3>Dependencies</h3><p>There are some dependencies required. You can see command for Debian and its derivatives (like Ubuntu) below:</p><pre><code class=\"language-text-x-trilium-auto\">sudo apt install libpng16-16 libpng-dev pkg-config autoconf libtool build-essential nasm libx11-dev libxkbfile-dev</code></pre><h2>Installation</h2><h3>Download</h3><p>You can either download source code zip/tar from <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">https://github.com/TriliumNext/Trilium/releases/latest</a>.</p><p>For the latest version including betas, clone Git repository <strong>from</strong> <code>main</code> <strong>branch</strong> with:</p><pre><code class=\"language-text-x-trilium-auto\">git clone -b main https://github.com/triliumnext/trilium.git</code></pre><h2>Installation</h2><pre><code class=\"language-text-x-trilium-auto\">cd trilium\n\n# download all node dependencies\nnpm install\n\n# make sure the better-sqlite3 binary is there\nnpm rebuild\n\n# bundles & minifies frontend JavaScript\nnpm run webpack</code></pre><h2>Run</h2><pre><code class=\"language-text-x-trilium-auto\">cd trilium\n\n# using nohup to make sure trilium keeps running after user logs out\nnohup TRILIUM_ENV=dev node src/www &</code></pre><p>The application by default starts up on port 8080, so you can open your browser and navigate to <a href=\"http://localhost:8080\">http://localhost:8080</a> to access Trilium (replace \"localhost\" with your hostname).</p><p>Once the server is running, the console lists the addresses it can be reached on, including the ones other devices on your network can use.</p><h2>TLS</h2><p>Don't forget to <a href=\"#root/_help_l2VkvOwUNfZj\">configure TLS</a> which is required for secure usage!</p>",
"_help_DCmT6e7clMoP": "<p>As Trilium can be run in Docker it also can be deployed in Kubernetes. You can either use our Helm chart, a community Helm chart, or roll your own Kubernetes deployment.</p><p>The recommended way is to use a Helm chart.</p><h2>Root privileges</h2><p>By default, the Trilium container starts as root, gives the data directory to UID and GID <code>1000:1000</code> and then runs Trilium with those reduced privileges, so no init container is needed to fix the permissions. To use a different UID and GID, set the <code>USER_UID</code> and <code>USER_GID</code> environment variables.</p><p>Starting with v0.107.0, the container can also run without root, which a <code>restricted</code> Pod Security Standard requires. Set the user in the pod's security context, and <code>fsGroup</code> so that Kubernetes gives the volume to that group:</p><pre><code class=\"language-text-x-yaml\">securityContext:\n runAsUser: 1000\n runAsGroup: 1000\n runAsNonRoot: true\n fsGroup: 1000</code></pre><p>In that mode <code>USER_UID</code> and <code>USER_GID</code> are ignored. See the section on running as a non-root user in <a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a> for what the data directory needs.</p><h2>Helm Charts</h2><p><a href=\"https://github.com/TriliumNext/helm-charts\">Official Helm chart</a> from TriliumNext Unofficial helm chart by <a href=\"https://github.com/ohdearaugustin\">ohdearaugustin</a>: <a href=\"https://github.com/ohdearaugustin/charts\">https://github.com/ohdearaugustin/charts</a></p><h2>Adding a Helm repository</h2><p>Below is an example of how</p><pre><code class=\"language-text-x-trilium-auto\">helm repo add trilium https://triliumnext.github.io/helm-charts\n\"trilium\" has been added to your repositories</code></pre><h2>How to install a chart</h2><p>After reviewing the <a href=\"https://github.com/TriliumNext/helm-charts/blob/main/charts/trilium/values.yaml\"><code>values.yaml</code></a> from the Helm chart, modifying as required and then creating your own:</p><pre><code class=\"language-text-x-trilium-auto\">helm install --create-namespace --namespace trilium trilium trilium/trilium -f values.yaml</code></pre><p>For more information on using Helm, please refer to the Helm documentation, or create a Discussion in the TriliumNext GitHub Organization.</p>",
"_help_klCWNks3ReaQ": "<p>Trilium does not support multiple users. In order to have two or more persons with their own set of notes, multiple server instances must be set up. It is also not possible to use multiple <a href=\"#root/_help_cbkrhQjrkKrh\">sync</a> servers.</p><p>To allow multiple server instances on a single physical server:</p><ul><li><p>For <a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged version for Linux</a> or <a class=\"reference-link\" href=\"#root/_help_J1Bb6lVlwU5T\">Manually</a>, if starting the server manually just specify a different port and data directory per instance:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_NETWORK_PORT=8080 TRILIUM_DATA_DIR=/path/to/your/data-dir-A /opt/trilium/trilium.sh</code></pre><p>For a second instance:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_NETWORK_PORT=8081 TRILIUM_DATA_DIR=/path/to/your/data-dir-B /opt/trilium/trilium.sh</code></pre><p>If using <code>systemd</code>, then set the <a href=\"https://serverfault.com/questions/413397/how-to-set-environment-variable-in-systemd-service\">environment variables in the service configuration</a>.</p></li><li><p>For <a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a>, simply use two different containers, each with their own port binding and data directory.</p></li><li><p>For <a class=\"reference-link\" href=\"#root/_help_moVgBcoxE3EK\">On NixOS</a>, the only possible way is to use Docker OCI containers or at least one NixOS container with its own service definition.</p></li></ul><p>For support or additional context, see the related <a href=\"https://github.com/orgs/TriliumNext/discussions/1642#discussioncomment-12768808\">GitHub Discussion</a>.</p>",
"_help_vcjrb3VVYPZI": "<p>Trilium is typically exposed to the internet behind a <strong>reverse proxy</strong>, which handles TLS termination, presents a single public entry point, and (optionally) lets you host multiple instances under one domain. Trilium itself keeps running on plain HTTP on its local port; the proxy sits in front of it.</p><p>This section collects provider-specific guides and the configuration that applies regardless of which proxy you use.</p><h2>Provider guides</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_ud6MShXL4WpO\">Nginx</a></li><li><a class=\"reference-link\" href=\"#root/_help_5ERVJb9s4FRD\">Traefik</a></li><li><a class=\"reference-link\" href=\"#root/_help_fDLvzOx29Pfg\">Apache using Docker</a></li></ul><h2>Applies to every proxy</h2><p>Regardless of the proxy you choose, make sure of the following:</p><ul><li><strong>Forward the WebSocket upgrade.</strong> Trilium uses a WebSocket for synchronization and live UI updates. Your proxy must pass the <code>Upgrade</code> and <code>Connection</code> headers through, otherwise the client will appear to load but never receive updates.</li><li><strong>Configure the trusted proxy.</strong> So that Trilium sees the real client IP (for rate limiting, logging, and secure cookies) rather than the proxy's address. See <a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</li><li><strong>Terminate TLS at the proxy.</strong> See <a class=\"reference-link\" href=\"#root/_help_l2VkvOwUNfZj\">HTTPS (TLS)</a>.</li></ul><h2>Putting an authentication proxy in front of Trilium</h2><p>Some setups place a <strong>forward-auth / SSO layer</strong> (Authelia, Authentik, oauth2-proxy, or an OIDC plugin) at the proxy so that <em>every</em> request must pass an interactive login first.</p><p>This <strong>breaks synchronization and initial setup.</strong> Sync is a machine-to-machine process that runs unattended in the background — it has no browser and cannot complete an interactive login challenge. When the proxy intercepts a sync request, it returns its HTML login page instead of the expected JSON, and the client fails with an error such as:</p><pre><code class=\"language-text-x-trilium-auto\">Sync failed: Request to GET https://trilium.example.com/api/setup/status failed,\nerror: Unexpected token '<', \"<!doctype \"... is not valid JSON\n</code></pre><p>There are two ways to resolve this:</p><ul><li><strong>Preferred, use Trilium's built-in authentication.</strong> Don't gate Trilium at the proxy at all. Trilium can authenticate the web interface itself, including via <a href=\"#root/_help_x1lQNKQBqLcA\">OpenID Connect</a>. This leaves the sync endpoints free to authenticate the way they're designed to.</li><li><strong>Exempt the sync endpoints from the proxy's authentication.</strong> If you must keep auth at the proxy, exclude these paths from the forward-auth check:<ul><li><code>/api/setup/*</code></li><li><code>/api/login/sync</code></li><li><code>/api/sync/*</code></li></ul></li></ul><aside class=\"admonition note\"><p>This is safe: Trilium authenticates these endpoints itself. Sync uses a challenge-free HMAC handshake based on a shared secret, and the one-time setup seed request is password-protected — so exempting them at the proxy does not expose unauthenticated access to your data.</p></aside><p>An example for Nginx, where <code>/auth</code> is your forward-auth endpoint:</p><pre><code class=\"language-text-x-trilium-auto\">server {\n # ... TLS, server_name, etc. ...\n\n # Sync and setup endpoints authenticate themselves — skip forward-auth.\n location ~ ^/api/(sync|login/sync|setup) {\n auth_request off;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n }\n\n # Everything else goes through forward-auth.\n location / {\n auth_request /auth;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n }\n}</code></pre>",
"_help_ud6MShXL4WpO": "<p>Configure Nginx proxy and HTTPS. The operating system here is Ubuntu.</p><h2>Installing Nginx</h2><p>Download Nginx and remove Apache2</p><pre><code class=\"language-text-x-trilium-auto\">sudo apt-get install nginx\nsudo apt-get remove apache2</code></pre><h2>Build the configuration file</h2><ol><li><p>First, create the configuration file:</p><pre><code class=\"language-text-x-trilium-auto\">cd /etc/nginx/conf.d\nvim default.conf</code></pre></li><li><p>Fill the file with the context shown below, part of the setting show be changed. Then you can enjoy your web with HTTPS forced and proxy.</p><pre><code class=\"language-text-x-trilium-auto\"># This part configures, where your Trilium server is running\nupstream trilium {\n zone trilium 64k;\n server 127.0.0.1:8080; # change it to a different hostname and port if non-default is used\n keepalive 2;\n}\n\n# This part is for proxy and HTTPS configure\nserver {\n listen 443 ssl;\n server_name trilium.example.net; #change trilium.example.net to your domain without HTTPS or HTTP.\n ssl_certificate /etc/ssl/note/example.crt; #change /etc/ssl/note/example.crt to your path of crt file.\n ssl_certificate_key /etc/ssl/note/example.net.key; #change /etc/ssl/note/example.net.key to your path of key file.\n ssl_session_cache builtin:1000 shared:SSL:10m;\n ssl_protocols TLSv1 TLSv1.1 TLSv1.2;\n ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;\n ssl_prefer_server_ciphers on;\n access_log /var/log/nginx/access.log; #check the path of access.log, if it doesn't fit your file, change it\n\n location / {\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n proxy_read_timeout 90;\n }\n}\n\n# This part is for HTTPS forced\nserver {\n listen 80;\n server_name trilium.example.net; # change to your domain\n return 301 https://$server_name$request_uri;\n}</code></pre></li></ol><h2>Serving under a different path</h2><p>Alternatively if you want to serve the instance under a different path (useful e.g. if you want to serve multiple instances), update the location block like so:</p><ul><li>update the location with your desired path (make sure to not leave a trailing slash \"/\", if your <code>proxy_pass</code> does not end on a slash as well)</li><li>add the <code>proxy_cookie_path</code> directive with the same path: this allows you to stay logged in at multiple instances at the same time.</li></ul><pre><code class=\"language-text-x-trilium-auto\"> location /trilium/instance-one {\n rewrite /trilium/instance-one/(.*) /$1 break;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection \"upgrade\";\n proxy_pass http://trilium;\n proxy_cookie_path / /trilium/instance-one\n proxy_read_timeout 90;\n }</code></pre><h2>Configuring the trusted proxy</h2><p>After setting up a reverse proxy, make sure to configure the <a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p>",
"_help_fDLvzOx29Pfg": "<p>This tutorial assumes that you have created a DNS A record for <code>trilium.yourdomain.com</code> that you want to use for your Trilium server.</p><h2>Docker setup</h2><p>Download docker image and create container</p><pre><code class=\"language-text-x-trilium-auto\"> docker pull triliumnext/trilium:[VERSION]\n docker create --name trilium -t -p 127.0.0.1:8080:8080 -v ~/trilium-data:/home/node/trilium-data triliumnext/trilium:[VERSION]</code></pre><h2>Configuring the Apache proxy</h2><ol><li><p>Enable apache proxy modules</p><pre><code class=\"language-text-x-trilium-auto\"> a2enmod ssl\n a2enmod proxy\n a2enmod proxy_http\n a2enmod proxy_wstunnel</code></pre></li><li><p>Create a new let's encrypt certificate</p><pre><code class=\"language-text-x-trilium-auto\"> sudo certbot certonly -d trilium.mydomain.com</code></pre><p>Choose standalone (2) and note the location of the created certificates (typically /etc/letsencrypt/live/...)</p></li><li><p>Create a new virtual host file for apache (you may want to use <code>apachectl -S</code> to determine the server root location, mine is /etc/apache2)</p><pre><code class=\"language-text-x-trilium-auto\"> sudo nano /etc/apache2/sites-available/trilium.yourdomain.com.conf</code></pre><p>Paste (and customize) the following text into the configuration file</p><pre><code class=\"language-text-x-trilium-auto\"> \n ServerName http://trilium.yourdomain.com\n RewriteEngine on\n RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,QSA,R=permanent]\n \n \n ServerName https://trilium.yourdomain.com\n RewriteEngine On\n RewriteCond %{HTTP:Connection} Upgrade [NC]\n RewriteCond %{HTTP:Upgrade} websocket [NC]\n RewriteRule /(.*) ws://localhost:8080/$1 [P,L]\n AllowEncodedSlashes NoDecode\n ProxyPass / http://localhost:8080/ nocanon\n ProxyPassReverse / http://localhost:8080/\n SSLCertificateFile /etc/letsencrypt/live/trilium.yourdomain.com/fullchain.pem\n SSLCertificateKeyFile /etc/letsencrypt/live/trilium.yourdomain.com/privkey.pem\n Include /etc/letsencrypt/options-ssl-apache.conf\n </code></pre></li><li><p>Enable the virtual host with <code>sudo a2ensite trilium.yourdomain.com.conf</code></p></li><li><p>Reload apache2 with <code>sudo systemctl reload apache2</code></p></li></ol><h2>Configuring the trusted proxy</h2><p>After setting up a reverse proxy, make sure to configure the <a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p><h2>Setup the systemd service to start up the server</h2><p>Create and enable a systemd service to start the docker container on boot</p><ol><li><p>Create a new empty file called <code>/lib/systemd/system/trilium.service</code> with the contents</p><pre><code class=\"language-text-x-trilium-auto\"> [Unit]\n Description=Trilium Server\n Requires=docker.service\n After=docker.service\n\n [Service]\n Restart=always\n ExecStart=/usr/bin/docker start -a trilium\n ExecStop=/usr/bin/docker stop -t 2 trilium\n\n [Install]\n WantedBy=local.target</code></pre></li><li><p>Install, enable and start service</p><pre><code class=\"language-text-x-trilium-auto\"> sudo systemctl daemon-reload\n sudo systemctl enable trilium.service\n sudo systemctl start trilium.service</code></pre></li></ol>",
"_help_LLzSMXACKhUs": "<p>If you are running the Trilium server under a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a>, it's important to configure it as a trusted proxy so that the application can correctly identify the real IP address of the clients. Trilium uses that address for <a href=\"#root/_help_0hzsNCP31IAB\">brute-force protection</a>, for the failed sign-in entries in its logs and to detect whether the connection was made over HTTPS.</p><p>Without this setting, every request appears to come from the reverse proxy, so all clients share a single limit of failed sign-in attempts.</p><h2>Configuring the trusted proxy</h2><p>To trust the reverse proxy, modify <a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a> and set <code>trustedReverseProxy</code> to the address the reverse proxy connects to Trilium from:</p><pre><code class=\"language-text-x-trilium-auto\">[Network]\ntrustedReverseProxy=loopback</code></pre><p>The value is a comma-separated list of IP addresses, subnets in CIDR notation or one of the following names:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Addresses</th></tr></thead><tbody><tr><td><code>loopback</code></td><td><code>127.0.0.1/8</code>, <code>::1/128</code></td></tr><tr><td><code>linklocal</code></td><td><code>169.254.0.0/16</code>, <code>fe80::/10</code></td></tr><tr><td><code>uniquelocal</code></td><td><code>10.0.0.0/8</code>, <code>172.16.0.0/12</code>, <code>192.168.0.0/16</code>, <code>fc00::/7</code></td></tr></tbody></table></figure><p>Trilium then reads the client's address from the <code>X-Forwarded-For</code> header, taking the right-most entry that does not belong to a trusted address. Entries a client adds to the header are to the left of the ones the proxy appends, so they are ignored.</p><p>Common setups:</p><ul><li><strong>The reverse proxy runs on the same machine</strong>: use <code>loopback</code>.</li><li><strong>Trilium runs in Docker, with the reverse proxy on the host or in another container</strong>: use the subnet of the Docker network (for example <code>172.18.0.0/16</code>), or <code>uniquelocal</code> to cover every Docker network. With the environment variable: <code>TRILIUM_NETWORK_TRUSTEDREVERSEPROXY=172.18.0.0/16</code>.</li><li><strong>The reverse proxy runs on another machine</strong>: use its IP address.</li></ul><p>Only list addresses that the reverse proxy connects from. Any client connecting from a trusted address can claim to be another client through the <code>X-Forwarded-For</code> header. This matters for broad values such as <code>uniquelocal</code>: if devices on your local network can also reach Trilium directly, use the proxy's exact address instead.</p><aside class=\"admonition warning\"><p>Avoid setting <code>trustedReverseProxy=true</code>. It makes Trilium use the left-most entry of <code>X-Forwarded-For</code>, which is the value the client sent, unless the proxy discards the incoming header. Proxies usually append to it instead (such as Nginx's <code>$proxy_add_x_forwarded_for</code>), so a client can send a different address with every request and bypass the limit on failed sign-in attempts.</p></aside><p>For more information, consult <a href=\"https://expressjs.com/en/guide/behind-proxies.html\">Express behind proxies</a>.</p>",
"_help_5ERVJb9s4FRD": "<p>The goal of this article is to configure Traefik proxy and HTTPS. See <a href=\"https://github.com/TriliumNext/Trilium/issues/7768#issuecomment-3539165814\">#7768</a> for reference.</p><h2>Breaking change in Traefik 3.6.4</h2><p>Traefik 3.6.4 introduced a <a href=\"https://doc.traefik.io/traefik/migrate/v3/#encoded-characters-in-request-path\">breaking change</a> regarding how percent-encoded characters are handled in URLs. Trilium puts the title of an image or attachment in its URL path, so one whose title contains <code>#</code> or <code>/</code> is requested at a path such as <code>/api/images/…/diagram%231.png</code>. Traefik rejects these paths with HTTP 400, and the image does not load. Search is not affected, because it sends its text in a query parameter.</p><p>The easiest solution is to update to Traefik 3.6.7 or later which reverts this configuration change. Alternatively, the configuration can be changed according to the section below.</p><details class=\"trilium-collapsible\"><summary>Configuration change</summary><p>To solve this, the Traefik <a href=\"https://doc.traefik.io/traefik/getting-started/configuration-overview/#the-install-configuration\"><strong>static</strong> configuration</a> must be modified in order to allow those characters:</p><pre><code class=\"language-text-x-yaml\">entryPoints:\n web:\n http:\n encodedCharacters:\n allowEncodedSlash: true\n allowEncodedHash: true</code></pre><aside class=\"admonition tip\"><p>If images still fail to load, you might need to enable more encoded character groups. For more information, see <a href=\"https://github.com/TriliumNext/Trilium/issues/7968\">the relevant GitHub issue</a>; feel free to report your findings.</p></aside></details><h3>Build the docker-compose file</h3><p>Setting up Traefik as reverse proxy requires setting the following labels:</p><pre><code class=\"language-text-x-yaml\"> labels:\n - traefik.enable=true\n - traefik.http.routers.trilium.entrypoints=https\n - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)\n - traefik.http.routers.trilium.tls=true\n - traefik.http.routers.trilium.service=trilium\n - traefik.http.services.trilium.loadbalancer.server.port=8080\n # scheme must be HTTP instead of the usual HTTPS because Trilium listens on HTTP internally\n - traefik.http.services.trilium.loadbalancer.server.scheme=http\n - traefik.docker.network=proxy\n # forward HTTP to HTTPS\n - traefik.http.routers.trilium.middlewares=trilium-headers@docker\n - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https</code></pre><h3>Setup needed environment variables</h3><p>After setting up a reverse proxy, make sure to configure the <a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>.</p><h3>Example <code>docker-compose.yaml</code></h3><pre><code class=\"language-text-x-yaml\">services:\n trilium:\n image: triliumnext/trilium\n container_name: trilium\n networks:\n - traefik-proxy\n environment:\n - TRILIUM_NETWORK_TRUSTEDREVERSEPROXY=my-traefik-host-ip # e.g., 172.18.0.0/16\n volumes:\n - /path/to/data:/home/node/trilium-data\n - /etc/timezone:/etc/timezone:ro\n - /etc/localtime:/etc/localtime:ro\n labels:\n - traefik.enable=true\n - traefik.http.routers.trilium.entrypoints=https\n - traefik.http.routers.trilium.rule=Host(`trilium.mydomain.tld`)\n - traefik.http.routers.trilium.tls=true\n - traefik.http.routers.trilium.service=trilium\n - traefik.http.services.trilium.loadbalancer.server.port=8080\n # scheme must be HTTP instead of the usual HTTPS because of how trilium works\n - traefik.http.services.trilium.loadbalancer.server.scheme=http\n - traefik.docker.network=traefik-proxy\n # Tell Trilium the original request was HTTPS\n - traefik.http.routers.trilium.middlewares=trilium-headers@docker\n - traefik.http.middlewares.trilium-headers.headers.customrequestheaders.X-Forwarded-Proto=https\n\nnetworks:\n traefik-proxy:\n external: true</code></pre>",
"_help_l2VkvOwUNfZj": "<p>Configuring TLS is essential for <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a> in Trilium. This guide details the steps to set up TLS within Trilium itself.</p><aside class=\"admonition tip\"><p>While Trilium supports HTTPS on its own, it's generally a good idea to use a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a> instead with TLS termination. You can follow a <a href=\"https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-20-04\">guide like this</a> for such setups.</p></aside><h2>Obtaining a TLS Certificate</h2><p>You have two options for obtaining a TLS certificate:</p><ul><li><strong>Recommended</strong>: Obtain a TLS certificate signed by a root certificate authority. For personal use, <a href=\"https://letsencrypt.org\">Let's Encrypt</a> is an excellent choice. It is free, automated, and straightforward. Certbot can facilitate automatic TLS setup.</li><li>Generate a self-signed certificate. This option is not recommended due to the additional complexity of importing the certificate into all machines connecting to the server.</li></ul><h2>Modifying <code>config.ini</code></h2><p>Once you have your certificate, modify the <code>config.ini</code> file in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> to configure Trilium to use it:</p><pre><code class=\"language-text-x-trilium-auto\">[Network]\nport=8080\n# Set to true for TLS/SSL/HTTPS (secure), false for HTTP (insecure).\nhttps=true\n# Path to the certificate (run \"bash bin/generate-cert.sh\" to generate a self-signed certificate).\n# Relevant only if https=true\ncertPath=/[username]/.acme.sh/[hostname]/fullchain.cer\nkeyPath=/[username]/.acme.sh/[hostname]/example.com.key</code></pre><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead. For example, you can configure TLS using environment variables:</p><pre><code class=\"language-text-x-trilium-auto\">export TRILIUM_NETWORK_HTTPS=true\nexport TRILIUM_NETWORK_CERTPATH=/path/to/cert.pem\nexport TRILIUM_NETWORK_KEYPATH=/path/to/key.pem</code></pre><p>The above example shows how this is set up in an environment where the certificate was generated using Let's Encrypt's ACME utility. Your paths may differ. For Docker installations, ensure these paths are within a volume or another directory accessible by the Docker container, such as <code>/home/node/trilium-data/[DIR IN DATA DIRECTORY]</code>.</p><p>After configuring <code>config.ini</code>, restart Trilium and access the hostname using \"https\".</p><h2>Self-Signed Certificate</h2><p>If you opt to use a self-signed certificate for your server instance, note that the desktop instance will not trust it by default.</p><p>To bypass this, disable certificate validation by setting the following environment variable (for Linux):</p><pre><code class=\"language-text-x-trilium-auto\">export NODE_TLS_REJECT_UNAUTHORIZED=0\ntrilium</code></pre><p>Trilium provides scripts to start in this mode, such as <code>trilium-no-cert-check.bat</code> for Windows.</p><p><strong>Warning</strong>: Disabling TLS certificate validation is insecure. Proceed only if you fully understand the implications.</p>",
"_help_0hzsNCP31IAB": "<h2>Disabling authentication</h2><p>If you are running Trilium on <code>localhost</code> only or if authentication is handled by another component, you can disable Trilium’s authentication by adding the following to <code>config.ini</code>:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\nnoAuthentication=true</code></pre><p>Disabling authentication will bypass even the <a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-Factor Authentication</a> since v0.94.1.</p><h2>Brute-force protection</h2><p>Trilium limits each IP address to 10 failed sign-in attempts in 15 minutes. Once an address reaches the limit, Trilium rejects every further attempt from it, including correct ones, until the 15 minutes have passed. The sign-in page then shows <em>Too many login attempts</em>; other clients receive HTTP status 429.</p><p>The limit applies to every way of signing in with the password:</p><ul><li>The sign-in page.</li><li>Setting up <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> from a desktop or mobile app.</li><li>Connecting the <a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a> or the Android sender app.</li><li>Requesting a token through <a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>.</li></ul><p>All of these count toward the same limit, and a wrong password, a wrong one-time password and a wrong recovery code each count as one failed attempt. Successful sign-ins are not counted.</p><p>The limit is per IP address, not per account, so an attacker cannot lock you out by failing to sign in from their own address. The count is kept in memory: restarting the server clears it.</p><aside class=\"admonition important\"><p>Behind a reverse proxy, Trilium sees every request as coming from the proxy unless it is configured as a <a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a>. All clients then share a single limit, so a few wrong attempts from anyone block everyone.</p></aside><h3>Blocking repeated failures with fail2ban</h3><p>A failed attempt on the sign-in page is answered with HTTP status 401 and recorded in the <a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a> as:</p><pre><code class=\"language-text-x-trilium-auto\">WARNING: Wrong password from 203.0.113.7, rejecting.</code></pre><p>When <a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-Factor Authentication</a> is enabled, a wrong one-time password or recovery code is logged as <code>Wrong totp</code> instead. Tools such as fail2ban can match either the log line or the 401 responses to <code>POST /login</code> in the reverse proxy's access log to block an address for longer than 15 minutes.</p><h2>Understanding how the session works</h2><p>Once logged into Trilium, the application will store this information about the login into a cookie on the browser, but also as a session on the server.</p><p>If “Remember me” is checked, then the login will expire in 21 days. This period can be adjusted by modifying the <code>Session.cookieMaxAge</code> value in <code>config.ini</code>. For example, to have the session expire in one day:</p><pre><code class=\"language-text-x-trilium-auto\">[Session]\ncookieMaxAge=86400</code></pre><p>When “Remember me” is unchecked, the behavior is different. At client/browser level the authentication does not have any expiration date, but it will be automatically cleared as soon as the user closes the browser. Nevertheless, the server will also dismiss this authentication in around 24 hours from the <em>last interaction with the application</em>.</p><p>Changing or resetting the password logs out every session, including the one that made the change: open tabs return to the login screen, where you log in again with the new password. This also applies when the password is changed on another instance and reaches the server through synchronization. If you suspect that someone has obtained your session cookie, changing the password cuts off their access.</p><h2>Viewing active sessions</h2><p>The login sessions are now stored in the same <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> as the user data. In order to view which sessions are active, open the <a class=\"reference-link\" href=\"#root/_help_YKWqdJhzi2VY\">SQL Console</a> and run the following query:</p><pre><code class=\"language-text-x-trilium-auto\">SELECT * FROM sessions</code></pre><p>Expired sessions are periodically cleaned by the server, generally an hourly interval.</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-Factor Authentication</a></li><li><a class=\"reference-link\" href=\"#root/_help_LLzSMXACKhUs\">Trusted proxy</a></li></ul>",
"_help_lwAX5SvbrK2g": "<aside class=\"admonition important\"><p>If you forget your password:</p><ul><li>Protected notes are irretrievable without the password.</li><li>Unprotected notes can be recovered.</li></ul></aside><p>There are two options, both involving access to the device that is running your server.</p><h3>By disabling authentication</h3><ol><li>See <a class=\"reference-link\" href=\"#root/_help_0hzsNCP31IAB\">Authentication</a> on how to disable the authentication.</li><li>Restart the server.</li><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → Password → Reset password.</li><li>Re-enable authentication by following step (1) in reverse.</li><li>Restart the server.</li><li>Log in with the new password.</li></ol><h3>By altering the database</h3><ol><li><p>Access the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> file in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>. Open the <code>document.db</code> file with an SQLite client (e.g., <a href=\"https://sqlitebrowser.org/\">DB Browser</a>).</p></li><li><p>Execute the following queries:</p><pre><code class=\"language-text-x-trilium-auto\">UPDATE options SET value = '77/twC5O00cuQgNC63VK32qOKKYwj21ev3jZDXoytVU=' WHERE name = 'passwordVerificationSalt';\nUPDATE options SET value = '710BMasZCAgibzIc07X4P9Q4TeBd4ONnqJOho+pWcBM=' WHERE name = 'passwordDerivedKeySalt';\nUPDATE options SET value = 'Eb8af1/T57b89lCRuS97tPEl4CwxsAWAU7YNJ77oY+s=' WHERE name = 'passwordVerificationHash';\nUPDATE options SET value = 'QpC8XoiYYeqHPtHKRtbNxfTHsk+pEBqVBODYp0FkPBa22tlBBKBMigdLu5GNX8Uu' WHERE name = 'encryptedDataKey';</code></pre></li><li><p>After executing the changes, commit/write the changes. <strong>This sets the password to</strong> <code>**password**</code><strong>, allowing you to log in again.</strong></p></li><li><p>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Password</em> → <em>Change password</em> and replace the unsafe password.</p></li></ol><h2>Handling protected notes</h2><p>When the password is reset, the protected notes are permanently lost due to the fact that they are encrypted with your password so there is no way for Trilium to recover them.</p><p>For pre-existing protected notes (now unrecoverable), consider deleting them or exporting the unprotected notes. Then, delete <code>document.db</code> and start fresh.</p>",
"_help_7DAiwaf8Z7Rz": "<p>Multi-factor authentication (MFA) is a security process that requires users to provide two or more verification factors to gain access to a system, application, or account. This adds an extra layer of protection beyond just using a password.</p><p>By requiring more than one verification method, MFA helps reduce the risk of unauthorized access, even if someone has obtained your password. It’s highly recommended for securing sensitive information stored in your notes.</p><h2>Relationship to OpenID Connect (OIDC)</h2><p>Multi-factor authentication makes your Trilium login safer by requiring an additional proof of identity apart from your password. <a class=\"reference-link\" href=\"#root/_help_x1lQNKQBqLcA\">Signing in with OpenID Connect</a> is a different concept which delegates your authentication to an external provider (e.g. your Google provider, or a self-hosted one such as Authelia). These authentication providers might provide their own security features such as TOTP or passkeys.</p><h2>Time-based one-time password (TOTP)</h2><p>TOTP (Time-Based One-Time Password) is a security feature that generates a unique, temporary code on your device, like a smartphone, which changes every 30 seconds. You use this code, along with your password, to log into your account, making it much harder for anyone else to access them.</p><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Password & Auth.</em></li><li>Make sure <em>Sign-in with</em> has <em>Local password</em> selected.</li><li>In the <em>Two-factor authentication</em> section, press <em>Set up.</em></li><li>Scan the QR code or manually enter the code in your authenticator app.</li><li>Enter the verification code from your authenticator app to confirm that the setup was successful and press <em>Verify & continue</em>.</li><li>Save the recovery codes, then tick the confirmation and press <em>Finish setup</em>.</li><li>Re-login will be required after TOTP setup is finished (after refreshing the page).</li></ol><h2>Signing in</h2><p>Once TOTP is enabled, the sign-in page asks for the code from your authenticator app in <em>One-time password or recovery code</em>, below the password.</p><p>Trilium accepts the code for the current 30-second period as well as the periods just before and after it, so a clock that is slightly off on either side still works. Since v0.106.0, each code is accepted only once: after a successful sign-in, that code and any older one are rejected, even while they are still valid.</p><p>A wrong one-time password counts toward the same limit of failed attempts as a wrong password. See <em>Brute-force protection</em> in <a class=\"reference-link\" href=\"#root/_help_0hzsNCP31IAB\">Authentication</a>.</p><h2>Connecting a device to the server</h2><p>Once TOTP is enabled, connecting a new desktop or mobile app to the server through <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> also asks for the second factor. On the <em>Connect to an existing server</em> screen, enter a one-time password or a recovery code in <em>One-time password or recovery code</em>, below the server's password. Without it, the server refuses to set up the sync.</p><p>The second factor is only asked for when a device is first connected. A device that is already set up keeps syncing without it.</p><aside class=\"admonition note\"><p>Versions prior to v0.107.0 do not ask for the second factor when setting up the sync. Update the desktop and mobile apps along with the server, since older apps have no field to send it.</p></aside><h2>Obtaining an ETAPI token with a password</h2><p>Once TOTP is enabled, obtaining a token for the <a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a> through the <code>/auth/login</code> call also requires the second factor: send the one-time password or a recovery code as <code>totpToken</code>, next to <code>password</code>. Each code is accepted only once.</p><p>For scripts and tools that run unattended, create a token in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>ETAPI</em> instead. Such a token works regardless of TOTP.</p><aside class=\"admonition warning\"><p>Versions prior to v0.107.0 issue an ETAPI token for the password alone, even with TOTP enabled.</p></aside><h2>Recovery codes</h2><p>Recovery codes can be used in place of the TOTP if you lose access to your authenticator. Trilium provides 8 different recovery codes, each recovery code can be used once.</p><p>To use a recovery code, simply login with your password and use the recovery code as the security token.</p><p>The initial set of recovery codes is generated when setting up your TOTP for the first time. They can be regenerated at any time by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Password & Auth</em> and pressing the <em>Regenerate recovery codes</em> button. This will generate a new set of recovery codes while at the same time disabling the previous ones.</p>",
"_help_x1lQNKQBqLcA": "<p>OpenID is a standardized way to let you log into websites using an account from another service, like Google or Authelia, to verify your identity.</p><p>When OpenID is activated, the password-based authentication in Trilium is replaced with a button that connects using your provider. This means that the configuration of <a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-factor authentication with TOTP</a> no longer takes effect, since your provider has to handle any multi-factor authentication.</p><h2>Setup</h2><p>Setting up authentication with OpenID connect is a two-step process:</p><ol><li>First the Trilium server must be configured with information about your authentication provider such as the URL, client ID and secret.</li><li>Second, the user must connect from options to create a link between the account on the provider and the one Trilium has.</li></ol><h3>Configuring the authentication provider</h3><ol><li><p>First, make sure the authentication provider (e.g. Google, Authelia) is configured properly. See <a class=\"reference-link\" href=\"#root/_help_IgkTHSaFfq6A\">Setting up with various providers</a> for concrete examples.</p><ol><li>The redirect URL of Trilium is <code>https://<your-trilium-domain>/callback</code>.</li><li>You should obtain the base URL, client ID and client secret.</li></ol></li><li><p>Set the following information using <a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>Base URL*</td><td><code>oauthBaseUrl</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHBASEURL</code></td><td>The URL of your Trilium instance (e.g. <code>https://example.com</code>).</td></tr><tr><td>Client ID*</td><td><code>oauthClientId</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTID</code></td><td>The client ID from your provider configuration.</td></tr><tr><td>Client Secret*</td><td><code>oauthClientSecret</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTSECRET</code></td><td>The client secret from your provider configuration.</td></tr><tr><td>Client auth method</td><td><code>oauthClientAuthMethod</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHCLIENTAUTHMETHOD</code></td><td>Token-endpoint auth method: <code>client_secret_basic</code> or <code>client_secret_post</code>. Empty auto-detects. Only needed if sign-in fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error.</td></tr><tr><td>ID token algorithm</td><td><code>oauthIdTokenSigningAlg</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHIDTOKENSIGNINGALG</code></td><td><span style=\"color:rgb(32,32,32);\">The algorithm your provider signs ID tokens with, e.g.</span> <code>RS256</code><span style=\"color:rgb(32,32,32);\">,</span> <code>EdDSA</code><span style=\"color:rgb(32,32,32);\">,</span> <code>ES256</code><span style=\"color:rgb(32,32,32);\">. Empty auto-detects from the provider. Only needed if sign-in fails with an</span> <code>unexpected JWT alg</code> <span style=\"color:rgb(32,32,32);\">error.</span></td></tr></tbody></table></figure><p>Asterisk (*) marks a required field</p></li><li><p>The default OAuth issuer is Google. To use other services such as Authentik or Auth0, you can configure the settings via <code>oauthIssuerBaseUrl</code>, <code>oauthIssuerName</code>, and <code>oauthIssuerIcon</code> in the <code>config.ini</code> file. Alternatively, these values can be set using environment variables:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>Issuer base URL</td><td><code>oauthIssuerBaseUrl</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERBASEURL</code></td><td>Either the issuer itself (<code>https://auth.example.com</code>) or a full discovery URL (<code>https://auth.example.com/.well-known/openid-configuration</code>). <br> <br>A URL containing <code>/.well-known/</code> is used as-is<span style=\"color:rgb(32,32,32);\">, which is convenient when your provider hands you a discovery URL to copy. A trailing slash may be included or omitted; Trilium matches whichever spelling the provider advertises.</span> <br> <br>Use the full form when your provider advertises an issuer that differs from the path serving its discovery document, such as Authentik in \"global\" issuer mode.</td></tr><tr><td>Issuer name</td><td><code>oauthIssuerName</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERNAME</code></td><td>The name of your authentication provider, used for reference on the login screen and in settings. Default is “Google”.</td></tr><tr><td>Issuer icon</td><td><code>oauthIssuerIcon</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHISSUERICON</code></td><td>Optionally, the URL to a logo of the provider. By default it will try to obtain the favicon from the website, so it's optional.</td></tr></tbody></table></figure><p>All the fields here are optional, since the default OAuth issuer is Google.</p></li><li><p>Optionally, tune the following advanced settings. All are optional and have sensible defaults:</p><figure class=\"table\"><table><thead><tr><th>Configuration</th><th><code>config.ini</code> in <code>[MultiFactorAuthentication]</code> section</th><th>Environment variable</th><th>Description</th></tr></thead><tbody><tr><td>HTTP timeout</td><td><code>oauthHttpTimeout</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHHTTPTIMEOUT</code></td><td>Timeout in milliseconds for the provider HTTP requests (discovery, token exchange, userinfo). Defaults to <code>30000</code> (30s). Raise this if your provider cold-starts slowly and you are occasionally asked to sign in twice. Minimum accepted value is <code>500</code>.</td></tr><tr><td>Scopes</td><td><code>oauthScope</code></td><td><code>TRILIUM_MULTIFACTORAUTHENTICATION_OAUTHSCOPE</code></td><td>Space-separated list of OIDC scopes requested at login. Defaults to <code>openid profile email</code>. <code>openid</code> is required and is prepended automatically if you omit it.</td></tr></tbody></table></figure><p>The OIDC session lifetime is automatically bound to Trilium's own session cookie lifetime (the <code>cookieMaxAge</code> setting in the <code>[Session]</code> section, 21 days by default), so a single sign-in stays valid for as long as your Trilium session does rather than expiring early on the OIDC library's shorter internal defaults.</p></li><li><p>Restart the server so that the changes are applied.</p></li></ol><aside class=\"admonition note\"><p>Legacy environment variables are also supported: <code>TRILIUM_OAUTH_BASE_URL</code>, <code>TRILIUM_OAUTH_CLIENT_ID</code>, <code>TRILIUM_OAUTH_CLIENT_SECRET</code>, and for customizing the provider: <code>TRILIUM_OAUTH_ISSUER_BASE_URL</code>, <code>TRILIUM_OAUTH_ISSUER_NAME</code>, <code>TRILIUM_OAUTH_ISSUER_ICON</code>, <code>TRILIUM_OAUTH_HTTP_TIMEOUT</code>, <code>TRILIUM_OAUTH_SCOPE</code>, <code>TRILIUM_OAUTH_CLIENT_AUTH_METHOD</code>, <code>TRILIUM_OAUTH_ID_TOKEN_SIGNING_ALG</code>.</p></aside><h2>Connecting to the authentication provider</h2><p>Once the server has been configured at the previous step, the next step is to create a link between your account on the authentication provider and the Trilium instance. This makes sure that only you can access the Trilium instance, and not just any other valid account.</p><p>To do so:</p><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Password & Auth.</em></li><li>In the <em>Sign-in with</em> field, choose <em>OpenID Connect provider.</em></li><li>In the <em>OpenID Connect</em> section, look for the <em>Connect account</em> (<span class=\"tn-icon bx bx-log-in\"></span>) button.</li><li>This will redirect you to your authentication provider, where you can sign in or confirm the action if needed.</li><li>Once you are authenticated you will be redirected back to the Trilium application.</li></ol><h2>Logging out</h2><p>When logging out of Trilium, a request is made to the authentication provider to log out from there as well. This feature depends on the authentication provider, so it may not be honored (Google and Authelia are known cases in which they don't respect the logout feature).</p><h2>Switching providers</h2><p>When switching providers (e.g. going from Google to Authelia), it's important to take the following steps:</p><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Password & Auth</em>.</li><li>In the <em>OpenID Connect</em> section, press the <em>Disconnect</em> (<span class=\"tn-icon bx bx-trash\"></span>) button.</li><li>Wait for the section to indicate that you are disconnected.</li><li>Change the configuration pointing to the new provider.</li><li>Restart your server.</li><li>Repeat the normal steps to connect to the authentication provider.</li></ol><p>Failing to disconnect before switching providers might temporarily lock you in, as you will not be able to login (credentials won't match). Should this happen:</p><ol><li>Modify the server configuration again to your old provider.</li><li>Restart the server and follow the disconnect instructions above.</li><li>Modify the server configuration again to your new provider.</li><li>Restart again the server.</li></ol><h2>Deactivating OpenID Connect temporarily</h2><p>To disable the OpenID Connect authentication and instead rely on the local password temporarily, you must:</p><ol><li>Modify the <code>config.ini</code> or environment variables (depending on how you set up the provider information) and temporarily deactivate the multi-factor authentication section by renaming <code>[MultiFactorAuthentication]</code> to something else (e.g. <code>[MultiFactorAuthentication.bak]</code>.</li><li>Restart the server for the changes to take effect.</li></ol><h2>Troubleshooting</h2><h3>Setup fails with a <code>WWW-Authenticate</code> or <code>invalid_client</code> error</h3><p>Your provider disagrees with Trilium about how client credentials should be sent to the token endpoint. Set <code>oauthClientAuthMethod</code> to <code>client_secret_post</code> (or <code>client_secret_basic</code> if it's already set to post) and restart. Providers vary: some reject <code>client_secret_post</code> outright because the method is fixed when the client is registered (e.g. Authelia), so if one value doesn't work, try the other.</p><h3>Setup fails with <code>invalid user</code></h3><p>If you are running behind a <a href=\"#root/_help_vcjrb3VVYPZI\">reverse proxy</a>, a buffer overflow can also cause this issue. Here is a sample fix for <a class=\"reference-link\" href=\"#root/_help_ud6MShXL4WpO\">Nginx</a>: </p><pre><code class=\"language-text-x-trilium-auto\">proxy_buffer_size 128k;\nproxy_buffers 4 256k;\nproxy_busy_buffers_size 256k;</code></pre><h3>Setup fails with an <code>unexpected JWT alg</code> error</h3><p>Depending on your version the message reads <code>unexpected JWT \"alg\" header parameter</code> or <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>. Both mean the same thing: your provider signs ID tokens with an algorithm other than RS256. Pocket ID (Ed25519) and Kanidm (ES256) do this.</p><p>From v0.104.2 Trilium detects the algorithm from your provider automatically, and the log records the outcome (<code>OAuth: the issuer does not sign ID tokens with RS256; expecting ES256</code>). If detection can't reach the provider it falls back to RS256, so check that the issuer URL is correct and reachable first. Should it still fail, set <code>oauthIdTokenSigningAlg</code> explicitly to the algorithm your provider uses.</p><h3>Setup fails with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code></h3><p>Make sure the base URL is correct and that the identity provider actually supports OpenID Connect. Some providers such as GitHub offer only OAuth 2.0.</p>",
"_help_IgkTHSaFfq6A": "<p>This page contains instructions on how to set up <a class=\"reference-link\" href=\"#root/_help_x1lQNKQBqLcA\">Signing in with OpenID Connect</a> with various providers such as Authelia, GitLab, Google.</p><aside class=\"admonition note\"><p>While the configuration reference is correct and up to date, the steps to create the OAuth application might differ slightly as providers change their UI.</p></aside><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Authelia</p><div class=\"trilium-tab-panel\"><ol><li><p>Generate a client secret:</p><pre><code class=\"language-text-x-trilium-auto\">authelia crypto hash generate pbkdf2 --variant sha512 --random --random.length 72 --random.charset rfc3986\n</code></pre><p><code>Random Password</code> goes to Trilium, <code>Digest</code> (the <code>$pbkdf2-sha512$…</code> string) goes to Authelia.</p></li><li><p>Add a client under <code>identity_providers.oidc.clients</code> in Authelia's <code>configuration.yml</code>, replacing <code><server></code> with the URL of your Trilium instance:</p><pre><code class=\"language-text-x-yaml\">identity_providers:\n oidc:\n clients:\n - client_id: 'trilium'\n client_name: 'Trilium'\n client_secret: '<Digest>'\n public: false\n authorization_policy: 'two_factor'\n redirect_uris:\n - 'https://<server>/callback'\n scopes:\n - 'openid'\n - 'profile'\n - 'email'</code></pre><p>Unlike GitLab, <code>client_id</code> is a name you choose rather than one the provider generates.</p></li><li><p>Restart Authelia.</p></li></ol><p>Adjust <code>config.ini</code>, using the <code>Random Password</code> from step 1:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://<server>\noauthClientId=<ClientId>\noauthClientSecret=<RandomPassword>\noauthIssuerBaseUrl=https://<server>\noauthIssuerName=Authelia</code></pre><aside class=\"admonition important\"><p>Do <strong>not</strong> set <code>oauthClientAuthMethod</code> for Authelia. It defaults confidential clients to <code>client_secret_basic</code> and rejects any other method with <code>invalid_client</code>, which is the default Trilium already uses. This is the opposite of the GitLab case below.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-gitlab\"></span> GitLab</p><div class=\"trilium-tab-panel\"><ol><li>Go to user settings on <a href=\"https://gitlab.com/-/user_settings/applications\">gitlab.com</a> or your own self-hosted instance.</li><li>Press <em>Add new application</em>.</li><li>Give it a name (e.g. Trilium).</li><li>Set <em>Redirect URI</em> to <code>https://<server>/callback</code></li><li>Make sure <em>Confidential</em> is checked and <em>Device authorization grant</em> is unchecked.</li><li>Under scopes, check <em>openid</em>, <em>profile</em> and <em>email</em> (they should be near the end).</li><li>Save the application and copy the <em>Application ID</em> and <em>Secret</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code><ApplicationId></code> and <code><Secret></code> with the values from the last step as well as the <code><server></code> with a URL to your Trilium instance.</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://<server>\noauthClientId=<ApplicationId>\noauthClientSecret=<Secret>\noauthIssuerBaseUrl=https://gitlab.com\noauthIssuerName=GitLab\noauthClientAuthMethod=client_secret_post\n</code></pre><aside class=\"admonition important\"><p>If you are using a self-hosted instance of GitLab, make sure to also update <code>oauthIssuerBaseUrl</code>, and keep the <code>oauthClientAuthMethod</code> line above.</p><p>GitLab's token endpoint does not decode credentials sent via HTTP Basic, so without <code>oauthClientAuthMethod</code>, sign-in fails with a <code>server responded with a challenge in the WWW-Authenticate HTTP Header</code> error. Trilium applies this automatically for <code>gitlab.com</code>, but a self-hosted issuer URL cannot be detected.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Kanidm</p><div class=\"trilium-tab-panel\"><ol><li><p>Create the client, add the redirect URL and grant the scopes, replacing <code><server></code> with the URL of your Trilium instance and <code><group></code> with an existing Kanidm group whose members may sign in:</p><pre><code class=\"language-text-x-trilium-auto\">kanidm system oauth2 create trilium \"Trilium\" \"https://<server>\"\nkanidm system oauth2 add-redirect-url trilium \"https://<server>/callback\"\nkanidm system oauth2 update-scope-map trilium <group> openid profile email</code></pre><p>The <code>openid</code> scope is mandatory; without it Kanidm treats the client as plain OAuth 2.0.</p></li><li><p>Read the client secret:</p><pre><code class=\"language-text-x-trilium-auto\">kanidm system oauth2 show-basic-secret trilium</code></pre></li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code><idm></code> with the URL of your Kanidm instance and <code><BasicSecret></code> with the value from step 2:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://<server>\noauthClientId=trilium\noauthClientSecret=<BasicSecret>\noauthIssuerBaseUrl=https://<idm>/oauth2/openid/trilium\noauthIssuerName=Kanidm</code></pre><p>The client name you chose in step 1 is both the client ID and the last path segment of the issuer URL, so the two must match.</p><aside class=\"admonition important\"><p>Kanidm signs ID tokens with ES256, not RS256. Trilium detects this from the provider on v0.105.0 and later, so no extra configuration is needed. Do <strong>not</strong> run <code>kanidm system oauth2 warning-enable-legacy-crypto</code>, it downgrades the client to RS256 and disables ES256 entirely. On older Trilium versions sign-in fails with an <code>unexpected JWT alg</code> error.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Pocket ID</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Pocket ID is passwordless, signing in requires a passkey. Register one and confirm you can sign in to Pocket ID itself <em>before</em> switching Trilium over to OpenID Connect, otherwise you may find yourself unable to authenticate at either end.</p></aside><ol><li>Sign in to Pocket ID as an administrator and go to <em>OIDC Clients</em> → <em>Add OIDC Client</em>.</li><li>Give it a name (e.g. Trilium).</li><li>Set <em>Callback URLs</em> to <code>https://<server>/callback</code>, replacing <code><server></code> with the URL of your Trilium instance.</li><li>Save, then copy the <em>Client ID</em>, <em>Client Secret</em> and <em>OIDC Discovery URL</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, using the values from step 4:</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://<server>\noauthClientId=<ClientID>\noauthClientSecret=<ClientSecret>\noauthIssuerBaseUrl=<OIDCDiscoveryURL>\noauthIssuerName=Pocket ID</code></pre><aside class=\"admonition note\"><p>Pocket ID gives you an <em>OIDC Discovery URL</em> ending in <code>/.well-known/openid-configuration</code>. On v0.105.0 and later you can paste it as-is. On earlier versions, remove that suffix and use only the part before it.</p></aside><aside class=\"admonition important\"><p>Pocket ID generates an RS256 signing key on first start, which works without further configuration. If you rotate it to Ed25519 (<code>pocket-id key-rotate --alg EdDSA --crv Ed25519</code>), ID tokens are signed with EdDSA instead. Trilium detects this automatically on v0.105.0 and later; older versions fail with <code>unexpected JWT alg received, expected RS256, got: EdDSA</code>.</p></aside></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span style=\"--tn-color:#e64d4d;color:#e64d4d;\"><span class=\"tn-icon bx bx-x\"></span> GitHub</span></p><div class=\"trilium-tab-panel\"><p>GitHub cannot be used as an identity provider because it is plain OAuth 2.0 and not OpenID Connect, so it will fail with <code>OAUTH_RESPONSE_IS_NOT_CONFORM</code>.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-google\"></span> Google</p><div class=\"trilium-tab-panel\"><ol><li>Go to <a href=\"https://console.cloud.google.com/auth/clients\">Google Cloud's Clients</a> dashboard and select <em>Create client</em>.</li><li>For <em>Application type,</em> select <em>Web application</em>.</li><li>In <em>Authorized redirect URIs</em>, set <code>https://<server>/callback</code>.</li><li>Press <em>Create</em> and copy <em>Client ID</em> and <em>Client secret</em>.</li></ol><p>Adjust <code>config.ini</code> as follows, replacing <code><ClientID></code> and <code><ClientSecret></code> with the values from the last step as well as the <code><server></code> with a URL to your Trilium instance.</p><pre><code class=\"language-text-x-trilium-auto\">[MultiFactorAuthentication]\noauthBaseUrl=https://<server>\noauthClientId=<ClientID>\noauthClientSecret=<ClientSecret></code></pre></div></section></div>",
"_help_yeEaYqosGLSh": "<p>As an alternative to <a href=\"#root/_help_Dgg7bR3b6K9j\">hosting your own Trilium instance</a>, there are two services out there that provide out of the box support for Trilium.</p><aside class=\"admonition important\"><p><strong>Disclaimer</strong>: The Trilium Notes project and maintainers are not directly affiliated with either of the projects.</p><p>PikaPods have gracefully offered us free credits for testing purposes.</p></aside><h2>Cloud instance providers</h2><h3>PikaPods</h3><ol><li>Go to <a href=\"https://www.pikapods.com\">pikapods.com</a> and sign up.</li><li>In the “Available Apps” section, look for \"TriliumNext<br> and select “Run your own”.</li><li>Follow the on-screen instructions to set up your own cloud hosted instance.</li></ol><p>PikaPods generally updates their Trilium instances to the latest version within a two-week interval after a new version is released.</p><h2>Matching your version with the cloud instance</h2><p>Please note that once you set up <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> between a cloud instance and <a href=\"#root/_help_poXkQfguuA0U\">desktop</a> clients, it's important that the version of the desktop application and the server match up.</p><p>When setting up a cloud instance, it's best to check the version of the server by accessing it via a web browser and going to the <em>About</em> section. It's best that both the desktop and the server have the same <em>App version</em>; however it's generally OK to update the desktop to a newer version than the server if it has the same <em>Sync version</em>.</p><p>If the <em>Sync version</em> between the server and the desktop application doesn't match, synchronization will not work.</p>",
"_help_iGTnKjubbXkA": "<ul><li>Using Docker, the server can be run on Windows, Linux and macOS devices.</li><li>Native binaries are provided for Linux x64 and ARM (<code>aarch64</code>).</li></ul><h2>Legacy ARM support</h2><p>The Docker builds also provide <code>linux/arm/v7</code> and <code>linux/arm/v8</code> platforms. These platforms are considered legacy since Trilium uses Node.js version 24 which have <a href=\"https://github.com/nodejs/node/commit/6682861d6f\">officially downgraded support</a> for these platforms to “experimental”.</p><p>As a result, Trilium needs to use Node.js 22 for these versions. As soon as soon Node.js 22 will no longer be compatible, support for <code>armv7</code> and <code>armv8</code> will be dropped entirely.</p><p>Regardless of upstream support, these platforms are supported on a best-effort basis and are not officially supported by the Trilium development team. Bug reports are accepted but they will not be treated with priority; contributions are welcome.</p>",
"_help_cbkrhQjrkKrh": "<p>Trilium is an offline-first note-taking application that stores all data locally on the desktop client. However, it also offers the option to set up synchronization with a server instance, allowing multiple desktop clients to sync with a central server. This creates a star-shaped topology:</p><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_image.jpg\"></p><p>In this setup, a central server (referred to as the <em>sync server</em>) and multiple <em>client</em> (or <em>desktop</em>) instances synchronize with the sync server. Once configured, synchronization is automatic and ongoing, requiring no manual intervention.</p><h2>Setting Up Synchronization</h2><h3>Security Considerations</h3><p>Setting up the server securely is critical and can be complex. It is crucial to use a valid <a href=\"#root/_help_l2VkvOwUNfZj\">TLS certificate</a> (HTTPS) rather than an unencrypted HTTP connection to ensure security and avoid potential vulnerabilities.</p><h3>Synchronizing a Desktop Instance with a Sync Server</h3><p>This method is used when you already have a desktop instance of Trilium and want to set up a sync server on your web host.</p><ol><li><strong>Server Deployment</strong>: Ensure your server instance is deployed but uninitialized.</li><li><strong>Desktop Configuration</strong>: Open your desktop instance, navigate to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Sync</em> → <em>Sync server</em>, and set the <em>Server address</em> to your sync server's address.<ul><li>Note that the sync server can also be overridden through <a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a>, case in which that value takes precedence. If that's the case, a field called <em>Server in use</em> indicates it.</li></ul></li><li><strong>Testing Sync</strong>: Click the <em>Test sync</em> button to verify the connection to the sync server.<ul><li>If successful, the client will start pushing all data to the server instance.</li><li>This process may take some time, but you can continue using Trilium. Periodically check the server instance to confirm when the sync is complete. Once finished, you should see the login screen on the server.</li></ul></li></ol><h3>Synchronizing a Desktop Instance from a Sync Server</h3><p>This method is used when you already have a sync server and want to configure a new desktop instance to sync with it.</p><ol><li><strong>Desktop Setup</strong>: Follow the <a href=\"#root/_help_poXkQfguuA0U\">desktop installation page</a>.</li><li><strong>Initial Configuration</strong>: When prompted, choose the option to set up sync with a sync server.</li></ol><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_sync-init.png\" alt=\"screenshot of the sync from server setup page\"></p><ol><li><strong>Server Details</strong>: Configure the Trilium server address and enter the server's password. If the server has <a class=\"reference-link\" href=\"#root/_help_7DAiwaf8Z7Rz\">Multi-factor authentication with TOTP</a> enabled, also enter a one-time password from your authenticator app, or a recovery code.</li><li><strong>Finish Setup</strong>: Click the \"Finish setup\" button. If successful, you will see the following screen:</li></ol><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Synchronization_sync-in-progress.png\" alt=\"screenshot of the sync page\"></p><p>Once synchronization is complete, you will be automatically redirected to the Trilium application.</p><h3>Desktop-to-desktop sync</h3><p>This method allows two desktop instances to synchronize between each other without requiring a <a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>.</p><aside class=\"admonition warning\"><p>Since v0.104.0, LAN access needs to be enabled to allow this sync to function. See <a class=\"reference-link\" href=\"#root/_help_swSFivWk6KkA\">Network Access</a> for information on how to do so.</p></aside><h2>Proxy Configuration</h2><p>Two proxy setups are supported:</p><ul><li><strong>Explicit Proxy Configuration</strong>: Set the proxy server in Options / Sync. Only unauthenticated proxy servers are supported.</li><li><strong>System Proxy Settings</strong>: If no proxy server is explicitly configured, Trilium will use the system proxy settings.</li></ul><h2>Troubleshooting</h2><h3>Date/Time Synchronization</h3><p>For successful synchronization, both client and server must have the same date and time, with a tolerance of up to five minutes.</p><h3>Certificate Issues</h3><p>When using TLS, Trilium will verify the server certificate. If verification fails (e.g., due to self-signed certificates or certain corporate proxies), you can run the Trilium client with the <code>NODE_TLS_REJECT_UNAUTHORIZED</code> environment variable set to <code>0</code>:</p><pre><code class=\"language-text-x-trilium-auto\">export NODE_TLS_REJECT_UNAUTHORIZED=0</code></pre><p>This will disable TLS certificate verification, significantly reducing security and exposing the setup to MITM attacks. It is strongly recommended to use a valid signed server certificate. Newer Trilium versions include a script called <code>trilium-no-cert-check.sh</code> for this purpose.</p><h3>Conflict Resolution</h3><p>If you edit the same note on multiple instances before synchronization, Trilium resolves conflicts by retaining the newer change and discarding the older one. The older version remains accessible in <a href=\"#root/_help_vZWERwf8U3nx\">note revisions</a>, allowing data recovery if needed.</p><h3>Hash Check</h3><p>After each synchronization, Trilium computes a hash of all synced data on both the client and the sync server. If there is a discrepancy, Trilium will automatically initiate a recovery mechanism to resolve the issue.</p>",
"_help_RDslemsQ6gCp": "<figure class=\"image image-style-align-right image_resized\" style=\"width:33.52%;\"><img style=\"aspect-ratio:1242/2688;\" src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Mobile%20Frontend_IMG_1765.PNG\" width=\"1242\" height=\"2688\"></figure><p>Trilium has a mobile web frontend which is optimized for touch based devices - smartphones and tablets. It is activated automatically during login process based on browser detection.</p><p>Mobile frontend is limited in features compared to the full desktop version. See below for more details on this.</p><h2>Layout basics</h2><p>Unlike the desktop version, the mobile version has a slightly different UI meant to better fit the constrained screens of a mobile phone.</p><p>Here is a non-exhaustive list of differences between the desktop version and the mobile one:</p><ul><li>On a phone, the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> lies under the note. The <span class=\"tn-icon bx bx-chevron-left\"></span> button in the top-left of the screen slides the note away to reveal the tree, on the folder holding the note, with the note highlighted. Opening a note from the tree slides it back in.<ul><li>To return to the note without opening it again, tap its title with the <span class=\"tn-icon bx bx-chevron-right\"></span> icon in the top-right of the tree, whichever folder the tree is showing.</li><li>A swipe from the left edge of the screen also reveals the tree, but the system's or the browser's back gesture can take it over, depending on the platform.</li><li>Each tab remembers whether it was showing the tree or its note, and, for a tab left on the tree, the folder the tree was showing. Switching tabs brings both back. Once the tab shows its note again, its tree goes back to the folder holding the note.</li><li>A new tab opens on the tree, at the root, with the <a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a> and the <a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>, if there are any, listed above it. Tap a workspace to hoist the tab into it.</li><li>In the Android app, the system back gesture or button closes the menu or dialog on top first, then a settings page in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, then slides the note away to reveal the tree, then goes up one level in the tree. At the top of the tree, it sends the app to the background.</li><li>On wider screens, such as a tablet in landscape, the note tree is displayed as a sidebar next to the note instead. There, a <span class=\"tn-icon bx bx-sidebar\"></span> button hides and shows it, and the choice is remembered together with the left pane of the desktop version.</li><li>A note with children shows a <span class=\"tn-icon bx bx-chevron-right\"></span> (on iOS, preceded by how many children it lists): tapping it lists its children, and tapping any other note opens it. The note whose children are listed stands at the top, with a preview of its content; tap it, or the <em>Open</em> at its foot, to open it.</li><li>Press and hold a note to display the <a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>. Opening a note in a new tab from it keeps the tree on screen, so you can open several notes in a row.</li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> bar is also displayed at the top of the note tree.</li><li>The full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> function can be triggered either from either the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> or from the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, if configured.</li><li>The <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> is shorter: <em>New window</em> and <em>Keyboard shortcuts</em> are left out, and <em>Switch to desktop version</em> is under <em>Advanced</em>.</li><li>The <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> is displayed at the bottom of the screen.<ul><li>The launch bar uses a different configuration for icons than the desktop version. See the dedicated page for more information on how to configure it.</li></ul></li><li>Most of the note-related actions are grouped in the horizontal dots icon on the top-right of the note.</li><li>The <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> is replaced by the note panel, a sheet that opens from the bottom of the screen with the <span class=\"tn-icon bx bx-dock-bottom\"></span> button to the left of those dots. Its tabs (outline, attributes, connections, AI chat and widgets) are switched from a bar at the bottom of the sheet.</li><li>In a text note, the formatting toolbar sits at the bottom of the screen. See <em>Editing text notes</em> below.</li><li>On iOS, the buttons of the title row, the launch bar, the formatting toolbar, the menus that open from the bottom of the screen and short dialogs are translucent panes that float clear of the screen's edges, and the note scrolls beneath the title row and the launch bar. A dialog taller than half the screen is opaque and attached to the bottom of the screen instead. To make the panes opaque, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> → <em>Performance</em> and turn off <em>Background effects for menus, popups and panels</em>. On Android, the option is not shown and they are always opaque.</li><li>While the on-screen keyboard is open, a <span class=\"tn-icon bx bxs-keyboard\"></span> button in the bottom-right corner, just above the keyboard, hides it. In a text note, the button is at the right end of the formatting toolbar. While a menu of the formatting toolbar is open in place of the keyboard, the button becomes a <span class=\"tn-icon bx bx-x\"></span>, which closes the menu and brings the keyboard back. This works in every note type and in every text field, and is the only way to hide the keyboard in the iOS app, where the keyboard has no <em>Done</em> button.</li><li>The <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a> are grouped under a tab switcher in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, where the tabs are displayed in a full-screen grid with preview for easy switching, as well as additional options such as reopening closed tabs. On a phone, a tab left on the note tree shows the folder it was on, with the tab's note highlighted, instead of a preview of the note.<ul><li>Swipe left or right anywhere on the launch bar to go to the next or previous tab without opening the switcher. This works while the tab switcher is in the launch bar and all of the bar's buttons fit on the screen; when they do not, swiping scrolls the bar instead. The page follows your finger and reaches the other tab as your finger reaches the edge of the screen: let go less than a third of the way there to stay on the current tab, unless you flick. Past the first or the last tab, the page only stretches a little and springs back when you let go.</li></ul></li><li>Since v0.100.0, <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a> can also be used in mobile view, but with a maximum of two panes at once. The splits are displayed vertically instead of horizontally.</li></ul><h2>Editing text notes</h2><h3>The formatting toolbar</h3><p>In a text note, the formatting toolbar sits at the bottom of the screen as a single row that scrolls sideways. It is shown only while you are editing the text, and hides when you hide the keyboard or move to another field, such as the note title. From left to right, it holds:</p><ul><li><em>Undo</em> and <em>Redo</em>, since the on-screen keyboard has no keys for them.</li><li>A highlighted button naming the element the cursor is in, such as <em>Table ›</em> or <em>List ›</em>, when it is in one. See <em>Tables, images and other elements</em> and <em>Lists</em> below.</li><li>The <span class=\"tn-icon cke cke-trilium-block-type\"></span> block type button, <span class=\"tn-icon cke cke-plus\"></span> to insert content, and <span class=\"tn-icon cke cke-text\"></span> for the formatting applied to text.</li><li><span class=\"tn-icon cke cke-link\"></span> to add a link and <span class=\"tn-icon cke cke-paper-clip\"></span> to attach a file.</li><li>The indentation buttons, then <span class=\"tn-icon cke cke-arrow-up\"></span> and <span class=\"tn-icon cke cke-arrow-down\"></span>, which move the current block, or the selected blocks, up or down, as <kbd>Alt</kbd>+<kbd>↑</kbd> and <kbd>Alt</kbd>+<kbd>↓</kbd> do on a keyboard. Inside a table they move the row instead.</li><li>The <span class=\"tn-icon cke cke-trilium-ai\"></span> AI assistant button, shown once a provider is configured, which opens its quick actions as a menu at the bottom of the screen, with <em>Ask AI…</em> at its top.</li></ul><p>While the keyboard is open, the <span class=\"tn-icon bx bxs-keyboard\"></span> button at the right end of the toolbar hides it.</p><p>The hints in the corner of the editor that explain the element under the cursor, such as a to-do item's state and its shortcut, are not shown, whatever the <em>Content hints</em> setting under <em>Options</em> → <em>Text Notes</em> → <em>Features</em>.</p><h3>Inserting content</h3><p>The <span class=\"tn-icon cke cke-plus\"></span> button opens insertions as tiles at the bottom of the screen:</p><ul><li>Image, table and to-do list.</li><li>Code block, block quote and admonition.</li><li>The less common collapsible, tabs, columns, horizontal line, page break, footnote, math, drawing canvas, Mermaid diagram, bookmark, link and content embeds, special characters, emoji, icon, date/time, template and Markdown import.</li></ul><p>The image is also under the paperclip, and the to-do list, code block, block quote and admonition are also in the block type button.</p><p>The tiles marked with <span class=\"tn-icon bx bx-chevron-right\"></span> open a list of choices:</p><ul><li><em>Code block</em>: the language.</li><li><em>Admonition</em>: its type.</li><li><em>Insert table</em>: the size of the table.</li><li><em>Columns</em>: the number of columns.</li><li><em>Footnote</em>: a new footnote or a reference to an existing one.</li><li><em>Date/time</em>: the format of the date and time.</li><li><em>Insert text snippet</em>: the template to insert. It is grayed out while there are none.</li></ul><h3>Block types</h3><p>The <span class=\"tn-icon cke cke-trilium-block-type\"></span> block type button opens the block types as tiles at the bottom of the screen, with the current one highlighted:</p><ul><li>Paragraph and heading 2 to 6.</li><li>Bulleted list, numbered list and to-do list.</li><li>Code block, block quote and admonition.</li></ul><p>Picking a paragraph or a heading in a list turns the item back into plain text, and the same goes for a code block. Block quote and admonition wrap the current block rather than replace it, so they are highlighted alongside it; pick one again to remove it.</p><p>Typing <code>-</code> , <code>1.</code> or <code>[ ]</code> at the start of a line also starts a list.</p><h3>Lists</h3><p>While the cursor is in a list, a <em>List ›</em> button follows <em>Undo</em> and <em>Redo</em>. Its row holds:</p><ul><li>The indentation buttons and the buttons that move the item up or down, as on the main row.</li><li><em>List type</em>, which opens the to-do list and the markers of bulleted and numbered lists (such as squares or roman numerals) as tiles, the markers under the kind of each, with the current one highlighted. Picking a tile of another kind also turns the list into that kind, such as a bulleted list into a numbered one or a to-do list back into a bulleted one.</li><li>In a numbered list, <em>Start at</em>, which asks for the number the list starts at, and <span class=\"tn-icon bx bx-sort-down\"></span> <em>Reversed order</em>, which is highlighted while the list counts down.</li><li>In a to-do list, a button for each task state, followed by <span class=\"tn-icon bx bx-pencil\"></span> to edit the states.</li></ul><p>Starting a list, from the block type button, the insert menu or by typing <code>-</code> , <code>1.</code> or <code>[ ]</code>, shows this row right away. It stays closed once you tap the back button, until you start another list.</p><h3>Tables, images and other elements</h3><p>While the cursor is in a table, an image, a code block, a link or another element that has a toolbar of its own on desktop, a highlighted button naming that element, such as <em>Table ›</em>, follows <em>Undo</em> and <em>Redo</em>. It replaces the formatting toolbar with the element's toolbar, which starts with a back button that closes it again, followed by the element's name ahead of its tools. The button goes away when the cursor leaves the element.</p><p>Selecting an element as a whole, such as an image, or tapping a link shows its toolbar right away; tap the back button to return to the formatting toolbar.</p><p>Buttons of the element's toolbar with a list of choices, such as the column and row actions of a table, open that list as a menu at the bottom of the screen, where an option that is on or off, such as a table's header row, is a switch.</p><h3>Formatting text</h3><p>The formatting applied to text (bold, italic, underline, strikethrough, inline code, superscript and subscript, keyboard shortcut, font size and colors, and removing formatting) is on a row of its own, followed by the left, center, right and justify alignments of the current block, with the current one highlighted. The row ends with <span class=\"tn-icon cke cke-trilium-scissors\"></span> to cut the selection into a sub-note.</p><ul><li>Tap <span class=\"tn-icon cke cke-text\"></span> after the <span class=\"tn-icon cke cke-plus\"></span> button to show it, and <span class=\"tn-icon cke cke-previous-arrow\"></span> at its start to return to the main row.</li><li>Selecting text shows this row on its own, and it goes back to the main row once the selection is gone (for example as you start typing), unless you opened or closed the row yourself in the meantime.</li></ul><p>The font size button opens the list of sizes as a menu at the bottom of the screen, each drawn at its size, with the current one checked.</p><p>A single color button replaces the separate text and background color buttons. It opens a menu with a row of colors for the text and one for its background, each with a cell that removes the color and one that opens the device's color picker.</p><h3>Links and attachments</h3><p>The <span class=\"tn-icon cke cke-link\"></span> link button replaces the separate link and internal link buttons. It opens the <em>Add link</em> dialog, which links to a note or to a web address, or <em>Edit link</em> when the cursor is inside a link. The dialog does not open the keyboard by itself; tap the note or address field to type. The same button is on the row of text formatting, after the inline styles, to turn selected text into a link.</p><p>The <span class=\"tn-icon cke cke-paper-clip\"></span> button opens <em>Image</em>, <em>Camera</em>, <em>Attach and embed file</em> and <em>Attach file as a link</em> as a list: the menu of the desktop toolbar, with <em>Camera</em> added. <em>Camera</em> opens the device's camera and inserts the photo taken; the others open the device's file picker.</p><h2>Installing as a PWA</h2><p>The mobile view can be set up as a PWA. While this does not offer any offline capabilities, it will display the application in full-screen and makes it easy to access via your mobile phone's home screen.</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span> iOS with Safari</p><div class=\"trilium-tab-panel\"><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the […] button in the bottom-right of the screen and select Share.</li><li>Scroll down to reveal the full list of items and choose <em>Add to Home Screen</em>.</li><li>Press <em>Add</em> and the web app will be available.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-chrome\"></span> Android with Google Chrome</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Google Chrome requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).</p></aside><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the three vertical dots icon in the top-right of the screen and select <em>Add to Home screen.</em></li><li>Select the <em>Install</em> option.</li><li>Select an appropriate name.</li><li>The web app will appear as an application, not on the home screen.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Android with Brave</p><div class=\"trilium-tab-panel\"><aside class=\"admonition important\"><p>Brave requires the server to be served over HTTPS in order to display in full-screen. If using HTTP, the app will appear like a normal web page (similar to a bookmark).</p></aside><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the three vertical dots icon in the bottom-right of the screen and select <em>Add to Home screen</em>.</li><li>Press the <em>Install</em> option.</li><li>The web app will appear as an application, not on the home screen.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\">Samsung Browser</p><div class=\"trilium-tab-panel\"><ol><li>Open your default web browser and access your Trilium instance.</li><li>Login.</li><li>Press the hamburger menu in the bottom-right of the screen.</li><li>Select <em>Add to</em>, followed by <em>Home screen</em>.</li><li>Press <em>Add</em> and the web app will appear on the home page.</li></ol></div></section></div><h2>Sharing to Trilium</h2><p>Once installed as a PWA on Android, Trilium appears in the system's share menu, so links, text, images and other files can be sent to it from other apps. Shared content is saved to the <a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>, and Trilium opens the note it created:</p><ul><li>Text or a link becomes a text note. A shared link is also stored in the <code>#pageUrl</code> label.</li><li>A single file becomes an image note or a file note, placed directly in the inbox.</li><li>Several files, or files shared together with text, are placed under a new text note that holds the text.</li></ul><p>Every note created this way carries the <code>#clipType=share</code> label, which gives a shared text note the <span class=\"tn-icon bx bx-share\"></span> icon unless the note has an <code>#iconClass</code> of its own. A single share can carry at most 20 files.</p><aside class=\"admonition note\"><p>Sharing requires being logged in. If the session has expired, log in again and share once more.</p></aside><h2>Testing via the desktop application</h2><p>If you are running Trilium without a dedicated <a href=\"#root/_help_WOcw2SLH6tbX\">server installation</a>, you can still test the mobile application using the desktop application. For more information, see <a class=\"reference-link\" href=\"#root/_help_nRqcgfTb97uV\">Using the desktop application as a server</a>. To access it go to <code>http://<ip>:37840/login?mobile</code> .</p><h2>Forcing mobile/desktop frontend</h2><p>Trilium decides automatically whether to use mobile or desktop front-end. If this is not appropriate, you can use <code>?mobile</code> or <code>?desktop</code> query param on <strong>login</strong> page (Note: you might need to log out).</p><p>Alternatively, simply select <em>Switch to mobile version</em> in the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>. In the mobile version, select <em>Advanced</em> → <em>Switch to desktop version</em> there instead.</p><h2>Scripting</h2><p>You can alter the behavior with <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>, just like for normal frontend. For script notes to be executed, they need to have labeled <code>#run=mobileStartup</code>.</p><p>Custom <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> widgets are also supported. <a href=\"#root/_help_M8IppdwVHSjG\">Right pane widgets</a> are shown in the <em>Widgets</em> tab of the note panel.</p>",
"_help_MtPxeAWVAzMg": "<p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Web%20Clipper_image.png\"></p><p>Trilium Web Clipper is a web browser extension which allows user to clip text, screenshots, whole pages and short notes and save them directly to Trilium Notes.</p><h2>Supported browsers</h2><p>Trilium Web Clipper officially supports the following web browsers:</p><ul><li>Mozilla Firefox, using Manifest v2.</li><li>Google Chrome, using Manifest v3. Theoretically the extension should work on other Chromium-based browsers as well, but they are not officially supported.</li></ul><h2>Obtaining the extension</h2><p>The extension is available from the official browser web stores:</p><ul><li><strong>Firefox</strong>: <a href=\"https://addons.mozilla.org/firefox/addon/trilium-notes-web-clipper/\">Trilium Web Clipper on Firefox Add-ons</a></li><li><strong>Chrome</strong>: <a href=\"https://chromewebstore.google.com/detail/trilium-web-clipper/ofoiklieachadcaeffficgjaajojpkpi\">Trilium Web Clipper on Chrome Web Store</a></li></ul><h2>Functionality</h2><ul><li>select text and clip it with the right-click context menu</li><li>click on an image or link and save it through context menu</li><li>save whole page from the popup or context menu</li><li>save a PDF that the browser shows, as a file note</li><li>save a screenshot of an area you select, of the visible part of the page or of the whole page, from either popup or context menu</li><li>create short text note from popup</li></ul><h2>The popup</h2><p>Clicking the extension's button in the browser toolbar opens its popup:</p><ul><li><p>The popup shows what will be saved from the current page: the note's title, which can be edited before saving, the website, and below them a preview, which starts with a box for your own note and the page's description. A switch above the preview chooses what to save, among what the page offers:</p><ul><li><em>Selection</em>, when text is selected on the page: <em>Save selection</em> saves it into the note of that page's clippings, as the context menu does.</li><li><em>Page</em>: <em>Save page to Trilium</em> saves the page's text and images. A smaller switch at the top of the preview chooses how much of the page to keep: <em>Article</em> keeps only the page's main text, without its menus, sidebars and footers, and <em>Whole page</em> keeps everything the page shows. <em>Whole page</em> is for pages that are not an article (such as a gallery or a page of cards), where <em>Article</em> can leave out part of the content; the preview shows what each one keeps. <em>Article</em> is unavailable on a page where Trilium finds no article. The author the page names shows under the description, marked by the <span class=\"tn-icon bx bx-user\"></span> icon. It can be edited or cleared before saving, or written in when the page names none, and is saved in the <code>#pageAuthor</code> label of the note. When the page states when it was published, that date shows under the author, marked by the <span class=\"tn-icon bx bx-calendar\"></span> icon, and is saved in the <code>#publishedDate</code> label of the note. When it states when it was last modified, that date shows below, marked by the <span class=\"tn-icon bx bx-history\"></span> icon, and is saved in the <code>#modifiedDate</code> label.</li><li><em>PDF</em>, when the tab shows a PDF in the browser's viewer: <em>Save PDF to Trilium</em> downloads the PDF and saves it as a file note, which Trilium opens in its <a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a> viewer. Only the title and the description can be edited, since a file note has no text of its own for your note. The page's address is saved in the note's <code>#pageUrl</code> label and the PDF's file name in <code>#originalFileName</code>. Saving a PDF needs Trilium v0.107.0 or later.</li><li><em>Bookmark</em>, always: there is no preview, and <em>Save bookmark</em> saves a link to the page with your note as the content of the note. Left empty, the title stays the page's title.</li></ul><p>The box for your note, marked by the <span class=\"tn-icon bx bx-info-circle\"></span> icon, has the cursor when the popup opens, so a note (such as why the page is worth keeping) can be typed right away. It grows with its text, and keeps it when switching between <em>Selection</em>, <em>Page</em> and <em>Bookmark</em>. A note on a selection or a page is saved above the clipped content, in a <em>Note</em> admonition. Left empty, nothing is added. <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in any of the popup's fields saves, whichever is chosen.</p><p>The description, marked by the <span class=\"tn-icon bx bx-align-left\"></span> icon, comes from the page's <code>description</code> meta tag, or the one it gives social sites. It can be edited or cleared before saving, or written in when the page has none, and is saved in the <code>#pageDescription</code> label of the note. Clippings saved with the keyboard shortcuts or the context menu, screenshots and images included, get the description as the page gives it. Each clipping that brings a description updates the label. The description, the author and the dates are shown by clicking the <em>Web clip</em> badge next to the title of the note (see <a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a>).</p><p>The popup opens on the selection if there is one, otherwise on <em>Page</em>, showing the article, or the whole page when the page has no article. On a PDF, it opens on <em>PDF</em>. On a page that shows nothing to save, it opens on <em>Bookmark</em> and says so. The keyboard shortcuts and the context menu still save right away, without a preview: saving the whole page that way saves the article, the whole page when the page has no article, or the PDF when the tab shows one.</p></li><li><p>Pages the extension cannot access (the browser's own pages, the extension stores, and pages that were open before the extension was installed until they are reloaded) cannot be saved or captured, so the popup says so in place of the preview, and only <em>All tabs</em> remains available there.</p></li><li><p>Below the preview, a row of buttons offers the other actions: <em>Area</em> (a screenshot of an area you select), <em>Visible</em> (a screenshot of the visible part of the page), <em>Full page</em> (a screenshot of the whole page) and <em>All tabs</em> (saves the links of every tab in the current window as a list of <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>, or of plain links when <em>Autogenerate link previews</em> is turned off). Hovering over a button shows its full name and, if it has one, its keyboard shortcut.</p></li><li><p><em>Full page</em> scrolls through the page, takes a screenshot of each part and joins them into one image, then scrolls back to where the page was. The scrollbars are hidden while it does, so they do not appear in the image. Stay on the tab until it is saved: switching to another tab stops the screenshot. A header that stays at the top of the window appears once, at the top of the image, and headings that stick while scrolling appear where they are in the page. Other elements that stay in place while scrolling (such as cookie banners and chat buttons) are left out, while a background that fills the whole window repeats on every screen. In Firefox, the page is captured without scrolling through it, which is faster: such a background then appears only at the top, and images that the page loads only once they are scrolled into view can be missing. A long page is saved as several images, one below the other in the note. A page longer than 100 screens is cut off there, and the message after saving says so. Screenshots keep their full height in Trilium: <em>Resize image</em> (under <em>Automatically compress images</em> in Options → Media) limits only their width.</p></li><li><p>The popup stays open while Trilium saves, which can take a few seconds for a long page or a large PDF, and the other actions wait until it is done. The bar at the top of the popup then says, in green, that the clipping was saved (in place of the notice that the page was already clipped), with <em>Open note</em> to open it in Trilium (and, after <em>All tabs</em>, <em>Close saved tabs</em>), or, in red, why it could not be saved. The same clipping cannot be saved twice by accident: the save button stays disabled until another mode is chosen. <em>Crop</em> is the exception: the popup closes so that an area of the page can be selected, and the notification on the page reports the outcome.</p></li><li><p>If the current page was already clipped, a notice at the top offers to open the note in Trilium.</p></li><li><p>If Trilium cannot be found, the popup explains why instead of showing the actions, with buttons to look for Trilium again and to open the options.</p></li><li><p>The bottom of the popup shows whether the extension is connected to Trilium, as a colored dot (green when connected, amber when the versions are not compatible, red when Trilium was not found) next to a description of the connection, followed by the buttons for the extension's options and for this help page. A button to check the connection again appears next to them when hovering over the bar, and stays visible while Trilium cannot be reached or is not compatible.</p></li></ul><h2>Location of clippings</h2><p>Trilium will save these clippings as a new child note under a \"clipper inbox\" note.</p><p>By default, that's the <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a> but you can override that by setting the <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>clipperInbox</code>, on any other note.</p><p>Further clippings of the same kind from the same page are added to the note created by the first one, even on a later day or after that note was moved out of the clipper inbox. The note stays where it is and is not cloned back into the inbox. A PDF is the exception: each save creates a new file note, since the PDF can have changed since it was last saved.</p><p>The icon of a clipped note shows what was saved:</p><ul><li><span class=\"tn-icon bx bx-paperclip\"></span> a selection, a screenshot or a link from the context menu;</li><li><span class=\"tn-icon bx bx-globe\"></span> a page (<em>Article</em> or <em>Whole page</em>);</li><li><span class=\"tn-icon bx bx-bookmark\"></span> a bookmark;</li><li><span class=\"tn-icon bx bx-window-alt\"></span> the tabs of a window.</li></ul><p>The icon is derived from the note's <code>#clipType</code> label, so setting an <code>#iconClass</code> label on the note replaces it. A saved PDF has the icon of a PDF file, like any other PDF in Trilium.</p><h2>Embedded videos</h2><p>A YouTube video embedded in a clipped page is saved as a <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a> embed, with the video's title and thumbnail. As with a link preview added in the editor, the video plays only when clicked. Other embedded content (such as videos from other websites) is not saved.</p><p>The popup's preview shows each such video as a chip with the YouTube icon and the video's short link, and leaves out the embedded content that will not be saved.</p><h2>Keyboard shortcuts</h2><p>Keyboard shortcuts are available for most functions:</p><ul><li>Save selected text: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li><li>Save whole page: <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd> (Mac: <kbd>⌥</kbd>+<kbd>⇧</kbd>+<kbd>S</kbd>)</li><li>Save a screenshot of an area: <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>E</kbd> (Mac: <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>E</kbd>)</li><li>Save all tabs of the current window: no default shortcut, but one can be assigned as described below.</li><li>Save a screenshot of the whole page: no default shortcut, but one can be assigned as described below.</li></ul><p>To set custom shortcuts, follow the directions for your browser.</p><ul><li><strong>Firefox</strong>: <code>about:addons</code> → Gear icon ⚙️ → Manage extension shortcuts</li><li><strong>Chrome</strong>: <code>chrome://extensions/shortcuts</code></li></ul><aside class=\"admonition note\"><p>On Firefox, the default shortcuts interfere with some browser features. As such, the keyboard combinations will not trigger the Web Clipper action. To fix this, simply change the keyboard shortcut to something that works. The defaults will be adjusted in future versions.</p></aside><h2>Configuration</h2><p>The extension needs to connect to a running Trilium instance. By default, it looks for the desktop application on port 37840 of the local computer. If the desktop application runs on a different port (for example because it was started with the <code>TRILIUM_PORT</code> environment variable), enter that port in the extension's options. The extension checks for Trilium again every minute, or right away when pressing the refresh button at the bottom of its popup.</p><p>It's also possible to configure the <a href=\"#root/_help_WOcw2SLH6tbX\">server</a> address if you don't run the desktop application, or want it to work without the desktop application running.</p><p>To connect to a server, enter its address and your password in the extension's options and press <em>Login to the server instance</em>. If the server uses <a href=\"#root/_help_7DAiwaf8Z7Rz\">multi-factor authentication</a>, also fill in <em>Authentication code</em> with the current code from your authenticator app (or one of your recovery codes); otherwise leave it empty. The password and the code are used only once, to obtain a token for the extension, and are not stored.</p><h3>When a clipping fails</h3><p>After each clipping made with a keyboard shortcut or the context menu, a notification in the corner of the page confirms that it was saved, with a link to open the new note in Trilium. A clipping made from the popup reports in the popup instead, unless the popup was closed before it was saved. If the clipping could not be saved, the message says why instead:</p><ul><li>Trilium was not found: start the desktop application, or check the server address and token in the extension's options.</li><li>The versions of Trilium and the extension are not compatible: update the one the message names.</li><li>Trilium rejected the request: the message includes the reason Trilium gave.</li><li>The popup could not reach the extension's background script, or it gave no answer: close the popup and open it again. If the extension was just updated or reloaded, reload the page as well.</li><li>A PDF could not be saved: Trilium is older than v0.107.0, the website refused to send the PDF again, or the PDF is larger than 100 MB. The extension downloads the PDF with the browser's cookies for that website, so a PDF behind a login can be saved while you are logged in.</li></ul><p>The extension downloads the images of a clipping itself, so that they are stored in Trilium together with the note. If some of them cannot be downloaded (for example because the website refuses the request), the clipping is still saved, and the notification says how many images are missing. Those images keep their address on the original website: Trilium tries to download them once more if <em>Download images automatically</em> is enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>, and otherwise the note shows them from the website for as long as it serves them.</p><p>The notification is shown on the page itself, so it does not appear on pages where extensions cannot run (such as the browser's own settings pages, the extension stores and Firefox's PDF viewer). A clipping saved from the popup on such a page still reports in the popup.</p><h2>Testing development versions</h2><p>Development versions are version pre-release versions, generally meant for testing purposes. These are not available in the Google or Firefox web stores, but can be downloaded from either:</p><ul><li><a href=\"https://github.com/TriliumNext/Trilium/releases\">GitHub Releases</a> by looking for releases starting with <em>Web Clipper.</em></li><li>Artifacts in GitHub Actions, by looking for the <a href=\"https://github.com/TriliumNext/Trilium/actions/workflows/web-clipper.yml\"><em>Deploy web clipper extension</em> workflow</a>. Once a workflow run is selected, the ZIP files are available in the <em>Artifacts</em> section, under the name <code>web-clipper-extension</code>.</li></ul><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-chrome\"></span> Chrome</p><div class=\"trilium-tab-panel\"><ol><li>Download <code>trilium-web-clipper-[x.y.z]-chrome.zip</code>.</li><li>Extract the archive.</li><li>In Chrome, navigate to <code>chrome://extensions/</code></li><li>Toggle <em>Developer Mode</em> in top-right of the page.</li><li>Press the <em>Load unpacked</em> button near the header.</li><li>Point to the extracted directory from step (2).</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-firefox\"></span> Firefox</p><div class=\"trilium-tab-panel\"><aside class=\"admonition warning\"><p>Firefox prevents installation of unsigned packages in the “retail” version. To be able to install extensions from disk, consider using <em>Firefox Developer Edition</em> or a non-branded version of Firefox (e.g. <em>GNU IceCat</em>).</p><p>One time, go to <code>about:config</code> and change <code>xpinstall.signatures.required</code> to <code>false</code>.</p></aside><ol><li>Navigate to <code>about:addons</code>.</li><li>Select <em>Extensions</em> in the left-side navigation.</li><li>Press the <em>Gear</em> icon on the right of the <em>Manage Your Extensions</em> title.</li><li>Select <em>Install Add-on From File…</em></li><li>Point it to <code>trilium-web-clipper-[x.y.z]-firefox.zip</code>.</li><li>Press the <em>Add</em> button to confirm.</li></ol></div></section></div><h2>Credits</h2><p>Some parts of the code are based on the <a href=\"https://github.com/laurent22/joplin/tree/master/Clipper\">Joplin Notes browser extension</a>.</p>",
"_help_n1lujUxCwipy": "<p>This document outlines the steps required to upgrade Trilium to a new release version.</p><h2>How to Upgrade</h2><p>Trilium does not support built-in automatic upgrades; all updates must be performed manually. The upgrade process varies depending on the installation method:</p><ul><li><a href=\"#root/_help_rWX5eY045zbE\"><strong>Docker Server Installation</strong></a>: Pull the new image and restart the container.</li><li><strong>Other Installations</strong>: Download the latest version from the <a href=\"https://github.com/TriliumNext/Trilium/releases/latest\">release page</a> and replace the existing application files.</li></ul><h2>Database Compatibility and Migration</h2><p>Upon startup, Trilium will automatically migrate the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> to the new version. Note that after migration, older versions of Trilium will be unable to read the database. If you need to revert to a previous version of Trilium and its database, you can restore the <a href=\"#root/_help_ODY7qQn5m2FT\">backup</a> that is created prior to migration.</p><h2>Sync Compatibility</h2><p>The <a href=\"#root/_help_cbkrhQjrkKrh\">synchronization</a> protocol used by Trilium is versioned, requiring all members of the sync cluster to use the same protocol version. Therefore, when upgrading to a new version, you may need to upgrade all instances in the sync cluster. Changes to the sync protocol version are typically indicated on the release page.</p>",
"_help_ODY7qQn5m2FT": "<p>Trilium supports simple backup scheme where it saves copy of the <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> on these events:</p><ul><li>once a day</li><li>once a week</li><li>once a month</li><li>before DB migration to newer version</li></ul><p>So in total you'll have at most 4 backups from different points in time which should protect you from various problems. These backups are stored by default in <code>backup</code> directory placed in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>.</p><p>This is only very basic backup solution, and you're encouraged to add some better backup solution - e.g. backing up the <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> to cloud / different computer etc.</p><p>Note that <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> provides also some backup capabilities by its nature of distributing the data to other computers.</p><h2>Creating a backup</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-desktop\"></span> On the desktop app & web client</p><div class=\"trilium-tab-panel\"><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and press the <em>Backup now</em> button.</li><li>The backup creation process may take a few moments, especially for larger databases. A notification will inform you when the backup is complete.</li><li>The backup will be saved as <code>backup-now</code> in the <em>Existing backups</em> list, where you can download it.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-globe\"></span> On the standalone client</p><div class=\"trilium-tab-panel\"><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and press the <em>Download backup</em> button.</li><li>You will be prompted to restart the app. Confirm, and the app will restart automatically.</li><li>Set a <em>backup name</em> or <em>password</em> (both optional), then press <em>Continue</em>.</li><li>Press the <em>Generate and download</em> button and wait for the download to complete.</li><li>Once you confirm the download is saved on your device, press <em>Finish</em> to complete</li></ol></div></section></div><h2>Downloading a backup</h2><ul><li><strong>Desktop and web client</strong>: to download an existing backup, navigate to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Existing backups</em> and select <em>Download</em> (<span class=\"tn-icon bx bx-download\"></span>).</li><li><strong>Standalone client</strong>: automatic backups are not supported in this version. You can manually create and download a backup by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Download backup</em>.</li></ul><h2>Restoring a backup</h2><ul><li><strong>For a new Trilium instance</strong>: When setting up a new Trilium instance, use the <em>Restore from backup</em> option in the setup menu to guide you through restoring your existing backup.</li><li><strong>For an existing Trilium instance</strong>: To restore a backup and replace your current database, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> and click <em>Restore a backup</em>. You will be prompted to restart the app for the restoration process to begin. After restarting, you can choose to back up the existing database before overwriting it. Note: For the web client, use the Start Over feature ( <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Database</em> → <em>Start over</em> (<span class=\"tn-icon bx bx-reset\"></span>)) to switch to the setup screen and restore a backup.</li></ul><p>Next, select the backup file (.db or .tnbackup) from your device. The web client is optimized for handling large backups and is resilient to unstable network conditions, similar to the desktop application.</p><p>If your database is encrypted, you will be prompted to enter the password used for encrypting the backup file. Without the correct password, decryption and restoration cannot proceed.</p><p>Restoring a backup may take some time, depending on its size. Once it completes, Trilium will open the freshly restored database.</p><h3>The alternative way for restoring a backup</h3><p>Let's assume you want to restore the weekly backup (only in .db format, .tnbackup files are not supported by this method), here's how to do it:</p><ul><li>find <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> Trilium uses - easy way is to open \"About Trilium Notes\" (<span class=\"tn-icon bx bx-info-circle\"></span>) from \"Menu\" in upper left corner and looking at \"data directory\"<ul><li>I'll refer to <code>~/trilium-data</code> as data directory from now on</li></ul></li><li>find <code>~/trilium-data/backup/backup-weekly.db</code> - this is the <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> backup.</li><li>at this point stop/kill Trilium</li><li>delete <code>~/trilium-data/document.db</code>, <code>~/trilium-data/document.db-wal</code> and <code>~/trilium-data/document.db-shm</code> (latter two files are auto generated)</li><li>copy and rename this <code>~/trilium-data/backup/backup-weekly.db</code> to <code>~/trilium-data/document.db</code></li><li>make sure that the file is writable, e.g. with <code>chmod 600 document.db</code></li><li>start Trilium again</li></ul><aside class=\"admonition warning\"><p>If you have configured sync then you need to do it across all members of the sync cluster, otherwise older version (restored backup) of the document will be detected and synced to the newer version.</p></aside><h2>Changing the backup location in Trilium (desktop only)</h2><p>Starting with version 0.105, the Trilium desktop client allows users to change the directory where backups are stored. Follow these steps to specify a custom backup directory:</p><ol><li>Navigate to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup location</em>.</li><li>Click the <em>Select location</em> button.</li><li>Choose any writable directory on your file system. This could include network shares, depending on your operating system.</li></ol><p>Once you set a custom directory, all manual and automatic backups will be saved there. If the selected directory becomes unavailable, backups may fail or revert to the default location.</p><aside class=\"admonition tip\"><p>For better privacy when using unsafe backup locations, you can enable backup encryption, which makes the backup file unreadable without the correct password.</p></aside><h2>Backup encryption</h2><p>Trilium can secure the entire content of the database backup, ensuring it remains unreadable unless the correct password is provided. This is particularly useful for storing backups in unsecured locations, like network shares, unencrypted external drives, or cloud services. </p><p>Encrypted database backups use the Trilium Backup Container (.tnbackup) format, which relies on AES-256-GCM. This authenticated encryption mode scrambles the data and generates a tag confirming it hasn't been altered. The password itself isn't directly used as the key; it's processed through scrypt, a key derivation function designed to be slow and memory-intensive, making brute-force password guessing difficult even with powerful hardware. Each backup also receives a random 16-byte salt, ensuring that the same password never produces the same encryption key twice. Additionally, critical metadata such as chunk order, length, and header flags are cryptographically bound into the encryption (via \"additional authenticated data\"), preventing undetected tampering like reorder, truncate, or splice operations.</p><h3>Enabling backup encryption</h3><p>To enable encryption for automatic backups in the Desktop application:</p><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup options</em>.</li><li>Click on <em>Turn on encryption</em> and set a password.</li></ol><p>Once encryption is enabled, all newly created backups (both automatic and manual) will be encrypted with the specified password. Backups created prior to enabling encryption will remain unsecured.</p><p>You can change the password anytime using the <em>Change password</em> button. The new password will apply to backups created after the change.</p><p>To disable encryption, uncheck <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Enable encryption</em>.</p><aside class=\"admonition note\"><p>On some systems, a keyring may not be available for Trilium to securely store the encryption password. In such cases, the encryption option is disabled.</p></aside><h2>Backup compression</h2><p>Database backups can be optionally compressed to minimize storage footprint. This method is effective primarily when the database consists largely of text content. However, media files (images, videos, audio), along with PDF, ODF, and DOCX files, are already compressed in their original formats and won't benefit from further compression.</p><p>Compressed backups are stored using the Trilium Backup Container (.tnbackup), employing RFC 1952 GZIP compression.</p><aside class=\"admonition warning\"><p><strong>Note:</strong> Compression increases the time required for backup creation and restoration. It may also lead to higher CPU usage during automatic backups, potentially draining the battery faster on battery-powered devices. Enable this option only if necessary.</p></aside><h3>Enabling Backup Compression (Desktop Only)</h3><p>To enable compression for new automatic and manual backups, navigate to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Backup</em> → <em>Backup options</em> and toggle <em>Enable compression</em> to on.</p><h2>Disabling backup</h2><p>Although this is not recommended, it is possible to disable backup in <code>config.ini</code> in the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a>:</p><pre><code class=\"language-text-x-trilium-auto\">[General]\n... some other configs\n# set to true to disable backups (e.g. because of limited space on server)\nnoBackup=true</code></pre><p>You can also review the <a href=\"#root/_help_Gzjqa934BdH4\">configuration</a> file to provide all <code>config.ini</code> values as environment variables instead.</p><p>See <a href=\"https://github.com/TriliumNext/Trilium/blob/master/config-sample.ini\">sample config</a>.</p>",
"_help_tAassRL4RSQL": "<p>Data directory contains:</p><ul><li><code>document.db</code> - <a href=\"#root/_help_wX4HbRucYSDD\">database</a></li><li><code>config.ini</code> - instance level settings like port on which the Trilium application runs</li><li><code>backup</code> - contains automatically <a href=\"#root/_help_ODY7qQn5m2FT\">backup</a> of documents</li><li><code>log</code> - contains application log files</li></ul><h2>Location of the data directory</h2><p>Easy way how to find out which data directory Trilium uses is to look at the \"About Trilium Notes\" dialog (from \"Menu\" in upper left corner):</p><p><img src=\"{{helpAssets}}/User%20Guide/Installation%20%26%20Setup/Data%20directory_image.jpg\"></p><p>Here's how the location is decided:</p><p>Data directory is normally named <code>trilium-data</code> and it is stored in:</p><ul><li><code>/home/[user]/.local/share</code> for Linux</li><li><code>/home/[user]/.var/app/org.triliumnotes.Trilium/data</code> for the Flathub version on Linux</li><li><code>C:\\Users\\[user]\\AppData\\Roaming</code> for Windows Vista and up</li><li><code>/Users/[user]/Library/Application Support</code> for Mac OS</li><li>user's home is a fallback if some of the paths above don't exist</li><li>user's home is also a default setup for [[docker|Docker server installation]]</li></ul><p>If you want to back up your Trilium data, just backup this single directory - it contains everything you need.</p><h3>Changing the location of data directory</h3><p>If you want to use some other location for the data directory than the default one, you may change it via <code>TRILIUM_DATA_DIR</code> environment variable to some other location:</p><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-windows\"></span> Windows</p><div class=\"trilium-tab-panel\"><ol><li>Press the <span class=\"tn-icon bx bxl-windows\"></span> key on your keyboard.</li><li>Search and select <em>Edit the system variables</em>.</li><li>Press the <em>Environment Variables…</em> button in the bottom-right of the newly opened screen.</li><li>On the top section (<em>User variables for [user]</em>), press the <em>New…</em> button.</li><li>In the <em>Variable name</em> field insert <code>TRILIUM_DATA_DIR</code>.</li><li>Press the <em>Browse Directory…</em> button and select the new directory where to store the database.</li><li>Close all the windows by pressing the <em>OK</em> button for each of them.</li></ol></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-tux\"></span> Linux</p><div class=\"trilium-tab-panel\"><p>Trilium reads <code>TRILIUM_DATA_DIR</code> when it starts, so the variable must be set in the environment that launches it.</p><aside class=\"admonition note\"><p>Setting the variable does not move existing notes. To keep them, close Trilium and copy the old data directory to the new location first. Trilium creates the last folder of the path if it is missing, but not its parent folders.</p></aside><p><strong>Desktop application (.deb, .rpm, AppImage or .zip)</strong></p><p>To use the new location however Trilium is started (from the application menu, a desktop shortcut, at login or from a terminal), set the variable for the whole session:</p><ol><li><p>Create the file <code>~/.config/environment.d/trilium.conf</code> with the following content, using the full path (<code>~</code> is not expanded in this file):</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data</code></pre></li><li><p>Log out and log back in.</p></li></ol><p>This works on desktops started by <code>systemd</code>, which covers most distributions running GNOME or KDE Plasma. On other systems, add the following line to <code>~/.profile</code> instead, then log out and log back in:</p><pre><code class=\"language-text-x-sh\">export TRILIUM_DATA_DIR=\"$HOME/data/my-trilium-data\"</code></pre><p>The same line in <code>~/.bashrc</code> (or your shell's equivalent) only applies when Trilium is started from a terminal, not from the application menu.</p><p><strong>Flatpak (Flathub)</strong></p><p>The Flathub version runs in a sandbox that cannot see the rest of the file system, so it needs access to the folder as well as the variable:</p><pre><code class=\"language-text-x-sh\">flatpak override --user \\\n --env=TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data \\\n --filesystem=/home/myuser/data/my-trilium-data:create \\\n org.triliumnotes.Trilium</code></pre><p>To return to the default location, run <code>flatpak override --user --reset org.triliumnotes.Trilium</code>. This also removes any other overrides set for Trilium.</p><p><strong>Server running as a systemd service</strong></p><p>Add an <code>Environment=</code> line to the <code>[Service]</code> section of the unit file described in <a class=\"reference-link\" href=\"#root/_help_3tW6mORuTHnB\">Packaged version for Linux</a>:</p><pre><code class=\"language-text-x-trilium-auto\">[Service]\nEnvironment=TRILIUM_DATA_DIR=/var/lib/trilium-data</code></pre><p>Then reload and restart the service:</p><pre><code class=\"language-text-x-sh\">sudo systemctl daemon-reload\nsudo systemctl restart trilium</code></pre><p>The user set in <code>User=</code> must be able to write to the folder. For Docker, see <a class=\"reference-link\" href=\"#root/_help_rWX5eY045zbE\">Using Docker</a> instead.</p></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bxl-apple\"></span> macOS</p><div class=\"trilium-tab-panel\"><p>You need to create a <code>.plist</code> file under <code>~/Library/LaunchAgents</code> to load it properly each login.</p><p>To load it manually, you need to use <code>launchctl setenv TRILIUM_DATA_DIR <yourpath></code></p><p>Here is a pre-defined template, where you just need to add your path to:</p><pre><code class=\"language-text-xml\"><?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n <key>Label</key>\n <string>set.trilium.env</string>\n <key>RunAtLoad</key>\n <true/>\n <key>ProgramArguments</key>\n <array>\n <string>/bin/launchctl</string>\n <string>setenv</string>\n <string>TRILIUM_DATA_DIR</string>\n <string>/Users/YourUserName/Library/Application Support/trilium-data</string>\n </array>\n</dict>\n</plist>\n</code></pre></div></section></div><h3>Create a script to run with specific data directory</h3><p>An alternative to globally setting environment variable is to run only the Trilium Notes with this environment variable. This then allows for different setup styles like two <a href=\"#root/_help_wX4HbRucYSDD\">database</a> instances or \"portable\" installation.</p><p>To do this in Unix-based systems simply run <code>trilium</code> like this:</p><pre><code class=\"language-text-x-trilium-auto\">TRILIUM_DATA_DIR=/home/myuser/data/my-trilium-data trilium</code></pre><p>You can then save the above command as a shell script on your path for convenience.</p><h2>Electron user data directory (desktop only)</h2><p>When running the desktop application, Electron stores internal data (caches, spell-check dictionaries, session storage, etc.) separately from the Trilium data directory. By default this goes to the system's application data folder (e.g. <code>%APPDATA%</code> on Windows), which may be undesirable in corporate environments with roaming profiles or when running in portable mode.</p><p>To keep Electron data out of the system's roaming profile, set the <code>TRILIUM_ELECTRON_DATA_DIR</code> environment variable to an explicit path. The <code>trilium-portable</code> script does this automatically, pointing it to <code>trilium-electron-data/</code> next to the application.</p><h2>Fine-grained directory/path location</h2><p>Apart from the data directory, some of the subdirectories of it can be moved elsewhere by changing an environment variable:</p><figure class=\"table\"><table><thead><tr><th>Environment variable</th><th>Default value</th><th>Description</th></tr></thead><tbody><tr><td><code>TRILIUM_DOCUMENT_PATH</code></td><td><code>${TRILIUM_DATA_DIR}/document.db</code></td><td>Path to the <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> (storing all notes and metadata).</td></tr><tr><td><code>TRILIUM_BACKUP_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/backup</code></td><td>Directory where automated <a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a> databases are stored.</td></tr><tr><td><code>TRILIUM_LOG_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/log</code></td><td>Directory where daily <a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a> are stored.</td></tr><tr><td><code>TRILIUM_TMP_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/tmp</code></td><td>Directory where temporary files are stored (for example when opening in an external app).</td></tr><tr><td><code>TRILIUM_ANONYMIZED_DB_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/anonymized-db</code></td><td>Directory where a <a class=\"reference-link\" href=\"#root/_help_x59R8J8KV5Bp\">Anonymized Database</a> is stored.</td></tr><tr><td><code>TRILIUM_RESOURCES_DIR</code></td><td><code>${TRILIUM_DATA_DIR}/resources</code></td><td>Directory where <a class=\"reference-link\" href=\"#root/_help_ebyr7ES2SwOW\">Downloaded resources</a> are stored, such as the speech recognition models.</td></tr><tr><td><code>TRILIUM_CONFIG_INI_PATH</code></td><td><code>${TRILIUM_DATA_DIR}/config.ini</code></td><td>Path to <a class=\"reference-link\" href=\"#root/_help_Gzjqa934BdH4\">Configuration (config.ini or environment variables)</a> file.</td></tr><tr><td><code>TRILIUM_ELECTRON_DATA_DIR</code></td><td>System appData</td><td>Directory for Electron internal data (caches, spell-check dictionaries, etc.). Set this in portable mode to avoid writing to the system profile (desktop only).</td></tr></tbody></table></figure>",
"_help_ebyr7ES2SwOW": "<p>Downloaded resources are large files that some features need but that do not ship with Trilium, such as the speech recognition models used to transcribe meetings. Trilium downloads them the first time a feature needs them, and keeps them on the device for later use.</p><p>Currently, only <a class=\"reference-link\" href=\"#root/_help_Y84QCbArmK3z\">Meeting transcription</a> on the desktop application uses downloaded resources:</p><figure class=\"table\"><table><thead><tr><th>Resource</th><th>Size</th><th>License</th><th>Used for</th></tr></thead><tbody><tr><td>Parakeet TDT 0.6B v3 (standard)</td><td>0.6 GB</td><td>CC-BY-4.0</td><td>Recognizing speech, with the <em>Standard</em> model.</td></tr><tr><td>Parakeet TDT 0.6B v3 (high accuracy)</td><td>2.4 GB</td><td>CC-BY-4.0</td><td>Recognizing speech, with the <em>High accuracy</em> model.</td></tr><tr><td>Silero VAD</td><td>0.6 MB</td><td>MIT</td><td>Detecting when someone speaks.</td></tr><tr><td>TitaNet</td><td>40 MB</td><td>Apache-2.0</td><td>Telling speakers apart, while <em>Identify speakers</em> is on.</td></tr></tbody></table></figure><h2>Downloading resources</h2><p>When a feature needs resources that are not on the device yet, Trilium asks before downloading them. The dialog lists each resource with what it is used for, where it is downloaded from, its license and its size, followed by the total download size and the free space on the disk.</p><ul><li>To start the download, press <em>Download</em>. Each resource shows its progress, and the feature continues once all of them are downloaded.</li><li>To stop the download, press <em>Cancel</em> or close the dialog. The files already downloaded are kept, and the next download continues where this one stopped, even within a large file.</li><li>If the disk does not have enough free space, the dialog says so and the download cannot be started.</li></ul><p>Every file is checked against a checksum built into Trilium before it is used, so a file that was damaged or altered during the download is discarded.</p><aside class=\"admonition note\"><p>Downloaded resources are not synchronized. Each device that uses a feature downloads its resources separately, even when the notes are kept in sync through <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>.</p></aside><h2>Managing downloaded resources</h2><p>To see the downloaded resources, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Downloaded resources</em>. Each resource that was downloaded, or partly downloaded by an interrupted download, is listed with the space it takes on the disk and its status. Below the list, <em>Space used</em> shows the space they take in total, and how much free space is left on the disk.</p><ul><li>To open the folder of a resource, press the <span class=\"tn-icon bx bx-folder-open\"></span> button (desktop only).</li><li>To delete a resource, press the <span class=\"tn-icon bx bx-trash\"></span> button. If a feature needs it again, it is downloaded again.</li></ul><p>The list also shows, faded out, anything else in the resources folder:</p><ul><li><em>Older version</em>: the files of an earlier version of a resource. When a resource is updated, the new version is downloaded into a new folder, and the old one is left behind.</li><li><em>Not used</em>: a resource that no feature of this installation uses, for example one downloaded by a feature that was removed.</li><li><em>Unknown</em>: any other file or folder, for example one copied there by hand.</li></ul><p>These can be deleted in the same way.</p><aside class=\"admonition warning\"><p>If a server and a desktop application share the same data directory, a resource used by only one of them shows as <em>Not used</em> in the other. Deleting it there removes it for both.</p></aside><h2>Location</h2><p>The resources are stored in the <code>resources</code> folder of the <a class=\"reference-link\" href=\"#root/_help_tAassRL4RSQL\">Data directory</a>, one folder per resource. To store them elsewhere, set the <code>TRILIUM_RESOURCES_DIR</code> environment variable to another folder before starting Trilium.</p><h2>Installing without an Internet connection</h2><p>To install a resource on a device that cannot download it, copy its folder from the <code>resources</code> folder of a device that already has it into the same place on the other device. The next time a feature asks to download it, press <em>Download</em>: the files already in place are checked against their checksums and kept, and only the missing ones are downloaded.</p>",
"_help_x0JgW8UqGXvq": "<p>Trilium supports two different layouts, based on your preference.</p><h3>Vertical layout</h3><p>The vertical layout is Trilium's original layout:</p><ul><li>The <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> is positioned on the left side of the screen, with buttons being laid out vertically.</li><li>The tab bar is at the top, but to the right of the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The <a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> is at the top of the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> can be collapsed by pressing the <span class=\"tn-icon bx bx-chevrons-left\"></span> button at the bottom of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. While collapsed, it can be peeked temporarily above the content by pressing the strip on the right side of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li><li>The <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> can be accessed via the <span class=\"tn-icon cke cke-trilium\"></span> icon at the top of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/1_Vertical%20and%20horizontal%20layout_image.jpg\"></p><h3>Horizontal layout</h3><p>The horizontal layout is a more traditional layout, since it bears similarity with other applications. In this mode:</p><ul><li>The <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> is at the top of the screen, with the buttons laid horizontally.</li><li>The tab bar is at the top of the screen, but now covers the entirety of the width, allowing for more tabs to be displayed at once.</li><li>The <a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> is now part of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. It can be moved around according to preference and even removed if needed.</li><li>The <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> can be collapsed by pressing the small <span class=\"tn-icon bx bx-sidebar\"></span> button to the left of the first tab. While collapsed, it can be peeked temporarily above the content by pressing the strip on the left edge of the app.</li><li>The <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> can be accessed via the <span class=\"tn-icon bx bx-menu\"></span> button at the end of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Vertical%20and%20horizontal%20layout_image.jpg\"></p><h2>Changing the layout</h2><p>Go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> and look for the <em>Appearance</em> option on the left. Then look for the <em>Layout</em> section, where there is the possibility to switch between the two available layouts.</p><p>Clicking an option will immediately apply the selected layout by reloading the window.</p>",
"_help_x3i7MxGccDuM": "<p>The global menu configures the current window (zoom, keeping the window on top), switches the theme and offers access to some more advanced options.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Global%20menu_image.jpg\"></p><h2>Accessing the global menu</h2><p>See <a href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a> since the position of the global menu is changed based on which layout has been selected.</p><h2>Switching the theme</h2><p>The <em>Theme</em> submenu changes the look of the application without opening the <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>. A check mark at the end of a row shows the active choice. The submenu is not shown on mobile; change the theme from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> there.</p><ul><li>Under <em>Color scheme</em>, choose <em>System</em> to follow the light or dark mode of the operating system, or <em>Light</em> or <em>Dark</em> to use one regardless.</li><li>Under <em>Theme</em>, choose <em>Modern</em> (the default theme) or one of the custom themes, each shown with the icon of its note. Switching to <em>Modern</em> keeps the current color scheme.</li></ul><p>A custom theme brings its own colors, so the color schemes are unavailable while one is active. The legacy theme is not listed; select it from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> instead.</p><p>For more about the built-in and custom themes, see <a class=\"reference-link\" href=\"#root/_help_Wy267RK4M69c\">Themes</a>.</p>",
"_help_oPVyFC7WL2Lp": "<p>This page explains how to manipulate the note tree in TriliumNext, focusing on moving notes.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_image.jpg\"></p><h2>Drag and Drop</h2><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_drag-and-drop.gif\" alt=\"Drag and drop example\"></p><p>You can easily rearrange the note tree by dragging and dropping notes, as demonstrated in the example above.</p><h3>Importing files</h3><p>A file or archive can easily be imported into Trilium just by dragging it inside the note tree.</p><p>Note that a drag & drop always imports with <em>safe import</em> on, meaning that some features such as scripts are disabled in the upcoming notes. To bypass that, use the dedicated <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> feature (right click → <em>Import into note</em>).</p><p>Unlike the import dialog, the drag & drop also has some basic auto-detection of the import. For example, dragging a .zip file with a <code>.obsidian</code> folder in it will automatically trigger a dedicated <a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a> import.</p><h2>Keyboard Manipulation</h2><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree_move-note-with-keyboard.gif\" alt=\"Example of using keyboard keys to move a note\">Trilium offers efficient keyboard-based manipulation using the following <a href=\"#root/_help_A9Oc6YKKc65v\">shortcuts</a>:</p><ul><li><kbd>Ctrl</kbd> + <kbd>↑</kbd> and <kbd>Ctrl</kbd> +<kbd>↓</kbd>: Move the note up or down in the order.</li><li><kbd>Ctrl</kbd>+<kbd>←</kbd>: Move the note up in the hierarchy by changing its parent to the note's grandparent.</li><li><kbd>Ctrl</kbd>+<kbd>→</kbd>: Move the note down in the hierarchy by setting its parent to the note currently above it (this action is best understood through a demo or hands-on experience).</li><li><kbd>←</kbd> and <kbd>→</kbd>: Expand and collapse a sub-tree.</li></ul><h2>Context Menu</h2><p>You can also move notes using the familiar cut and paste functions available in the context menu, or with the associated keyboard <a href=\"#root/_help_A9Oc6YKKc65v\">shortcuts</a>: <code>CTRL-C</code> ( <a href=\"#root/_help_IakOLONlIfGI\">copy</a>), <kbd>Ctrl</kbd> + <kbd>X</kbd> (cut) and <kbd>Ctrl</kbd> + <kbd>V</kbd> (paste).</p><p>See <a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a> for more information.</p><h2>Tree Settings</h2><p>Click the tree icon in the tree toolbar to open the tree settings popup. Each option takes effect as soon as it is changed:</p><ul><li><em>Display density</em>: <em>Relaxed</em> (default) or <em>Dense</em>. Dense rows are shorter, so more notes fit on the screen. This setting is not synchronized, so each device keeps its own.</li><li><em>Hide archived notes</em>: When enabled, archived notes are not shown in the tree.</li><li><em>Automatically collapse notes</em>: When enabled, notes are collapsed after a period of inactivity to keep the tree tidy.</li><li><em>Follow active note</em>: When enabled (default), the tree automatically scrolls and expands parent nodes to keep the currently active note visible. When disabled, the tree is fully detached from navigation — only the background highlight of the active note is updated, but the tree viewport and its expanded/collapsed state are never changed by navigation. Use the crosshair button to manually jump the tree to the active note at any time.</li></ul><h2>Hiding and peeking the tree</h2><p>To hide or show the note tree, press the <span class=\"tn-icon bx bx-sidebar\"></span> button to the left of the first tab in the horizontal layout, or the <span class=\"tn-icon bx bx-chevrons-left\"></span> button at the bottom of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> in the vertical layout. The <em>Toggle Left Pane</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>, which is not assigned by default, does the same. See <a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>.</p><p>A small strip with an arrow icon runs along the left edge of the app in the horizontal layout. In the vertical layout, it runs along the right side of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, and only shows while the tree is hidden.</p><ul><li>When the tree is hidden, pressing the strip will <em>peek</em> the tree.<ul><li>In this mode the tree is shown temporarily above the content, without shifting the content of your notes.</li><li>Clicking outside the tree, pressing <kbd>Esc</kbd> or pressing the strip again will hide the tree.</li><li>Pressing the button that shows the tree will dock it.</li></ul></li><li>In the horizontal layout, pressing the strip while the tree is docked will hide it.</li></ul><p>The <em>Peek Tree Pane</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>, <kbd>Alt</kbd>+<kbd>[</kbd> by default, does the same as pressing the strip. Only one panel is peeked at a time: peeking the tree hides a peeked <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, and the other way around.</p><h2>Keyboard shortcuts</h2><p>The note tree comes with multiple keyboard shortcuts to make editing faster, consult the dedicated <a class=\"reference-link\" href=\"#root/_help_DvdZhoQZY9Yd\">Keyboard shortcuts</a> section.</p>",
"_help_YtSN43OrfzaA": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:269/608;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Note%20tree%20contextual%20menu_image.png\" width=\"269\" height=\"608\"></figure><p>The <em>note tree menu</em> can be accessed by right-clicking in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><h2>Interaction</h2><p>The contextual menu can operate:</p><ul><li>On a single note, by right clicking it in the note tree.</li><li>On multiple notes, by selecting them first. See <a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a> on how to do so.<ul><li>When right clicking, do note that usually the note being right clicked is also included in the affected notes, regardless of whether it was selected or not.</li></ul></li></ul><h2>Available options</h2><aside class=\"admonition note\"><p>When multiple notes are selected, only a subset of notes will be active. The ones that do support multiple notes will mention this in the list below.</p></aside><p>The most frequent actions stand side by side at the top of the menu, each as an icon over its name. Use <kbd>←</kbd> and <kbd>→</kbd>, or <kbd>↑</kbd> and <kbd>↓</kbd>, to move between them.</p><ul><li><strong>Cut</strong><ul><li>Will place the given notes in clipboard.</li><li>Use one of the two paste functions (or the keyboard shortcuts) to move them to the desired location.</li></ul></li><li><strong>Copy</strong><ul><li>Will place the given notes in clipboard.</li><li>Use one of the two paste functions (or the keyboard shortcuts) to copy them to the desired location.</li><li>Note that the copy function here works according to the <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> functionality (i.e. the note itself will be present in two locations at once, and editing it in one place will edit it everywhere).</li><li>To simply create a duplicate note that can be modified independently, look for <em>Duplicate</em>.</li></ul></li><li><strong>Paste into</strong><ul><li>Pastes the notes in clipboard as child notes of the right-clicked one.</li><li>Shown only after notes have been cut or copied.</li></ul></li><li><strong>Paste after</strong><ul><li>Pastes the notes in clipboard underneath the right-clicked one.</li><li>Shown only after notes have been cut or copied.</li></ul></li><li><strong>Delete</strong><ul><li>Will delete the given notes, asking for confirmation first.</li><li>In the dialog, the following options can be configured:<ul><li><em>Delete also all clones</em> to ensure that the note will be deleted everywhere if it has been placed into multiple locations (see <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>).</li><li><em>Erase notes permanently</em> will ensure that the note cannot be recovered from <a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a>.</li></ul></li></ul></li></ul><p>The rest of the menu lists its options one per row:</p><ul><li><strong>Open note</strong><ul><li>Clicking it opens the note in a new <a href=\"#root/_help_3seOhtN8uLIY\">tab</a>.</li><li>Hovering it or clicking its arrow opens a submenu with the places the note can be opened in: <em>Open in a new tab</em>, <em>Open in a new split</em> (to the right of the note, within the current tab) and <em>Open in a new window</em>.</li><li>On mobile, the menu lists <em>Open</em>, <em>Open in a new tab</em> and <em>Open in a new split</em> directly instead of <em>Open note</em>, and leaves out <em>Open in a new window</em>. <em>Open</em> shows the note in the current tab, which also opens a note with children, since tapping one lists its children instead.</li></ul></li><li><strong>Quick edit</strong><ul><li>Opens the note in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, over the current one.</li></ul></li><li><strong>Hoist note</strong><ul><li>Will focus the note tree on this note. See <a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a> for more information.</li></ul></li><li><strong>Insert note after</strong><ul><li>Allows easy creation of a note with a specified <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a>.</li><li>The <em>Code</em> submenu starts with the scripting notes, each a code note set up for its role: <em>Custom CSS</em> (with <code>#appCss</code>), <em>Widget</em> (with <code>#widget</code> and a starting skeleton) and <em>Backend script</em>. The enabled code languages follow.</li><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> are grouped in the <em>Collection</em> submenu. The note types created less often, the <a class=\"reference-link\" href=\"#root/_help_B2ORr7OVEZtc\">Snippets</a> and the AI quick action are in the <em>More</em> submenu.</li><li><a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> will also be present (if any) at the end of the list, under a <em>Templates</em> heading. The <span class=\"tn-icon bx bx-cog\"></span> button beside the heading opens <em>Content Manager</em> in the <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, where the templates can be managed.</li><li>To find an entry quickly, type into the search box at the top of the submenu, or just start typing while the submenu is open. The submenu then lists every matching entry, including those inside its own submenus (such as a code language or a collection), each with the submenu it comes from. Use <kbd>↑</kbd> and <kbd>↓</kbd> to pick a match, <kbd>Enter</kbd> to create it, and <kbd>Esc</kbd> to clear the search.</li><li>The note will be added on the same level of hierarchy as the note selected.</li></ul></li><li><strong>Insert child note</strong><ul><li>Same as <em>Insert note after</em>, but the note will be created as a child of the selected note.</li></ul></li><li><strong>Move to…</strong><ul><li>Will display a modal to specify where to move the desired notes.</li></ul></li><li><strong>Clone to…</strong><ul><li>Will display a modal to specify where to <a href=\"#root/_help_IakOLONlIfGI\">clone</a> the desired notes.</li></ul></li><li><strong>Duplicate</strong><ul><li>Creates a copy of the note and its descendants, placed right after the original.</li><li>When the note has child notes, the item also has an arrow, set apart by a divider. Hovering the item or clicking the arrow opens a submenu:<ul><li><em>Note and its children</em> does the same as clicking <em>Duplicate</em>.</li><li><em>This note only</em> copies the note with its content and attributes, but without any of its child notes. Links and relations to the original children keep pointing at them.</li></ul></li><li>This process is different from <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> since the duplicated note can be edited independently from the original.</li><li>An alternative to this, if done regularly, would be <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</li></ul></li><li><strong>Archive/Unarchive</strong><ul><li>Marks a note as <a href=\"#root/_help_MKmLg5x6xkor\">archived</a>.</li><li>If the note is already archived, it will be unarchived instead.</li><li>Multiple notes can be selected as well. However, all the selected notes must be in the same state (archived or not), otherwise the option will be disabled.</li></ul></li><li><strong>Protect subtree/Unprotect subtree</strong><ul><li>On a note that is not protected, <em>Protect subtree</em> marks this note and all of its descendants as protected. On a protected note, the item reads <em>Unprotect subtree</em> and unprotects them instead. See <a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a> for more information.</li><li>Hovering the item or clicking its arrow opens a submenu with both actions, for instance to unprotect the protected notes below a note that is not protected itself.</li></ul></li><li><strong>Import into note…</strong><ul><li>Opens the <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> dialog and places the imported notes as child notes of the selected one.</li></ul></li><li><strong>Export…</strong><ul><li>Opens the <a href=\"#root/_help_mHbBMPDPkVV5\">export</a> dialog for the selected notes.</li></ul></li><li><strong>Search in subtree</strong><ul><li>Opens a full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> with it preconfigured to only look into this note and its descendants (the <em>Ancestor</em> field).</li></ul></li></ul><h2>Advanced options</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:231/263;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Note%20tree%20contextual%20menu_image.png\" width=\"231\" height=\"263\"></figure><p>The advanced options menu offers some of the less frequently used actions for notes.</p><p>To access these options, first look for the <em>Advanced</em> option at the bottom of the contextual menu to reveal a sub-menu with:</p><ul><li><strong>Apply bulk actions…</strong><ul><li>Opens the <a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a> dialog, to apply actions such as adding labels or moving notes to multiple notes at once (see <a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>).</li></ul></li><li><strong>Edit branch prefix…</strong><ul><li>Opens a dialog to assign a name to be able to distinguish <a href=\"#root/_help_IakOLONlIfGI\">clones</a>, see <a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a> for more information.</li></ul></li><li><strong>Convert to attachment…</strong><ul><li>Converts the selected notes to <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> of their parent notes.</li><li>This functional is most useful when dealing with image <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> notes that were imported from an external source or an older version of Trilium.</li></ul></li><li><strong>Expand subtree</strong><ul><li>Expands all the child notes in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li></ul></li><li><strong>Collapse subtree</strong><ul><li>Collapses all the child notes in the note tree.</li></ul></li><li><strong>Sort by…</strong><ul><li>Opens a dialog to sort all the child notes of the selected note.</li><li>The sorting is done only once, there is an automatic sorting mechanism as well that can be set using <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li><li>See <a class=\"reference-link\" href=\"#root/_help_aGlEvb9hyDhS\">Sorting Notes</a> for more information.</li></ul></li><li><strong>Copy note path to clipboard</strong><ul><li>Copies a URL fragment representing the full path to this branch for a note, such as <code>#root/Hb2E70L7HPuf/4sRFgMZhYFts/2IVuShedRJ3U/LJVMvKXOFv7n</code>.</li><li>The URL to manually create <a class=\"reference-link\" href=\"#root/_help_QEAPj01N5f7w\">Links</a> within notes, or for note <a class=\"reference-link\" href=\"#root/_help_wArbEsdSae6g\">Navigation</a>.</li></ul></li><li><strong>Recent changes in subtree</strong><ul><li>This will open <a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a>, but filtered to only the changes related to this note or one of its descendants.</li></ul></li></ul>",
"_help_yTjUdsOi4CIE": "<p>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, it's possible to select multiple notes at one time. This won't affect the currently displayed note, but it allows to do batch operations.</p><h2>Types of multiple selection</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:28.54%;\"><img style=\"aspect-ratio:335/306;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Multiple%20selection_image.png\" width=\"335\" height=\"306\"></figure><h3>Selecting notes one by one</h3><p>To individually select each note, press the <kbd>Alt</kbd> key and click on the note to be selected.</p><p>The selected notes will be indicated via a different background color and an icon.</p><h3>Selecting notes in a sequence</h3><figure class=\"image image-style-align-right image_resized\" style=\"width:29.24%;\"><img style=\"aspect-ratio:233/205;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Multiple%20selection_image.jpg\" width=\"233\" height=\"205\"></figure><p>When notes are in a sequence (e.g. one underneath the other), the entire selection can be made just by selecting the first and the last item instead of individually clicking all the notes.</p><p>To do so, first select the note to start the selection with. Then hold <kbd>Shift</kbd> and click on the note to end the selection with. All the notes between the start and the end note will be selected as well.</p><h2>Selected notes vs. active note</h2><p>There is a distinction between <em>selected notes</em> and the <em>active note</em>:</p><ul><li><em>Selected notes</em> are simply the notes that were selected in the multiple section process (i.e. either via <kbd>Alt</kbd> or <kbd>Shift</kbd>).</li><li>The <em>active note</em> is simply the note that whose content is being displayed to the right of the tree.<ul><li><p>Visually, it's identified in the tree by having a different background color and a subtle shadow.</p></li><li><p>The active note can also be selected case in which the icon and background will also change:</p><img class=\"image_resized\" style=\"aspect-ratio:317/223;width:35.1%;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Multiple%20selection_image.png\" width=\"317\" height=\"223\"></li></ul></li></ul>",
"_help_DvdZhoQZY9Yd": "<p>The <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> comes with multiple keyboard shortcuts to make editing faster:</p><h2>Navigation within the tree</h2><ul><li><kbd><span>↑</span></kbd> and <kbd><span>↑</span></kbd> to navigate between notes.</li><li><kbd><span>←</span></kbd> to collapse a note with children, or <kbd><span>→</span></kbd> to expand it.</li><li><kbd><span>←</span></kbd> on a note with no children to navigate to its parent.</li></ul><h2>Opening notes</h2><ul><li><kbd>Click</kbd> to open the note in the current tab.</li><li><kbd>Ctrl</kbd>+<kbd>Click</kbd> or <kbd>Middle click</kbd> to open the note in a new tab.</li><li><kbd>Ctrl</kbd>+<kbd>Right click</kbd> to open the note in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>.</li></ul><h2>Clipboard management</h2><ul><li><kbd>Ctrl</kbd>+<kbd>C</kbd> to copy one or more notes based on selection (see <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>).</li><li><kbd>Ctrl</kbd>+<kbd>X</kbd> to cut one or more notes (for moving them).</li><li><kbd>Ctrl</kbd>+<kbd>V</kbd> to paste them somewhere (which results in a copy or move based on the shortcut used).</li></ul><h2>Moving notes</h2><ul><li><kbd>Ctrl</kbd> + <kbd><span>↑</span></kbd> , <kbd>Ctrl</kbd> + <kbd><span>↓</span></kbd> - move note up/down in the note list.</li><li><kbd>Ctrl</kbd> + <kbd><span>←</span></kbd> - move note up in the note tree.</li><li><kbd>Ctrl</kbd>+<kbd><span>→</span></kbd> - move note down in the note tree.</li><li><kbd>Del</kbd> - deletes note and optionally its subtree (asked in the dialog).</li><li><kbd>Alt</kbd>+<kbd>S</kbd> - sorts the child notes of the note (see <a class=\"reference-link\" href=\"#root/_help_aGlEvb9hyDhS\">Sorting Notes</a>).</li></ul><h2>Multiple selection</h2><p>See <a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a> for more information about how selection works.</p><ul><li><kbd>Alt</kbd>+<kbd>Click</kbd> – add a single note to the current selection.</li><li><kbd>Shift</kbd>+<kbd>Click</kbd> – select a range of notes, starting from the current note (the highlighted one) to the one that is being clicked.</li><li><kbd>Shift</kbd>+<kbd><span>↑</span></kbd>, <kbd>Shift</kbd>+<kbd><span>↓</span></kbd> – multi-select not above/below.</li><li><kbd>Ctrl</kbd>+<kbd>A</kbd> – select all notes in the current level</li></ul>",
"_help_wyaGBBQrl4i3": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:328/45;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/1_Hiding%20the%20subtree_image.png\" width=\"328\" height=\"45\"><figcaption>An example of a collection with a relatively large number of children that are hidden from the tree.</figcaption></figure><p>The tree works well when the notes are structured in a hierarchy so that the number of items stays small. When a note has a large number of notes (in the order of thousands or tens of thousands), two problems arise:</p><ul><li>Navigating between notes becomes cumbersome and the tree itself gets cluttered with a large amount of notes.</li><li>The large amount of notes can slow down the application considerably.</li></ul><p>Since v0.102.0, Trilium allows the tree to hide the child notes of particular notes. This works for both <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> and normal notes.</p><h2>Interaction</h2><p>When the subtree of a note is hidden, there are a few subtle changes:</p><ul><li>To indicate that the subtree is hidden, the note will not have an expand button and it will display the number of children to the right.</li><li>It's not possible to add a new note directly from the tree.<ul><li>For <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, it's best to use the built-in mechanism to create notes (for example by creating a new point on a geo-map, or by adding a new row in a table).</li><li>For normal notes, it's still possible to create children via other means such as using the <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> system.</li></ul></li><li>Notes can be dragged from outside the note, case in which they will be cloned into it.<ul><li>Instead of switching to the child notes that were copied, the parent note is highlighted instead.</li><li>A notification will indicate this behavior.</li></ul></li><li>Similarly, features such as cut/copy and then paste into the note will also work.</li></ul><h2>Spotlighting</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:322/83;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tree/Hiding%20the%20subtree_image.png\" width=\"322\" height=\"83\"></figure><p>Even if the subtree of a note is hidden, if a child note manages to become active, it will still appear inside the tree in a special state called <em>spotlighted</em>.</p><p>During this state, the note remains under its normal hierarchy, so that its easy to tell its location. In addition, this means that:</p><ul><li>The note position is clearly visible when using the <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</li><li>The note can still be operated on from the tree, such as adding a <a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a> or moving it outside the collection.</li></ul><p>The note appears in italics to indicate its temporary display. When switching to another note, the spotlighted note will disappear.</p><aside class=\"admonition note\"><p>Only one note can be highlighted at the time. When working with multiple notes such as dragging them into the collection, no note will be spotlighted. This is intentional to avoid displaying a partial state of the subtree.</p></aside><h2>Working with collections</h2><p>For large collections, it can be helpful to hide their child notes for performance reasons or de-cluttering the tree.</p><p>To toggle this behavior:</p><ul><li>Open the collection and in <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, look for <em>Hide child notes in tree</em>.</li><li>Right click the collection note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Advanced</em> → <em>Show subtree</em>.</li></ul><h2>Working with normal notes</h2><p>It's possible to hide the subtree for normal notes as well, not just collections. To do so, right click the note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Advanced</em> → <em>Hide subtree.</em></p>",
"_help_3seOhtN8uLIY": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1119/43;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Tabs_image.png\" width=\"1119\" height=\"43\"></figure><p>In Trilium, tabs allow easy switching between notes.</p><h2>Layout</h2><p>Depending on the <a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>:</p><ul><li>For the vertical layout, the tabs will be placed at the top but to the right of the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>For the horizontal layout, the tabs will be placed at the top in full-width, above the <a href=\"#root/_help_oPVyFC7WL2Lp\">note tree</a>, allowing for more tabs to be comfortably displayed.</li></ul><h2>Interaction</h2><ul><li>To create a new tab, press the <span class=\"tn-icon bx bx-plus\"></span> button that is to the right of the last tab.</li><li>Right-clicking or pressing and holding the <span class=\"tn-icon bx bx-plus\"></span> button shows a menu with:<ul><li><em>New tab</em>.</li><li>If there are any <a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>, one entry per workspace, which opens the workspace in a new tab, hoisted into it.</li><li><em>Recently changed notes</em>: up to 15 notes, the most recently changed first, with the path of each note on the right. Notes that are already open in a tab are not listed, and in a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> only its descendants are. Selecting a note opens it in a new tab.</li><li><em>All recent changes</em>, which opens the <a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a> dialog.</li></ul></li><li>To close a tab, press the corresponding <span class=\"tn-icon bx bx-x\"></span> button.</li><li>For multitasking, tabs can be used alongside <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>. Each tab can have one or more notes, displayed horizontally.</li><li>Tabs can be reordered by drag-and-dropping it into a new position.</li><li>An existing tab can be displayed in a new window by dragging the tab upwards or downwards. It is not possible to combine tabs back into another window.</li></ul><h2>Keyboard interaction</h2><p>Since tabs are a commonly used feature, there are multiple keyboard shortcuts that can be used:</p><ul><li><kbd>Ctrl</kbd>+<kbd>T</kbd> to open a new tab.</li><li><kbd>Ctrl</kbd>+<kbd>W</kbd> to close the current tab.</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> to reopen the last closed tab.</li><li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> to go to the next or previous tab.</li><li><kbd>Ctrl</kbd>+<kbd>1</kbd>, <kbd>Ctrl</kbd>+<kbd>2</kbd>, up to <kbd>Ctrl</kbd>+<kbd>9</kbd> to activate the first, second and up to ninth tab.</li><li>There is also a shortcut to go to the last tab, but it is not assigned a key by default.</li></ul><h2>Full screen</h2><p>To show Trilium in full screen, press <kbd>F11</kbd> or the <span class=\"tn-icon bx bx-expand-alt\"></span> <em>Fullscreen</em> button in the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>. While in full screen, the tab bar shows a <span class=\"tn-icon bx bx-exit-fullscreen\"></span> <em>Leave full screen</em> button before the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> toggle; press it to return to the normal window.</p><h2>Background tabs</h2><p>When Trilium starts, it reopens the tabs from the previous session. Only the active tab loads its note right away; every other tab loads its note the first time you switch to it. This keeps startup fast when many tabs are open, especially tabs that show collections.</p><p>The same applies to a tab opened in the background, for example with a middle click or <kbd>Ctrl</kbd>+click on a link.</p><h2>Mobile</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:34.12%;\"><img style=\"aspect-ratio:1242/2688;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Tabs_IMG_1767.PNG\" width=\"1242\" height=\"2688\"></figure><p>Tabs are also supported on the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>.</p><p>Since v0.102.0, the tabs are displayed by pressing the dedicated tab switcher button in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. In this view the tabs are laid out on a grid with a preview of the note content. On a phone, a tab left on the note tree shows the folder it was on instead, with the tab's note highlighted. Swiping left or right on the launch bar goes to the next or previous tab directly, as long as all of its buttons fit on the screen, with the page following the finger until it lets go.</p><p>The context menu button at the top-right of the popup allows creating a new tab, reopening the last closed tab and closing all the tabs.</p><p><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>s are also indicated in the tab switcher, with two titles displayed in a tab.</p><aside class=\"admonition note\"><p>Versions prior to v0.102.0 also supported tabs, but they were displayed directly above the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>. The decision to use a more mobile-like tab switcher was taken because the original tab bar could not support many tabs at once and the new design better aligns with how mobile applications handle tabs.</p></aside>",
"_help_xYmIYSP6wE3F": "<h2>Position of the Launch bar</h2><p>On desktop, depending on the layout selected, the launcher bar will either be on the left side of the screen with buttons displayed vertically or at the top of the screen. See <a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a> for more information.</p><p>On mobile, the launch bar will always be at the bottom.</p><p>If there are too many items in the launch bar to fit the screen, it will become scrollable.</p><h2>Terminology</h2><ul><li><strong>Launcher</strong>: a button that can be (or is) displayed on the launch bar.</li><li><strong>Available Launcher</strong>: a launcher that is not displayed on the launch bar, but can be added.</li><li><strong>Visible Launcher</strong>: a launcher that is currently displayed on the launch bar.</li></ul><h2>Configuring the desktop Launch bar</h2><p>There are two ways to configure the launch bar:</p><ul><li>Right click in the empty space between launchers on the launch bar and select <em>Configure launch bar…</em></li><li>Click on the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> and select <em>Configure launch bar</em>.</li></ul><p>This will open a new tab with the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> listing the launchers.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Launch%20Bar_image.jpg\"></p><p>Expanding <em>Available Launchers</em> section will show the list of launchers that are not displayed on the launch bar. The <em>Visible Launchers</em> will show the ones that are currently displayed.</p><h2>Configuring the mobile launch bar</h2><p>The launch bar on mobile uses a different configuration from the desktop one. The reasoning is that not all desktop icons are available on mobile, and fewer icons fit on a mobile screen.</p><p>To configure the launch bar on mobile, go to <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> and select <em>Configure launch bar</em>.</p><p>The configure the mobile launch bar while on the desktop (especially useful to configure more complicated launchers such as scripts or custom widgets), go to <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> → Advanced → Hidden notes and look for the <em>Mobile Launch Bar</em> section. While in the hidden subtree, it's also possible to drag launchers between the <em>Mobile Launch Bar</em> and (Desktop) <em>Launch Bar</em> sections.</p><h3>Adding/removing and reordering launchers</h3><p>To display a new launcher in the launch bar, first look for it in the <em>Available Launchers</em> section. Then right click it and select <em>Move to visible launchers</em>. It is also possible to drag and drop the item manually.</p><p>Similarly, to remove it from the launch bar, simply look for it in <em>Visible Launchers</em> then right click it and select <em>Move to available launchers</em> or use drag-and-drop.</p><p>Drag-and-drop the items in the tree in order to change their order. See <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> for more interaction options, including using keyboard shortcuts.</p><h3>Adding a note by drag and drop</h3><p>To add a note to the launch bar, drag it from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> onto the launch bar. A line between the launchers shows where the note will be placed. If the launch bar is scrollable, hold the note near either end to scroll it. Dropping the note adds a button with the note's title and icon, which opens the note when clicked.</p><ul><li>Several notes selected in the tree can be dropped at once; they keep their order.</li><li>A note that is already on the launch bar, or a launcher dragged from the <em>Available Launchers</em> section, is moved to the new place instead of being added again.</li></ul><p>The button is a clone of the note in the <em>Visible Launchers</em> section (see <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>), so it always shows the note's current title and icon. Right click it and select <em>Remove from launch bar</em> to remove the clone; the note itself stays where it is in the tree. If the launch bar is the only place the note is in, it's moved to the <em>Available Launchers</em> instead, so that the note isn't deleted.</p><p>To list the note's children instead of opening the note, right click the button and check <em>Show as a folder</em>, the same way as for a <a href=\"#root/_help_u3YFHC9tQlpm\">bookmark folder</a>. To open the note in a new tab, a split, a new window or a quick edit popup instead of the current tab, right click the button and pick a place under <em>Open mode</em>, as described in <a href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>.</p><h2>Customizing the launcher</h2><ul><li>The icon of a launcher can be changed just like a normal note. See <a href=\"#root/_help_p9kXRFAkwN4o\">note icons</a> for more information.</li><li>The title of the launcher can also be changed.</li></ul><h3>Resetting</h3><p>Resetting allows restoring the original configuration of Trilium for the launcher bar, or for a portion of it. Simply right click a launcher (or even the entire <em>Launch Bar</em> section) and select <em>Reset</em> to bring it back to the original state.</p><h3>Creating new launchers / types of launchers</h3><p>Right click either the <em>Available launchers</em> or <em>Visible launchers</em> sections and select one of the options:</p><ol><li><p><strong>Note Launcher</strong><br>A note launcher will simply navigate to a specified note.</p><ol><li>Set the <code>target</code> promoted attribute to the note to navigate to.</li><li>Optionally, set <code>hoistedNote</code> to hoist a particular note. See <a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a> for more information.</li><li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li></ol></li><li><p><strong>Script Launcher</strong><br>An advanced launcher which will run a script upon pressing. See <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a> for more information.</p><ol><li>Set <code>script</code> to point to the desired script to run.</li><li>Optionally, set a <code>keyboardShortcut</code> to trigger the launcher.</li></ol></li><li><p><strong>Custom Widget</strong></p><p>Allows defining a custom widget to be rendered inside the launcher. See <a class=\"reference-link\" href=\"#root/_help_SynTBQiBsdYJ\">Widget Basics</a> for more information.</p></li><li><p><strong>Spacers</strong><br>Launchers that create some distance between other launchers for better visual distinction.</p></li></ol><p>Launchers are configured via predefined <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p>",
"_help_8YBEPzcpUgxw": "<figure class=\"image image-style-align-right image_resized\" style=\"width:25.95%;\"><img style=\"aspect-ratio:402/988;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20menu_image.png\" width=\"402\" height=\"988\"></figure><p>The note menu contains various actions and configurations for the current note. It can be found in the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area (to the right of the <a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>).</p><p>Every split has a note menu of its own, which acts on the note displayed in that split. Entries that don't apply to the current note are still listed but grayed out, while entries that only exist for some notes (described in <em>Note-specific entries</em>) appear only on those notes.</p><h2>Navigating the note</h2><p>These entries are the row of icons at the top of the menu, each with a short title. Hovering one shows its full name and its keyboard shortcut. In Quick edit on a phone, where only <em>Find</em> is left, it is listed as an ordinary entry instead.</p><ul><li><span class=\"tn-icon bx bx-file-find\"></span> <em>Find</em> opens the <a class=\"reference-link\" href=\"#root/_help_McngOG2jbUWX\">Search in note</a> bar, to find and replace text inside the current note. On the desktop application, the same bar opens with <kbd>Ctrl</kbd>+<kbd>F</kbd>.<ul><li>It is available on <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>, <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>, <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a> and <a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a> notes, <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, PDF files, and any note displayed as <a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>.</li></ul></li><li><span class=\"tn-icon bx bx-paperclip\"></span> <em>Attachments</em> switches the note to the list of its <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>, where they can be uploaded, opened, downloaded, renamed or deleted.</li><li><span class=\"tn-icon bx bxs-network-chart\"></span> <em>Note map</em> opens the <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a> of the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, which shows the <a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a> centered on the current note.</li></ul><h2>Note properties</h2><p>The toggles in this section take effect immediately:</p><ul><li><span class=\"tn-icon bx bx-share-alt\"></span> <em>Shared</em> publishes the note via <a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, by cloning it into the <em>Shared Notes</em> tree.<ul><li>Turning it off removes the clone from that tree. If the note exists only as a shared note, Trilium asks for confirmation, since unsharing it deletes it.</li><li>The toggle is unavailable on the root note, on the <em>Shared Notes</em> note itself, and on system notes.</li></ul></li><li><span class=\"tn-icon bx bx-lock-alt\"></span> <em>Protect the note</em> encrypts the note, turning it into one of the <a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a>. If no protected session is active, Trilium asks for the password first. Only the current note is affected, not its children.</li><li><span class=\"tn-icon bx bx-bookmark\"></span> <em>Bookmark</em> adds the note to the <a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a> that are displayed in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, or removes it from them.</li><li><span class=\"tn-icon bx bx-copy-alt\"></span> <em>Template</em> marks the note as one of the <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> (by adding the <code>#template</code> label), which makes it available when creating a new note.</li><li><span class=\"tn-icon bx bx-expand-horizontal\"></span> <em>Full width</em> lets the note use the whole width of the window instead of the limit set in <a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a> by adding the <code>#fullContentWidth</code> label. It is not listed for note types that are always displayed at full width.</li></ul><p>The two submenus in this section:</p><ul><li><span class=\"tn-icon bx bx-file\"></span> <em>Note type</em> changes the type of the note to any of the <a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a>; the current one is checked. If the note already has content, Trilium asks for confirmation first, since the content generally doesn't carry over. <a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.<ul><li>For a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note, the language is chosen in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a> instead.</li></ul></li><li><span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> controls when the note opens as read-only (see <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>):<ul><li><em>Auto</em> (the default): the note is editable, unless it is long enough to be opened as read-only automatically.</li><li><em>Read-only</em>: the note always opens as read-only, but can still be edited after pressing <em>Edit note</em>.</li><li><em>Always editable</em>: the note is always editable, regardless of its length.</li></ul></li></ul><h2>Importing, exporting and printing</h2><ul><li><span class=\"tn-icon bx bx-import\"></span> <em>Import files</em> opens the import dialog, which imports files as children of the current note. See <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a>. It is unavailable on <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> notes.</li><li><span class=\"tn-icon bx bx-export\"></span> <em>Export note</em> opens the export dialog with <em>Only this note</em> selected; select <em>This note & all descendants</em> there to export the whole subtree.</li><li><span class=\"tn-icon bx bx-printer\"></span><em>Print/export to PDF…</em> prints the note or saves it as a PDF file. See <a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing & Exporting as PDF</a>, including which note types and collections can be printed.</li></ul><p>Some note types add their own export formats right below <em>Export note</em>:</p><ul><li><span class=\"tn-icon bx bxs-file-image\"></span><em>Export as image</em>, on <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> and <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a> notes, downloads the diagram as <em>PNG (raster)</em> or <em>SVG (vector)</em>.</li><li><span class=\"tn-icon bx bxs-spreadsheet\"></span><em>Export to Excel (.xlsx)</em> and <em>Export to CSV (.csv)</em>, on <a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a>, download the spreadsheet in those formats.</li></ul><h2>Revisions</h2><p>These entries manage the <a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a> of the note:</p><ul><li><span class=\"tn-icon bx bx-history\"></span><em>Note revisions…</em> opens the revisions dialog, where previous versions can be previewed, compared with the current one, downloaded or restored. The arrow beside it opens the entries that save a revision right away. On mobile, tapping it opens those entries, with <em>Note revisions…</em> as the first one.<ul><li><span class=\"tn-icon bx bx-save\"></span><em>Save revision</em> saves a revision of the note right away, instead of waiting for the next automatic snapshot.</li><li><span class=\"tn-icon bx bx-purchase-tag\"></span><em>Save named revision…</em> also saves a revision right away, but first asks for a short description of the changes, which is shown in the revisions dialog.</li></ul></li></ul><h2>Note-specific entries</h2><p>The following entries only appear on some notes:</p><ul><li><span class=\"tn-icon bx bx-pencil\"></span><em>Edit note</em> appears at the top of the menu when the note is currently read-only. It enables editing until the note is closed.</li><li><span class=\"tn-icon bx bx-align-justify\"></span><em>Word wrap</em> appears at the top of the menu on <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, and sets whether long lines wrap in this note:<ul><li><em>Auto</em> (the default) follows <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Wrap lines in code notes</em>.</li><li><em>On</em> and <em>Off</em> override it for this note only, by setting the <code>#wrapLines</code> label.</li></ul></li><li><span class=\"tn-icon bx bx-paperclip\"></span><em>Convert into attachment</em> appears on an image note that has no children and a single parent which is a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. After a confirmation, it turns the image into an attachment of its parent note and opens it there. See <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li><span class=\"tn-icon bx bx-extension\"></span><em>Re-render note</em> appears on a <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, and runs its script again to refresh the output.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Board properties</em> appears on a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>, and configures its columns, card attributes and card templates.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Calendar properties</em> appears on a <a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a> that creates events, and configures its event templates.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> appears on a <a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, and configures its map settings and the image of an <a href=\"#root/_help_ZRDXGc0nAIh4\">image map</a>.</li><li><span class=\"tn-icon bx bx-cog\"></span><em>Table properties</em> appears on a <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, and configures which notes it shows.</li></ul><h2>Advanced</h2><p>The <span class=\"tn-icon bx bx-wrench\"></span><em>Advanced</em> submenu groups the actions that are needed less often:</p><ul><li><p><span class=\"tn-icon bx bx-file-find\"></span><em>Open externally</em> (desktop application only) saves the note to a temporary file and opens it in the application that the operating system associates with it. Trilium watches the file: each time it is saved, a notification in the window it was opened from offers to upload the modified version back into the note, keeping the current content as a revision. It is unavailable on <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> and <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> notes.</p></li><li><p><span class=\"tn-icon bx bx-customize\"></span><em>Open with...</em> (desktop application only) works like <em>Open externally</em>, but lets you pick the application to open the file with. See <a href=\"#open-with\">Open with</a> below.</p></li><li><p><span class=\"tn-icon bx bx-code\"></span><em>Note source</em> shows the <a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>, the content of the note exactly as it is stored.</p></li><li><p><span class=\"tn-icon bx bxl-markdown\"></span><em>Convert to Markdown note</em> (on text notes) and <em>Convert to text note</em> (on Markdown notes) switch the note between rich text and Markdown. After a confirmation, Trilium saves a revision and converts the content; the revision allows going back if some formatting was lost. See <a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p></li><li><p><span class=\"tn-icon bx bx-collapse-alt\"></span><em>Compress images</em> opens a dialog that reduces the size of the images in the note. It lists the images found and how much space they take, and offers to:</p><ul><li>Resize the images larger than a chosen size.</li><li>Keep, or compress, JPEG images.</li><li>Keep, optimize, or convert to JPEG the PNG images.</li><li><em>Process child notes as well</em>, to include the images of the notes beneath this one.</li></ul><p>Compressing cannot be undone. Images can also be compressed automatically on upload, see <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>.</p></li><li><p><span class=\"tn-icon bx bx-text\"></span><em>View OCR text</em> (on image and file notes) shows the text extracted from the note via <a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>. If the note has not been processed yet, the dialog offers to <em>Process OCR</em>.</p></li><li><p><span class=\"tn-icon bx bx-world\"></span><em>Open note on server</em> (desktop application only, listed when <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> is configured) opens the same note on the sync server, in the web browser.</p></li></ul><h2>Open with</h2><p><span class=\"tn-icon bx bx-customize\"></span><em>Open with...</em> in the <em>Advanced</em> submenu opens the note in an application you choose, instead of the one the operating system associates with its type. As with <em>Open externally</em>, Trilium saves the note to a temporary file, watches it, and offers to upload the modified version back into the note. The entry is available only in the desktop application; attachments offer the same action.</p><ul><li>On Windows, the system's <em>Open with</em> dialog lists the installed applications.</li><li>On Linux, the application chooser comes from the desktop portal (<code>xdg-desktop-portal</code>), so it works in the Flatpak as well.</li><li>In the Flathub version, <em>Open externally</em> also goes through the desktop portal, which can show the application chooser the first few times a file type is opened, as the system's policy decides; <em>Open with...</em> always shows it.</li><li>On macOS, a file picker opens in the <em>Applications</em> folder; the note opens in the application you select there, as with <em>Open With</em> → <em>Other…</em> in Finder.</li></ul><p>If the application chooser cannot be shown (such as when no desktop portal is running on Linux), Trilium reports an error instead of opening the file. <em>Open externally</em> still opens it in the default application.</p><h3>Adding an application to the chooser on Linux</h3><p>The portal lists only the applications registered for the file's type. Text editors generally register for plain text but not for HTML, so they are missing when opening a text note, which is saved as an HTML file.</p><p>To make an editor appear without changing the default application, add it under <code>[Added Associations]</code> in <code>~/.config/mimeapps.list</code>, using the name of the editor's <code>.desktop</code> file:</p><pre><code class=\"language-text-x-toml\">[Added Associations]\ntext/html=org.gnome.TextEditor.desktop;</code></pre><p>The <em>Open with other application</em> entry of most file managers adds the same line.</p><h2>Deleting the note</h2><p><span class=\"tn-icon bx bx-trash\"></span><em>Delete note</em> opens the deletion dialog for the current note and its subtree. The dialog lists the notes that will be deleted and the relations that will be broken, and offers to:</p><ul><li>Also delete the other clones of the note, if it is cloned elsewhere. Otherwise, only the current placement is removed and the note stays in its other locations. See <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>.</li><li><em>Erase permanently</em> instead of the usual soft deletion. This cannot be undone.</li></ul><p>Notes deleted without erasing can be brought back, see <a class=\"reference-link\" href=\"#root/_help_5Ct4MAJTS4tQ\">Restoring Deleted Notes</a>.</p><h2>Limitations</h2><ul><li>The note menu is not available on launchers.</li><li>On the notes of <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> and of the in-app help, most entries are grayed out, since these notes cannot be imported into, deleted or have revisions. Of the two, only the in-app help can be exported, see <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a>.</li><li>The <a href=\"#note-properties\">Note properties</a> section is only listed when the note itself is displayed, not its <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> or its <a class=\"reference-link\" href=\"#root/_help_4FahAwuGTAwC\">Note source</a>.</li><li>In <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em> are not listed.</li></ul><h2>Mobile support</h2><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the note menu opens as a sheet from the bottom of the screen. Besides the entries above, it contains the items that the desktop layout places elsewhere:</p><ul><li>Two more icons in the row of icons at the very top of the sheet, which reads <span class=\"tn-icon bx bx-dock-right\"></span> <em>New split</em>, <em>Note map</em>, <em>Find</em> and <span class=\"tn-icon bx bx-plus\"></span> <em>Child note</em> from left to right: <em>New split</em> opens a <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a> while there is none in the tab, and <em>Child note</em> creates a note under the current one.</li><li><em>Backlinks</em> and <em>Note paths</em>, below the row of icons, which open the <a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a> and the other locations of the note.</li><li><span class=\"tn-icon bx bx-paperclip\"></span> <em>Attachments</em> and <span class=\"tn-icon bx bx-list-check\"></span> <em>Attributes</em>, under them, which open the attachments and the attributes of the note, each with the number the note has. Links made by the content of the note are not counted as attributes. <em>Attributes</em> is unavailable where the note cannot be edited. On mobile, <em>Attachments</em> is listed here instead of in the row of icons.</li><li>The custom buttons of the note type (such as <span class=\"tn-icon bx bx-download\"></span><em>Download</em> on a <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>).</li><li><em>Close this pane</em>, on the second note of a <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>.</li><li><span class=\"tn-icon bx bx-slider-alt\"></span> <em>Note settings</em>, below <em>Protect the note</em>, which opens <em>Shared</em> and <em>Bookmark</em>, then <em>Note type</em>, <em>Template</em> and <em>Full width</em>, on a page of their own, together with the language of the note: the content language on <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes (see <a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language & Right-to-left support</a>), and the language of the code on <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes. The choices of <em>Editable</em> are listed at the end of that page, under their own heading, instead of in a further submenu.</li><li><span class=\"tn-icon bx bx-info-circle\"></span> <em>Note info</em>, below <em>Note settings</em>, which opens the dates, type, ID and size of the note on a page of its own, ending with <em>Show similar notes</em> (see <a class=\"reference-link\" href=\"#root/_help_xWtq5NUHOwql\">Similar Notes</a>).</li><li><em>Note map</em> opens the map in a popup instead of the right sidebar.</li></ul>",
"_help_1P8QXI5edXNd": "<p>The note buttons is an area at the top-right of a note with a few buttons:</p><ul><li>The <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> which offers commands for the note or its subtree, such as import, export, viewing the <a href=\"#root/_help_4FahAwuGTAwC\">Note source code</a> or <a href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a> controls<ul><li><span class=\"tn-icon bx bx-dock-right\"></span> to open a new split</li><li><span class=\"tn-icon bx bx-chevron-right\"></span>/<span class=\"tn-icon bx bx-chevron-left\"></span> to move the pane around</li><li><span class=\"tn-icon bx bx-x\"></span> to close the pane.</li></ul></li><li>On some note types such as <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> and images, there are dedicated buttons (e.g. <span class=\"tn-icon bx bx-download\"></span> to download the file locally).</li></ul>",
"_help_4TIF1oA4VQRO": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1189/709;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Options_image.png\" width=\"1189\" height=\"709\"></figure><p>The Options section allows the configuration of the TriliumNext client and server.</p><h2>Entering options</h2><p>The Options can be accessed via:</p><ul><li>The <a href=\"#root/_help_x3i7MxGccDuM\">Global menu</a>, by selecting the <em>Options</em> item.</li><li>The <span class=\"tn-icon bx bx-cog\"></span> button in the <a href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> which can optionally be hidden if not desirable.</li><li>Optionally, a keyboard shortcut can be defined, but it is not assigned by default.</li><li>By clicking on this link: <a class=\"reference-link\" href=\"#root/_hidden/_options\">Options</a>.</li></ul><p>Once in the options section, simply select one of the option categories using the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><h2>Exiting options</h2><p>When entering the options, they are opened in a new <a href=\"#root/_help_3seOhtN8uLIY\">tab</a>. To close them, simply close the tab.</p><h2>Options when using sync</h2><p>When using <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a>, some of the options will be kept in sync across all the devices while others can be changed independently.</p><p>Generally, the options that relate to appearance are intentionally kept not synced in order to allow per-client customization (layout orientation, theme, vertical/horizontal layout, code block themes).</p>",
"_help_luNhaphA37EO": "<p>In Trilium, is possible to work with two or more notes side-by-side.</p><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:1398/1015;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Split%20View_2_Split%20View_image.png\" width=\"1398\" height=\"1015\"></figure><h2>Interactions</h2><ul><li>Press the <span class=\"tn-icon bx bx-dock-right\"></span> button to the right of a note's title to open a new split to the right of it.<ul><li>It is possible to have as many splits as desired, simply press again the button.</li><li>Only horizontal splits are possible, vertical or drag & dropping is not supported.</li></ul></li><li>When at least one split is open, press the <span class=\"tn-icon bx bx-x\"></span> button next to it to close it.</li><li>Use the <span class=\"tn-icon bx bx-chevron-right\"></span> or the <span class=\"tn-icon bx bx-chevron-left\"></span> button to move around the splits.</li><li>Creating, closing and moving a split can also be triggered from a <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (<em>Create New Split</em>, <em>Close Active Split</em>, <em>Move Split Left</em> and <em>Move Split Right</em>, all unassigned by default) or through the <a href=\"#root/_help_F1r9QtzQLZqm\">command palette</a>.</li><li>The focus can be moved from one split to the one next to it with the <em>Focus Split to the Left</em> and <em>Focus Split to the Right</em> actions, which stop at either end of the tab instead of continuing into the next tab. They are unassigned by default as well.</li><li>Each <a href=\"#root/_help_3seOhtN8uLIY\">tab</a> has its own split view configuration (e.g. one tab can have two notes in a split view, whereas the others are one-note views).<ul><li>The tab's title will indicate all the note titles, in the order of the splits from the left to right and separated by a bullet symbol.</li><li>The tab's icon will indicate the icon of the last active split, which will be automatically focused when clicking on the tab.</li></ul></li></ul><h2>Splits and the note tree & hoisting</h2><p>Clicking on the content of a split will focus that split. While focused, the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> will also indicate the note that is being edited.</p><p>It is possible for each of the splits to have their own <a class=\"reference-link\" href=\"#root/_help_OR8WJ7Iz9K4U\">Note Hoisting</a>.</p><p>When a new split is created, it will share the same note hoisting as the previous one. An easy solution to this is to simply hoist the notes after the split is created.</p><p>This is generally quite useful for reorganizing notes from one place to the other, by hoisting the old place in the first split and hoisting the new place to the second one. This will allow easy cut and paste without the tree jumping around from switching between notes.</p><h2>Mobile support</h2><p>Since v0.100.0, it's possible to have a split view on the mobile view as well, with the following differences from the desktop version of the split:</p><ul><li>On smartphones, the split views are laid out vertically (one on the top and one on the bottom), instead of horizontally as on the desktop.</li><li>There can be only one split open per tab.</li><li>It's not possible to resize the two split panes.</li><li>When the keyboard is opened, the active note will be “maximized”, thus allowing for more space even when a split is open. When the keyboard is closed, the splits become equal in size again.</li></ul><p>Interaction:</p><ul><li>To create a new split, click the three dots button on the right of the note title and tap <span class=\"tn-icon bx bx-dock-right\"></span> <em>New split</em> in the row of icons at the top.<ul><li>This option will only be available if there is no split already open in the current tab.</li></ul></li><li>To close a split, click the three dots button on the right of the note title and select <em>Close this pane</em>.<ul><li>Note that this option will only be available on the second note in the split (the one at the bottom on smartphones, the one on the right on tablets).</li></ul></li><li>When long-pressing a link, a contextual menu will show up with an option to <em>Open note in a new split</em>.<ul><li>If there's already a split, the option will replace the existing split instead.</li></ul></li></ul>",
"_help_RnaPdbciOfeq": "<figure class=\"image\"><img style=\"aspect-ratio:1990/1168;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar_image.png\" width=\"1990\" height=\"1168\"></figure><p>The right sidebar displays specific content for the current note. The sidebar is grouped into multiple tabs:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>, which displays the table of contents, highlights and other navigation-related sections depending on the note type.</li><li><a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a>, which provides a visual editor for the current note's <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>.</li><li><a class=\"reference-link\" href=\"#root/_help_LrKznOtw9cQD\">AI chat tab</a>, which uses the <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> integration to chat, with optional access to the current note.</li><li><a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>, which groups together the note map, note paths, backlinks and similar notes.</li></ul><p>Each window keeps its own selected tab, so switching tabs in one window does not affect the others. A newly opened window starts on the tab that was selected last.</p><h2>Toggling the right sidebar</h2><p>There are two ways to toggle the right sidebar:</p><ul><li>Via the <span class=\"tn-icon bx bx-sidebar bx-flip-horizontal\"></span> icon near the title bar, which toggles whether the sidebar is docked.</li><li>Via the <em>Toggle right pane</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>, which is not assigned by default.</li></ul><h2>Peeking the sidebar</h2><p>There is a small strip near the right edge of the app which shows an arrow icon.</p><ul><li>When the sidebar is hidden, pressing the edge will <em>peek</em> the sidebar.<ul><li>In this mode the sidebar is shown temporarily above the content, without shifting the content of your notes.</li><li>Clicking outside the sidebar while in peek mode will simply hide the sidebar. Same goes for the X button and clicking on the right edge.</li><li>Pressing the pin icon will dock the sidebar.</li></ul></li><li>When the sidebar is docked, pressing the edge will hide the sidebar (similar to the toggle icon at the top).</li></ul><p>The <em>Peek Right Pane</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>, <kbd>Alt</kbd>+<kbd>]</kbd> by default, does the same as pressing the strip.</p><h2>Mobile support</h2><p>On mobile, the right sidebar is replaced by the note panel, which opens as a sheet at the bottom of the screen from the <span class=\"tn-icon bx bx-dock-bottom\"></span> button beside the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</p><ul><li>The tabs are switched from a bar at the bottom of the sheet. As on desktop, a tab with nothing to show for the current note is left out, and the <em>Widgets</em> tab lists the <a href=\"#root/_help_M8IppdwVHSjG\">right pane widgets</a> of scripts.</li><li>The sections of a tab are displayed one after the other as cards, each with its name above it, instead of collapsible sections.</li><li>The header of the sheet shows the name of the tab, except in the <em>Attributes</em> and <em>AI chat</em> tabs, where it holds their buttons instead (see <a class=\"reference-link\" href=\"#root/_help_uNtgN0cUKEBc\">Attributes tab</a> and <a class=\"reference-link\" href=\"#root/_help_LrKznOtw9cQD\">AI chat tab</a>).</li><li>Tapping a heading of the table of contents, or a page or an annotation of a PDF, closes the panel and scrolls the note to it.</li></ul>",
"_help_2dcGDhp9WFKb": "<p>The Outline tab appears in the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> and displays the headings and highlights for the current note.</p><h2>Table of contents</h2><p>The table of contents displays the titles / headings in the current note and allows easy navigation.</p><p>The following note types are supported:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a></li><li><a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a></li><li><a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a></li><li><a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> chat notes</li><li>The pages of the in-app documentation</li></ul><figure class=\"image image-style-align-right image_resized\" style=\"width:47%;\"><img style=\"aspect-ratio:556/205;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/1_Outline%20tab_image.png\" width=\"556\" height=\"205\"></figure><h3>Interaction</h3><ul><li>Clicking on a heading will scroll the document to the position of the heading.</li><li>As the document is scrolled, the heading being read is highlighted and the list scrolls to keep it in view. If that heading is hidden inside a collapsed section, the collapsed heading is highlighted instead.</li><li>Nested items can be collapsed by pressing the corresponding <span class=\"tn-icon bx bx-chevron-down\"></span> button.</li></ul><h2>Highlights</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:46.04%;\"><img style=\"aspect-ratio:489/240;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Outline%20tab_image.png\" width=\"489\" height=\"240\"></figure><p>Similar to the table of contents, but instead of headings this feature will list highlighted text from a text note and allow easy navigation to them.</p><p>Unlike table of contents which supports multiple note types, the highlights are specific to the <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</p><p>Highlighted text is defined as:</p><ul><li>Bold text.</li><li>Italic text.</li><li>Underlined text.</li><li>Text with a foreground color set.</li><li>Text with a background color/highlight set.</li></ul><h3>Interaction</h3><ul><li>Clicking on a highlighted text will scroll the document to its position.</li></ul><h3>Configuration</h3><ul><li>Globally, it's possible to toggle the display of each category of highlighted text (as defined above) <ul><li>Pressing the gear button in the top-right part of the section will reveal a menu to toggle between the highlight categories.</li><li>Alternatively, they can be changed by going to <a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a> settings and looking for the <em>Highlights List</em> section.</li></ul></li></ul><h2>PDF-specific outline</h2><p>When <a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a> are opened in Trilium, the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> is augmented with PDF-specific navigation, with the following features:</p><ul><li>Table of contents/outline<ul><li>All the headings and “bookmarks” will be displayed hierarchically.</li><li>The heading on the current page is also highlighted (note that it can be slightly offset depending on how many headings are on the same page).</li><li>Clicking on a heading will jump to the corresponding position in the PDF.</li></ul></li><li>Pages<ul><li>A preview of all the pages with a small thumbnail.</li><li>Clicking on a page will automatically navigate to that page.</li><li>Right-clicking a page and selecting <em>Copy reference</em> copies a link that opens the PDF at that page.</li></ul></li><li>Annotations<ul><li>Highlight and comment annotations are listed here.</li><li>Right-clicking an annotation and selecting <em>Copy reference</em> copies a link that opens the PDF at that annotation.</li></ul></li><li>Attachments<ul><li>If the PDF has its own attachments (not to be confused with Trilium's <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>), they will be displayed in a list.</li><li>Some information such as the name and size of the attachment are displayed.</li><li>It's possible to download the attachment by clicking on the download button.</li></ul></li><li>Layers<ul><li>A less common feature, if the PDF has toggle-able layers, these layers will be displayed in a list here.</li><li>It's possible to toggle the visibility for each individual layer.</li></ul></li></ul>",
"_help_uNtgN0cUKEBc": "<figure class=\"image image-style-align-right image_resized\" style=\"width:34.71%;\"><img style=\"aspect-ratio:596/1688;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Attributes%20tab_image.png\" width=\"596\" height=\"1688\"></figure><p>The attributes tab provides a more graphical way to view and edit <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a>.</p><h2>Sections</h2><p>The attributes are grouped into collapsible sections, each showing the number of attributes it holds next to its name:</p><ul><li><em>Owned</em> contains a list of the attributes that belong to this note.</li><li><em>Inherited</em> contains the attributes that apply to the current note but come through <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>. This section is only displayed if the note inherits attributes.</li><li><em>Definitions</em> describe the type of attributes and are used in <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> collections. This section is only displayed if the note has or inherits definitions.</li></ul><p>Clicking the name of a section collapses or expands it, and the collapsed state is remembered.</p><h2>Toolbar</h2><p>Above the sections there is a toolbar with:</p><ul><li>A <em>Select all</em> checkbox, which selects every attribute (see <a href=\"#selecting-attributes\">Selecting attributes</a>).</li><li>A <span class=\"tn-icon bx bx-paste\"></span> button, which only appears after attributes are copied. It lists the copied attributes and offers to paste them into the current note or to clear them.</li><li>A <span class=\"tn-icon bx bx-plus\"></span> <em>Add a new attribute</em> button, which offers to add a label, a relation, a label definition or a relation definition. This shows the full detail popup.</li></ul><p>On a note that cannot be edited (such as a page of the in-app help), the paste and add buttons are replaced by a <span class=\"tn-icon bx bx-lock-alt\"></span> <em>Read-only</em> indicator. Attributes can still be selected and copied from such a note.</p><h2>Owned attributes</h2><p>Every item is structured as such:</p><ul><li>The icon of each item indicates whether it's a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> (<span class=\"tn-icon bx bx-hash\"></span>) or a <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> (<span class=\"tn-icon bx bx-transfer\"></span>, link to another note).</li><li>The first text is the name of the label.</li><li>The value of the attribute is displayed after the name, if present.<ul><li>The value is shown in a graphical way: a relation's value is a clickable note link; a color label shows a color chip.</li></ul></li></ul><p>System attributes (that have a special meaning in Trilium) show a small <span class=\"tn-icon bx bx-cog\"></span> cog near the icon and are grouped separately from the user-defined ones.</p><p>Interaction:</p><ul><li>Clicking on the item (apart from the value and links) reveals a dedicated popup where the name, value and <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a> can be defined.</li><li>The value of the attributes can be edited in-place:<ul><li>The input box follows the type defined in a corresponding label definition (date, color, dropdown, numbers), as well as for system attributes that have a specific type (e.g. <code>color</code>).</li><li>For labels, clicking on the value edits its in-place.<ul><li>Press <kbd>Enter</kbd> to confirm or click outside the input box, or <kbd>Esc</kbd> to dismiss.</li><li>For multi-line text, <kbd>Ctrl</kbd>+<kbd>Enter</kbd> confirms whereas <kbd>Enter</kbd> creates a newline.</li></ul></li><li>For checkbox attributes, clicking on the checkbox will toggle its state.</li><li>For labels without a value, a value can be added by clicking on the <em>No value</em> text which appears while the mouse is hovered on the item.</li><li>For relations, there is a dedicated <span class=\"tn-icon bx bx-pencil\"></span> button instead.</li></ul></li><li>An attribute can be deleted by pressing the <span class=\"tn-icon bx bx-trash\"></span> button to its right, which only appears while hovered. A confirmation screen is displayed first to ensure the attribute is not accidentally deleted.</li></ul><p>Attributes can be added in two ways:</p><ul><li>A new label, relation or attribute definition can be added from the <span class=\"tn-icon bx bx-plus\"></span> button in the <a href=\"#toolbar\">toolbar</a>. This shows the full detail popup.</li><li>To quickly add a label or a relation directly from the sidebar, click the <em>Add attribute</em> (<span class=\"tn-icon bx bx-plus\"></span>) item at the end of the list.<ul><li>The name field will be focused first. By default, a label will be created instead but it can be toggled to a relation by typing <kbd>~</kbd> or pressing the <span class=\"tn-icon bx bx-hash\"></span> icon (similarly, typing <code>#</code> will switch back to a label instead of a relation).</li><li>Once the name is filled, press <kbd>Enter</kbd> to continue to the value. Type in a value if desired and then press <kbd>Enter</kbd> again to create the attribute.</li><li>Clicking outside the editor will also create the attribute, but only if a name is specified.</li></ul></li></ul><h2>Inherited attributes</h2><p>Inherited labels or relations are shown in the same fashion as the owned ones.</p><p>The only differences are:</p><ul><li>To the right of the inherited attribute there is a link to the note where the attribute comes from, as well as an <span class=\"tn-icon bx bx-sitemap\"></span> icon to indicate that it's inheritable.</li><li>Clicking on an inherited attribute will reveal the same popup as owned attributes, but it is not editable. To edit it, first navigate to the note where the attribute is defined.</li></ul><h2>Definitions</h2><p>For attribute definition (see <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>):</p><ul><li>The icon indicates the type of the attribute (text, number).<ul><li>If an attribute is promoted, it has a small <span class=\"tn-icon bx bx-chevron-up\"></span> chevron icon overlaid on top of it.</li></ul></li><li>The name indicates the name of the attribute it defines (without the <code>label:</code> or <code>relation:</code> prefix).</li><li>To the right of the name a short summary is displayed which indicates the display name (alias), whether it has multiple values or an inverse relation.</li><li>Clicking on a definition reveals a popup, where the name, type, display name and other aspects can be configured.</li><li>To add a label definition, click the <em>Add definition</em> (<span class=\"tn-icon bx bx-plus\"></span>) item at the end of the list; its type can be changed to a relation from the popup. Both kinds of definitions can also be added from the <span class=\"tn-icon bx bx-plus\"></span> button in the <a href=\"#toolbar\">toolbar</a>.</li><li>For inherited definition, there is a link to the note where the definition comes from, as well as an <span class=\"tn-icon bx bx-sitemap\"></span> icon to indicate that it's inherited.</li></ul><h2>Selecting attributes</h2><p>Multiple attributes can be selected in order to copy or delete them together:</p><ul><li>Hovering over an attribute shows a checkbox in place of its icon. Click it to select the attribute.</li><li>Alternatively, hold <kbd>Ctrl</kbd> (<kbd>Cmd</kbd> on macOS) while clicking an attribute to select it, or <kbd>Shift</kbd> to select a range of attributes. A range can span multiple sections.</li><li>Once at least one attribute is selected, every attribute shows its checkbox, and clicking anywhere on an attribute selects or deselects it instead of opening the detail popup.</li><li>The <em>Select all</em> checkbox in the toolbar selects every attribute; while attributes are selected, it shows how many. Clicking it again clears the selection, as does pressing <kbd>Esc</kbd>.</li></ul><p>While attributes are selected, the toolbar shows:</p><ul><li>A <span class=\"tn-icon bx bx-copy\"></span> button, which copies the selected attributes.</li><li>A <span class=\"tn-icon bx bx-trash\"></span> button, which deletes the selected attributes after a confirmation. It only appears if all the selected attributes belong to the current note, since inherited attributes can only be deleted from the note they come from.</li></ul><p>Right-clicking an attribute shows a menu with the same actions, as well as pasting. If the attribute is not part of the selection, the menu applies only to that attribute.</p><h2>Copying and pasting attributes</h2><p>Attributes can be copied from one note and pasted into another:</p><ul><li>To copy, select the attributes and press <kbd>Ctrl</kbd>+<kbd>C</kbd>, or use the <span class=\"tn-icon bx bx-copy\"></span> button in the toolbar or the context menu.</li><li>To paste, navigate to the destination note and press <kbd>Ctrl</kbd>+<kbd>V</kbd> after clicking anywhere in the attributes tab, or use the <span class=\"tn-icon bx bx-paste\"></span> button in the toolbar. Right-clicking an attribute or an empty area of a section also offers to paste.</li></ul><p>Attributes are copied as text, in the same format as the attributes editor (for example <code>#author=John ~template=#root/abc123 #tag(inheritable)</code>). As a result:</p><ul><li>Copied attributes can be pasted into the attributes editor or into a note, and the text of the attributes editor can be pasted into the attributes tab.</li><li>Attributes can be written by hand in any other application and then pasted into Trilium.</li></ul><p>When pasting, the attributes become owned attributes of the current note, even if they were inherited in the source note:</p><ul><li>If the note already has an attribute with the same name, its value is replaced by the pasted one.</li><li>If a definition marks the attribute as having multiple values (see <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>), the pasted value is added alongside the existing ones instead, unless the same value is already present.</li></ul><aside class=\"admonition note\"><p><kbd>Ctrl</kbd>+<kbd>V</kbd> pastes what the system clipboard holds, whereas the <span class=\"tn-icon bx bx-paste\"></span> button and the context menu paste the attributes last copied in Trilium. The two differ if something else was copied in the meantime.</p></aside><h2>Mobile</h2><p>On mobile, the attributes are the <em>Attributes</em> tab of the note panel (see <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>), which opens as a sheet at the bottom of the screen from the <span class=\"tn-icon bx bx-dock-bottom\"></span> button beside the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>. Selecting <em>Attributes</em> in the note menu, below <em>Backlinks</em> and <em>Note paths</em>, opens the panel on that tab. Tapping an attribute opens it on a page of its own, with a <span class=\"tn-icon bx bx-chevron-left\"></span> button to return to the list.</p><p>On mobile, the <a href=\"#toolbar\">toolbar</a> takes the place of the tab's name in the header of the sheet, and each section is displayed as a separate card:</p><ul><li>Attributes are added from the <span class=\"tn-icon bx bx-plus\"></span> button in the header, or from the <span class=\"tn-icon bx bx-plus\"></span> button above the <em>Definitions</em> card.</li><li>To select an attribute, press and hold it. Once an attribute is selected, tapping other attributes selects them as well.</li><li>Copying, pasting and deleting work the same way as on desktop, from the header.</li></ul>",
"_help_LrKznOtw9cQD": "<p>Once the <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> integration is activated, a <em>Chat</em> entry will appear in the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</p><ul><li>Unlike the dedicated note type, the side bar has optional access to the current note, making it easy to ask for information or modifications to a note without having to search for the note first.<ul><li>To toggle whether the current note is visible to the AI, simply click on the file icon at the bottom of the chat interface.</li></ul></li><li>On the top-right of the sidebar there are three buttons:<ul><li><span class=\"tn-icon bx bx-plus\"></span> creates a new conversation.</li><li><span class=\"tn-icon bx bx-history\"></span> goes to a previous conversation.</li><li><span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> opens a menu to rename or delete the current conversation, or to save it as a dedicated note in the <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>, which turns it into a dedicated chat note.</li></ul></li></ul><aside class=\"admonition note\"><p>The sidebar chats are stored in the <a class=\"reference-link\" href=\"#root/_help_2mUhVmZK8RF3\">Hidden Notes</a> and can be seen in the <em>AI Chat History</em> section.</p></aside><h2>Mobile</h2><p>On mobile, the chat is the <em>AI chat</em> tab of the note panel (see <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>). Its buttons are in the header of the sheet:</p><ul><li><span class=\"tn-icon bx bx-plus\"></span> on the left creates a new conversation.</li><li>The title of the current conversation, in the middle, lists the previous conversations when tapped.</li><li><span class=\"tn-icon bx bx-dots-vertical-rounded\"></span>, next to the close button, opens the same menu as on desktop.</li></ul>",
"_help_KRlZFoIH0j6p": "<figure class=\"image image-style-align-right image_resized\" style=\"width:33.35%;\"><img style=\"aspect-ratio:490/1801;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Right%20Sidebar/Connections%20tab_image.png\" width=\"490\" height=\"1801\"></figure><p>The connections tab groups together all the information about the current note and how it relates to other notes, in four different sections.</p><aside class=\"admonition note\"><p>It's generally best to keep only the desired sections expanded as each of the sections have to retrieve additional data that might not otherwise be needed. While collapsed, the sections do not retrieve any additional data.</p></aside><h2>Note map</h2><p>The note map displays a graph which shows the relation between the current notes and other notes on the hierarchy. There are two types of visualizations, which can be selected from the top-right part of the section:</p><ul><li>The <em>Link map</em> (<span class=\"tn-icon bx bx-network-chart\"></span>), which displays the <a href=\"#root/_help_Cq5X6iKQop6R\">relations</a> between notes.</li><li>The <em>Tree map</em> (<span class=\"tn-icon bx bx-sitemap\"></span>), which displays the hierarchical structure.</li></ul><p>The sidebar will remember which visualization is selected, as a global option. Note that note maps also have a <code>#mapType</code> which describes which visualization to use, but the sidebar deliberately ignores that to keep consistency when switching between notes.</p><p>The map can also be expanded by pressing the <span class=\"tn-icon bx bx-expand-alt\"></span> button in the top-right of the section. When expanded, the map is displayed in a separate dialog. Alternatively, all other sections can be collapsed, which will make the note map taller and the sidebar can be dragged to make for more lateral space.</p><p>The note map view inside the sidebar is deliberately more compact in order to fit the space: the link map would also show notes that don't have a link to the current note from the hierarchy (creating a cloud of dots) but this is only shown while the map is expanded. Similarly, the link strength and pin configuration buttons are not displayed here.</p><p>See also:</p><ul><li>The <a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a> note type</li><li><a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a> for more information on the concept as a whole.</li></ul><h2>Note paths</h2><p>The note paths section displays the locations in which the current note is <a href=\"#root/_help_IakOLONlIfGI\">cloned</a>. Each segment of the note path is clickable, in order to navigate to that note or clone. The root note is shown as its icon, the same as in the <a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a>; hovering it shows its title.</p><p>A new clone can be created from the <span class=\"tn-icon bx bx-duplicate\"></span> button at the top-right.</p><h2>Backlinks</h2><p>Backlinks list the notes that refer to the current note, as well as a preview of the content where the reference to the note is made.</p><p>For more information, see <a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>.</p><h2>Similar notes</h2><p>Displays a list of notes that appear similar based on the content of the notes and their attributes. For more information, see <a class=\"reference-link\" href=\"#root/_help_xWtq5NUHOwql\">Similar Notes</a>.</p>",
"_help_r5JGHN99bVKn": "<figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:988/572;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Recent%20Changes_image.png\" width=\"988\" height=\"572\"></figure><h2>Accessing the recent changes</h2><ul><li>For an overview of the changes across all documents, press the <span class=\"tn-icon bx bx-history\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.<ul><li>If there is a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>, the list of recent changes will be limited to the descendents of the hoisted note, or the workspace.</li><li>Right-clicking or pressing and holding the button lists up to 15 of the most recently changed notes that are not open in a tab. Selecting a note opens it in a new tab.</li></ul></li><li>To limit the list of recent changes to a note and its descendants, look for the corresponding option in the <a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a> → Advanced.</li><li>Right-clicking or pressing and holding the <span class=\"tn-icon bx bx-plus\"></span> button of the <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a> bar lists the most recently changed notes that are not open in a tab. <em>All recent changes</em>, at the bottom of that menu, opens this dialog.</li></ul><h2>Interaction</h2><ul><li>Notes which were changed will appear in reverse chronological order (latest update first).</li><li>The title of the note is displayed, as well as the note path. Clicking on the note title will dismiss the dialog and navigate to that particular note.</li><li>Deleted notes will also be listed here, at their time of deletion. Press the <em>Undelete</em> link next to them in order to recover them.</li></ul>",
"_help_ny318J39E5Z0": "<p>Zoom applies to the entire UI, including text.</p><p>On the desktop application, use the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> to zoom in/out.</p><p>On both web browser and the desktop, the keyboard shortcuts <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>+</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>-</kbd> can be used.</p><h2>Adjusting the text size instead</h2><p>As an alternative to the zoom, the text size can be individually adjusted by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em>.</p>",
"_help_lgKX7r3aL30x": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:505/261;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20Tooltip_image.png\" width=\"505\" height=\"261\"></figure><p>The note tooltip is a convenience feature which displays a popup when hovering over an <a href=\"#root/_help_hrZ1D00cLbal\">internal link</a> to another note.</p><p>The following information is displayed:</p><ul><li>The note path, at the top of the popup.</li><li>The title of the note.<ul><li>Clicking on the title will open the note in the current tab.</li><li>Holding <kbd>Ctrl</kbd> pressed while clicking the title will open in a new tab instead of the current one.</li></ul></li><li>A snippet of the content will be displayed as well.</li><li>A button to <a href=\"#root/_help_ZjLYv08Rp3qC\">quickly edit</a> the note in a popup.</li></ul><p>For a link to an <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a>, the tooltip shows the attachment instead: its title after the path of the note that owns it, a line giving its size (for example <em>Attachment • 20.59 MiB</em>), a preview of its content where one is available, and the quick edit button opening the attachment.</p><p>The tooltip can be found in multiple places, including:</p><ul><li>In <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, when hovering over <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> .</li><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>: <ul><li><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map View</a>, when hovering over a marker.</li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar View</a>, when hovering over an event.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table View</a>, when hovering over a note title, or over a <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a>.</li></ul></li></ul>",
"_help_SL5f1Auq7sVN": "<p>Split view is a feature of <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> and <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes which displays both the source code on one side and the preview of the content on the other.</p><p><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> also allow changing between a horizontal or a vertical split, to accommodate for the various sizes of diagrams.</p><h2>Display modes and interaction</h2><p>The split comes with three different display modes which can be toggled from the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area:</p><ul><li><span class=\"tn-icon bx bxs-dock-left\"></span> <em>(Split view)</em>, in which both the source code is available on one side and can be edited, and the preview is available on the other side.<ul><li>In this mode, the size of either the source pane or the preview pane can be adjusted by dragging the small border between them.</li></ul></li><li><span class=\"tn-icon bx bx-code\"></span> (<em>Source view)</em> which shows the source code on the entire screen for a more focused editing experience.</li><li><span class=\"tn-icon bx bx-show\"></span> <em>(Preview)</em> which displays only the rendering of the diagram or text in full screen, especially useful for read-only notes.</li></ul><p>The display node is stored at note level.</p><p>A Markdown note included in a text note, or a Markdown file embedded in one, has the same three display modes, switched from the title row and the toolbar of the include. See <em>Included Markdown</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h2>Relation to read-only notes</h2><p>If a note is marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a>, the source view will not be editable. While in preview mode, marking a note as read-only has no effect since the preview itself is not editable.</p>",
"_help_t596jLvPrqkS": "<p>Some note types (such as <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> and saved search) intentionally limit the width of the content.</p><p>This might appear surprising at first, but the idea is to make text fit well on wider screens without appearing distorted. This is especially the case if the document contains <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>, tables or other width-dependent elements.</p><h2>Configuring the content width and alignment</h2><p>The content width is expressed in pixels and can be changed from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> → <em>Content Width</em> and adjusting the <em>Max content width</em> section.</p><p>To effectively disable the content width limitation, simply set the width to a value larger than your screen size (e.g. 9999).</p><p>By default, the content is aligned to the left, but it can be centered horizontally by checking <em>Keep content centered</em> from the same section as the content width.</p><h2>Adjusting at note level</h2><p>For notes with large elements such as <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>, it sometimes makes sense to avoid the content width without affecting other notes. To do so:</p><ul><li>Go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and toggle <em>Full width</em>.</li><li>Or manually apply the <code>fullContentWidth</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to the note.</li></ul><p>Since v0.107.0, a single table can also be made wider than the content width, in which case it scrolls sideways. See <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>.</p><aside class=\"admonition note\"><p>Some <a href=\"#root/_help_KSZ04uQ2D1St\">note types</a> are full width by default, such as the <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>. In that case the <em>Full width</em> toggle will not be displayed and the label will have no effect.</p></aside><h2>Shared notes</h2><p>On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a text note is shown at a fixed reading width, whatever the width configured in Options, and the navigation tree, the content and the table of contents are kept together in a column centered on a wide screen. A note with <code>fullContentWidth</code>, or of a type that is full width in the application, uses the whole width of the window there, with the navigation tree and the table of contents at its edges.</p>",
"_help_jcQVxzYybYgz": "<figure class=\"image image-style-align-right image_resized\" style=\"width:44.65%;\"><img style=\"aspect-ratio:514/291;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Note%20contextual%20menu_image.png\" width=\"514\" height=\"291\"></figure><p>Right-clicking the content of some note types such as <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> or <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> reveals a contextual menu.</p><h2>Features</h2><ul><li>On the <a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, the <a class=\"reference-link\" href=\"#root/_help_oBo3iHIZnbG2\">Spell Check</a> suggestions are shown when right clicking on a misspelled word.</li><li>The selected text can be searched either with a search engine (configured in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Other</em>) or <a href=\"#root/_help_eIg8jdvaoNNd\">inside Trilium</a>.<ul><li>To remove the web search from the menu, choose <em>None</em> as the search engine.</li></ul></li><li>Basic clipboard functionality (cut, copy, paste).</li><li>Copying the selected text as <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>.</li><li>Performing quick operations using the <a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>.</li></ul><h2>Differences between desktop and web</h2><p>The <a href=\"#root/_help_WOcw2SLH6tbX\">web version</a> behaves slightly different due to limitations imposed by web browsers:</p><ul><li>When no text is selected or a word is right-clicked, the browser's default contextual menu is displayed.<ul><li>This is intentional since it preserves the <a class=\"reference-link\" href=\"#root/_help_oBo3iHIZnbG2\">Spell Check</a> functionality.</li></ul></li><li>When a text is selected, a reduced menu is displayed instead which features only the functionality that is available within the browser version<ul><li><em>Paste</em> is not available since the browser doesn't expose it, use <kbd>Ctrl</kbd>+<kbd>V</kbd> instead.</li><li>The browser menu can be triggered anyway by pressing <kbd>Shift</kbd> + <kbd>Right click</kbd>.</li></ul></li></ul>",
"_help_AlJ73vBCjWDw": "<p>The status bar displays information about the current note and allows changing settings related to it such as configuring the language or attributes.</p><h2>Layout and interaction</h2><p>On the left side, the <a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a> is displayed which indicates the current note as well as its parent notes and allows for quick navigation throughout the hierarchy.</p><p>On the right side, specific sections will show depending on the type of the current note.</p><ol><li>For <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, the language mode of the note is indicated (e.g. JavaScript, plain text), as well as allowing easy switching to another mode.<ol><li>Before it, the position of the cursor is shown as a line and a column, such as <em>Ln: 12 Col: 32</em>. It updates as the cursor moves. While text is selected, the number of selected characters follows, such as <em>Selected: 120</em>.</li></ol></li><li>For <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, the content language is displayed and can be changed, thus configuring the spell-check and the right-to-left support.<ol><li>Note that this applies to the entire note and not the selection, unlike some text editors.</li></ol></li><li>If a note is placed in multiple places in the tree (cloned), the number of the note paths will be displayed.<ol><li>Clicking it opens a popup with the full list of note paths, from which the note can also be cloned to a new location. The same list is available in the sidebar's <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li><li>If a note has attachments, their number will be displayed.<ol><li>Clicking on it will reveal the list of attachments in a new tab.</li></ol></li><li>If a note is linked from other text notes (backlinks), the number of backlinks will be displayed.<ol><li>Clicking on it opens a popup with the list of notes that link to this note, as well as an excerpt of where the note is referenced. The same list is available in the sidebar's <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li></ol><p>Regardless of note type, the following items will always be displayed if there is a note:</p><ol><li>Note info, which displays:<ol><li>The creation/modification date of the note.</li><li>The type and MIME of the note.</li><li>The note ID.</li><li>An estimation of the note size of the note itself and its children.</li><li>A button to reveal the Similar notes in the sidebar's <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a>.</li></ol></li></ol><aside class=\"admonition note\"><p>When pressing a button which reveals the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, it has a specific behavior if the sidebar is hidden: the sidebar will be peeked instead of docked. Regardless the sidebar will be switched to the appropriate tab and the corresponding section will be highlighted.</p></aside>",
"_help_I6p2a06hdnL6": "<figure class=\"image\"><img style=\"aspect-ratio:1150/27;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/UI%20Elements/Breadcrumb_image.png\" width=\"1150\" height=\"27\"></figure><p>The breadcrumb allows quickly viewing the note hierarchy of the current note and navigating through it.</p><p>It is part of the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, displayed in the bottom-left of the screen.</p><h2>Layout and Interaction</h2><ul><li>If a note or workspace is hoisted, a badge will appear on the left-most side.<ul><li>Clicking on the badge will un-hoist the note/workspace.</li></ul></li><li>The left-most icon represents the root note, or the hoisted note or workspace.<ul><li>Clicking the icon will jump to the root note.</li><li>Right clicking the icon will display a menu that allows opening the note in a new tab, split, etc.</li></ul></li><li>Each segment shows the title of a note in the current note hierarchy.<ul><li>Clicking the icon will jump to that note.</li><li>Right clicking will open a menu with multiple options such as opening the note in a different tab/split/window, hoisting, moving/cloning the note, duplicating as well as changing the color of the note.</li></ul></li><li>Clicking the arrow next to each segment will reveal the child notes of the segment on the left.<ul><li>Clicking on an icon will navigate to that particular note.</li><li>To find a child note by its title, start typing: the field at the bottom of the menu filters the list.</li><li>It's also possible to create a new child note from here.</li><li>The menu can optionally hide the archived notes.</li></ul></li><li>If the current note is deep within a hierarchy, the segments will collapse into a […] button in order not to occupy too much space.<ul><li>Clicking this button will display each collapsed entry as a menu item. Clicking on it will navigate to that particular note.</li></ul></li><li>Right clicking on an empty space to the right of the breadcrumb (before the other status bar items) will reveal another menu that allows:<ul><li>Toggling whether archived notes are displayed in the breadcrumb and in the note tree.</li><li>Copying the current note path to clipboard.</li></ul></li></ul>",
"_help_BFs8mudNFgCS": "<p>Note is a central entity in Trilium. Main attributes of note are <a href=\"#root/_help_l7pigIGu01K2\">title</a> and content.</p><h3>Note types</h3><p>The main note type is a rich-text note type called <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>. For diagrams and drawing there is <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> and <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>.</p><p>There are also more complex note types such as <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>, <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a> that usually go hand-in-hand with <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>.</p><p>In Trilium there's no specific \"folder\" note type. Any note can have children and thus be a folder. To make a note that only shows its children, like a folder in other applications, use a <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a> or <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a> collection. See also <a class=\"reference-link\" href=\"#root/_help_i6dbnitykE5D\">FAQ</a>.</p><h3>Root note</h3><p>There's one special note called \"root note\" which is root of the note tree. All other notes are placed below it in the structure.</p><h3>Tree structure</h3><p>Importantly, note itself doesn't carry information on its placement in note tree. See <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> for details.</p><p>Tree structure of notes can resemble file system - but compared to that notes in Trilium can act as both file and directory - meaning that note can both have its own content and have children. \"Leaf note\" is a note which doesn't have any children.</p><h3>Deleting / undeleting notes</h3><p>When you delete a note in Trilium, it is actually only marked for deletion (soft-delete) - the actual content, title, attributes etc. are not deleted, only hidden.</p><p>Within (by default) 7 days, it is possible to undelete these soft-deleted notes - open the <a class=\"reference-link\" href=\"#root/_help_r5JGHN99bVKn\">Recent Changes</a> dialog, and you will see a list of all modified notes including the deleted ones. Notes available for undeletion have a link to do so. This is kind of \"trash can\" functionality known from e.g. Windows.</p><p>Clicking an undelete will recover the note, its content and attributes - note should be just as before being deleted. This action will also undelete note's children which have been deleted in the same action.</p><p>To be able to undelete a note, it is necessary that deleted note's parent must be undeleted (otherwise there's no place where we can undelete it to). This might become a problem when you delete more notes in succession - the solution is then undelete in the reverse order of your deletion.</p><p>After the 7 days (configurable) the notes will be \"erased\" - their title, content, revisions and attributes will be erased, and it will not be possible anymore to recover them (unless you restore a <a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a>).</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a></li></ul>",
"_help_l7pigIGu01K2": "<p>Alongside its content, the <strong>title</strong> is one of the two main attributes of a <a href=\"#root/_help_BFs8mudNFgCS\">note</a>. It's the short, human-readable name shown in the editable field at the top of every note, and it's what identifies the note throughout the interface (in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, in tabs, in the <a class=\"reference-link\" href=\"#root/_help_I6p2a06hdnL6\">Breadcrumb</a> and win <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>Internally, notes are identified by a unique <a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a> rather than by their title, so the title is purely for your benefit. This has a few consequences:</p><ul><li><strong>Titles don't have to be unique.</strong> You can have any number of notes that share the same title without conflict.</li><li><strong>Renaming a note never breaks links to it.</strong> Links between notes point at the underlying note, so changing a title leaves existing links intact (they'll simply display the new title).</li><li><strong>The title can be left empty.</strong> Notes with no title display a placeholder (<em>type note's title here…</em>) but are otherwise perfectly valid.</li></ul><p>In addition:</p><ul><li>There is no limitation on the length of the title, however in exports the title might get trimmed.</li><li>There are no forbidden symbols, unsupported characters will get trimmed when exporting.</li><li>When exporting to a ZIP file, a meta file will contain the full title which will be recognized by Trilium when importing again.</li></ul><h2>Inline title</h2><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes have a special title bar behavior in which the <a href=\"#root/_help_l7pigIGu01K2\">note title</a> is initially displayed in a larger font, while also displaying additional information such as the creation and the modification date.</p><p>Whenever the title is scrolled past, the fixed title is shown instead.</p><p>Note types that take the entirety of the screen, such as <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> and <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>, will always have only the fixed title bar.</p><p>Under the note title, the <a class=\"reference-link\" href=\"#root/_help_m3VlURMSeOrd\">New note type switcher</a> appears if the note is empty.</p><figure class=\"image\"><img style=\"aspect-ratio:899/122;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Title_image.png\" width=\"899\" height=\"122\"><figcaption>The <em>Inline title</em>, which is displayed at the top of the note and can be scrolled past.</figcaption></figure><figure class=\"image\"><img style=\"aspect-ratio:910/104;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/1_Title_image.png\" width=\"910\" height=\"104\"><figcaption>The fixed title bar. The title only appears after scrolling past the <em>Inline title</em>.</figcaption></figure><h3>Editing the title</h3><p>To rename a note, simply click into the title field and type. Changes are saved automatically as you type.</p><p>You can also begin editing the title directly from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> by selecting a note and pressing <kbd>Enter</kbd> (see <em>Edit note title</em> in <a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>), which focuses the title field for the active note.</p><aside class=\"admonition note\"><p>Titles may contain any characters, including Unicode and emoji. For security, any HTML in the title is stripped automatically, so the title is always treated as plain text.</p></aside><h3>Easily navigating between the title and the content</h3><p>When the cursor is in the title field, pressing <kbd>Enter</kbd> moves focus into the note's content. For <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes this also inserts a fresh empty paragraph at the very top of the document, so you can start writing immediately — much like other note-taking apps.</p><p>This makes it possible to create a note, type its title, press <kbd>Enter</kbd>, and continue straight into the body without reaching for the mouse.</p><h3>Working with new notes</h3><p>When you create a new note it's given a default title (<em>new note</em>) which is pre-selected, so you can type a name right away to replace it. The default title for new notes can be customized per-section — see <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a>.</p><p>If you decide you don't want the note after all, pressing <kbd>Escape</kbd> while the title of a freshly created note is still focused will discard it.</p><h3>Automatically generated titles</h3><p>Some notes get their titles assigned automatically rather than typed:</p><ul><li><strong>Day, week, month and year notes</strong> in the <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a> are named from a configurable date pattern.</li><li><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> notes are named after the search they perform.</li><li>When a note is duplicated, a suffix is appended to the copy's title to tell it apart from the original.</li></ul><h3>Protected notes</h3><p>The titles of <a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a> are encrypted along with their content. Before entering your password, Trilium cannot decrypt the title: the note tree, the title field, the breadcrumb menus and the tabs label the note <em>Protected</em>, and the title cannot be modified.</p><p>Once you enter your password and a protected session is active, the real title is decrypted and displayed, and becomes editable again.</p>",
"_help_p9kXRFAkwN4o": "<h2>Icons</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:48.4%;\"><img style=\"aspect-ratio:1089/995;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20Icons%20%26%20Colors_image.png\" width=\"1089\" height=\"995\"></figure><p>Icons are useful for distinguishing notes and are displayed near the note title, as well as in various places such as the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> or the <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to & command palette</a>.</p><p>While editing a note, click on the icon next to the title to bring up a chooser gallery.</p><p>Icons can be inherited through the use of <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, or <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p><aside class=\"admonition note\"><p>At the technical level, they are set by the <code>iconClass</code> attribute which adds a CSS class to the note. For example <code>#iconClass=\"bx bx-calendar\"</code> will show a calendar instead of the default page or folder icon. Looking up and remembering the CSS class names is not necessary.</p></aside><h2>Colors</h2><p>Notes can also carry a custom color. Similar to the note icon, this color will be shown in various places such as the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>To set a custom color, right click on the note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select a predefined color from there or use the color picker (last option).</p><p>Alternatively, a custom color can be set manually through the <code>#color</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, whose value must be a valid hex color including the leading <code>#</code> (e.g. <code>#ff0000</code> for red). This color can be carried over across multiple notes via <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p>",
"_help_0vhv7lsOLy82": "<p>A <a href=\"#root/_help_BFs8mudNFgCS\">note</a> in Trilium can <em>own</em> one or more attachments, which can be either images or files. These attachments can be displayed or linked within the note that owns them.</p><p>This can be especially useful to include dependencies for your <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a>. The <a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a> shows how to use <a href=\"https://chartjs.org/\">chartjs</a> which is attached to the script note.</p><p>Each note exclusively owns its attachments, meaning attachments cannot be shared or linked from one note to another. If an attachment link is copied to a different note, the attachment itself is duplicated, and the copies are managed independently thereafter.</p><p>Attachments, especially image files, are the recommended method for embedding visuals in notes. It is important to link image attachments within the text of the owning note; otherwise, they will be automatically deleted after a configurable timeout period if not referenced.</p><h2>Types of attachments</h2><p>There are two different types of attachment:</p><ul><li><em>User content</em>, representing files or images that are uploaded and part of the content of the note.</li><li><em>System attachments</em> which are used internally by Trilium and can be of multiple types, including:<ul><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> to store information about views such as the column information for the <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>.</li><li>Icons and cover images for <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>.</li><li>Debug information for some importers such as <a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a> (only if the debug flag was enabled at import time).</li><li>The transcript of a <a class=\"reference-link\" href=\"#root/_help_Y84QCbArmK3z\">Meeting transcription</a>, which is also shown above the note's content.</li><li>The SVG picture of a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> note (<code>canvas-export.svg</code>), and of each drawing canvas in a text note (see <em>Drawing canvases</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>), used for previews and shared pages.</li></ul></li></ul><p>The system attachments are displayed at the end of the attachments list, in a dedicated section (<em>Generated by Trilium</em>).</p><h2>Uploading attachments</h2><p>The <span class=\"tn-icon bx bx-paperclip\"></span><em>Attachments</em> item of the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> opens the list of the note's attachments.</p><ul><li>To upload files as attachments, press <em>Upload attachments</em> at the top of the list and select one or more files.</li><li>Alternatively, drag one or more files from the file explorer and drop them anywhere on the list. Pictures are compressed if <em>Automatic image compression</em> is enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>.</li></ul><h2>Attaching files from a text note</h2><p>To attach files to a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note and embed them in its content, press the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, choose <em>Attach and embed file</em> and select one or more files (see <em>Embedding an attachment</em> below). The same menu offers <em>Image</em>, which inserts pictures (see <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>), and <em>Attach file as a link</em>, which links the files instead. Both file actions are also available as <em>Attach file as a link</em> and <em>Attach and embed file</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>. On a phone, the menu also offers <em>Camera</em> (see <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>).</p><p>When files are attached as links:</p><ul><li>Each file becomes an attachment of the note, and a link to it is inserted at the cursor. Several files produce several links, separated by a space.</li><li>While a file uploads, its link shows the file name and a toast shows the progress.</li><li>Pictures appear as links rather than images, and are attached exactly as they are, without being compressed. To display a picture in the text, use <em>Image</em> in the same menu instead (see <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>).</li></ul><p>Dragging a file that is not a picture from the file explorer onto the text also attaches it and inserts a link to it.</p><h2>Acting on an attachment link</h2><p>Right-clicking a link to an attachment shows the ways to open it, followed by actions on the attachment: opening it externally, downloading it, uploading a new revision, renaming or deleting it, and converting it into a note.</p><p>Links follow changes to their attachment: renaming it updates the title they show, and deleting it removes them from the text notes open for editing at that moment. Converting it into a note turns its links into links to the new note.</p><h2>Embedding an attachment</h2><p>An attachment can be shown in the text instead of linked, the way <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> shows a note: a picture is displayed, a PDF, a video or a document is previewed, a code or text file is shown with syntax highlighting, and a Markdown file such as a <code>.md</code> file is shown rendered. An embedded code file can also be edited in place (see <em>Editing an include in place</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>), and an embedded Markdown file shows its source, its rendering or both, as an included Markdown note does (see <em>Included Markdown</em> there).</p><ul><li>To attach files and embed them straight away, press the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button and choose <em>Attach and embed file</em>. Each file gets an embed of its own, which shows the file name while the file uploads.</li><li>To embed an attachment that is already linked, right-click a link to it in a text note being edited and select <em>Convert link to an embed</em>, at the end of the menu.</li><li>A drawing canvas, inserted with <span class=\"tn-icon bx bx-pen\"></span><em>Drawing canvas</em> in the <span class=\"tn-icon cke cke-plus\"></span><em>Insert</em> menu, is an embed of a <code>Canvas.excalidraw</code> attachment that can be drawn on in place. An attached Excalidraw file (<code>.excalidraw</code>) is embedded as a drawing canvas too (see <em>Drawing canvases</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>).</li><li>An embed gets the box size that suits the attachment, as a new included note does (see <em>Box sizes</em> there). To change its size, select the embed and use the box size menu in its toolbar, or the <em>Size</em> submenu of its <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span><em>More actions</em> menu. A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> embed can also be resized by dragging its handles (see <em>Resizing</em> there), and placed at the left or the right of the note, with or without the text running beside it, from the <em>Position</em> submenu of its menu (see <em>Positioning</em> there).</li><li>An embed can have a caption, as an included note can (see <em>Caption</em> there).</li><li>To show only the attachment, select the embed and press the <span class=\"tn-icon bx bx-window-alt\"></span> (<em>Show title)</em> button in its toolbar, as for an included note (see <em>Title</em> there).</li><li>To open the attachment in a new tab, press the <span class=\"tn-icon bx bx-link-external\"></span> (<em>Open in new tab)</em> button at the end of the embed's title.</li><li>An embed of size <em>Tiny</em> shows only the title of the attachment and its size, in a single row. Its buttons are <span class=\"tn-icon bx bx-file-find\"></span><em>Open externally</em> and <span class=\"tn-icon bx bx-download\"></span><em>Download</em>.</li><li>To show an embed of size <em>Medium</em> or <em>Full</em> on the whole screen, press the <span class=\"tn-icon bx bx-fullscreen\"></span> (<em>Fullscreen)</em> button at the end of its title. To return, press <span class=\"tn-icon bx bx-exit\"></span> (<em>Exit fullscreen)</em> in the top-right corner, or <kbd>Esc</kbd>.</li><li>To turn the embed back into a link, select it and press the <span class=\"tn-icon cke cke-link\"></span><em>Convert to link</em> button in its toolbar. <em>Convert to link</em> is also in the menu that right-clicking the title row of the embed or pressing its <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span><em>More actions</em> button opens, above <span class=\"tn-icon bx bx-trash\"></span><em>Delete</em>, which removes the embed from the note.</li></ul><p>An embed follows its attachment like a link does. Converting the attachment into a note turns the embed into an included note. In a <a href=\"#root/_help_R9pX4DGra2Vt\">shared note</a>, an embedded picture is displayed with its caption, a drawing canvas as a picture of the drawing, and any other attachment, or a picture in a <em>Tiny</em> embed, appears as a link to download it.</p><h2>Converting notes to attachments</h2><p><a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> notes can be easily converted to attachments of the parent note.</p><p>To do so:</p><ul><li>For a single note, press the context menu from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and select <em>Convert into attachment</em>.</li><li>For multiple notes, select the given notes in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click → Advanced → <em>Convert to attachment…</em>.</li></ul><h2>Attachment previews</h2><p>Attachments share the same content preview for images, videos, PDFs, etc. as the <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> note type. A Markdown attachment is previewed rendered, as a <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> note is.</p>",
"_help_IakOLONlIfGI": "<h2>Motivation</h2><p>Trilium's core feature is the ability to structure your notes into hierarchical tree-like structure.</p><p>It is expected then that you'll have an elaborate and deep note hierarchy - each subtree will represent a more refined and specialized view of your knowledge base.</p><p>This is a pretty powerful approach, but it also carries a hidden assumption that each \"subtopic\" is \"owned\" by one parent. I'll illustrate this with an example - let's say my basic structure is this:</p><ul><li>Technology<ul><li>Programming<ul><li>Kotlin</li><li>JavaScript</li></ul></li><li>Operating systems<ul><li>Linux</li><li>Windows</li></ul></li></ul></li></ul><p>Now, I'm starting to learn about <a href=\"https://en.wikipedia.org/wiki/Bash_(Unix_shell)\">Bash</a> and would like to create notes related to this topic. But now I'm facing a problem of where to categorize this. The issue here is that Bash is both a programming language and a tool (shell) very much tied into Linux. It seems it belongs to both of these, I can't (and don't want to) choose one over the other.</p><h2>Solution</h2><p>The solution to the problem shown above is to allow notes to have multiple parents.</p><p>I call these \"clones\", but that is a bit misleading - there's no original and cloned note - the notes in both of the parents categories are identical.</p><p>Another misleading thing about \"cloning\" is that it suggests that a copy of the note has been made. That's not really true, the note itself stays in just one original, it is just referenced in multiple places in the tree hierarchy. So changing it in one category changes it in all the others, because they're all the same note.</p><p>Here's the final structure with cloning:</p><ul><li>Technology<ul><li>Programming<ul><li>Kotlin</li><li>JavaScript</li><li>Bash<ul><li>some sub-notes ...</li></ul></li></ul></li><li>Operating systems<ul><li>Linux<ul><li>Bash<ul><li>some sub-notes ...</li></ul></li></ul></li><li>Windows</li></ul></li></ul></li></ul><p>So now the \"Bash\" subtree appears on multiple locations in the hierarchy. Both the Bash subtrees are the same and contain the same sub-categories and notes.</p><h3>Demo</h3><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Cloning%20Notes_create-clone.gif\"></p><p>In the demo, you can see how a clone can be created using the context menu. It's possible to do this also using the Add Link dialog or with <kbd>Ctrl</kbd>+<kbd>C</kbd> and <kbd>Ctrl</kbd>+<kbd>V</kbd> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcuts</a>.</p><p>You can view the list of all available clones:</p><ul><li>In the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, by looking for the <span class=\"tn-icon bx bx-directions\"></span> icon.</li><li>In the <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a> of the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, by looking at the <em>Note paths</em> section.</li></ul><p>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, on desktop and on mobile, the title of a cloned note is followed by a <span class=\"tn-icon bx bxs-directions\"></span> icon, to easily see that the note is also placed into some other location. A shared note is followed by a <span class=\"tn-icon bx bx-share-alt\"></span> icon in the same way.</p><h2>Deleting notes/clones</h2><p>With clones, it might not be immediately obvious how deleting works.</p><p>If you try to delete a note, it works like this:</p><ol><li>if the note has multiple clones, delete just this clone and leave the actual note (and its other clones) as it is.</li><li>if this note doesn't have any other clones, delete the note<ul><li>Run the whole process starting with 1. on all note's children notes</li></ul></li></ol>",
"_help_TBwsyfadTA18": "<p>Since a single note can appear into multiple places in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> via a process called <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>, it's recommended to choose a generalized name that fits into all locations instead of something more specific to avoid confusion.</p><p>In some cases this isn't possible so Trilium provides \"branch prefixes\", which is shown before the note name in the tree and as such provides a specific kind of context.</p><p>The prefix is location-specific, so it's displayed only in the note tree.</p>",
"_help_bwg0e8ewQMak": "<p>Trilium is designed to store a wide variety of data, including sensitive information such as personal journals, credentials, or confidential documents. To safeguard this type of content, Trilium offers the option to protect notes, which involves the following measures:</p><ul><li><strong>Encryption:</strong> Protected notes are encrypted using a key derived from your password. This ensures that without the correct password, protected notes remain indecipherable. Even if someone gains access to your Trilium <a href=\"#root/_help_wX4HbRucYSDD\">database</a>, they won't be able to read your encrypted notes.</li><li><strong>Time-limited access:</strong> To access protected notes, you must first enter your password, which decrypts the note for reading and writing. However, after a specified period of inactivity (10 minutes by default), the note is unloaded from memory, requiring you to re-enter your password to access it again.<ul><li>The session timeout is extended automatically while you're interacting with the protected note, so if you're actively editing, the session remains open. However, if you switch to an unprotected note, the session timer starts, and the session expires after 10 minutes of inactivity unless you return to the protected notes.</li></ul></li><li><strong>Protection scope:</strong> Protected notes ensure the confidentiality of their content and partially their integrity. While unauthorized users cannot read or edit protected notes, they can still delete or move them outside of the protected session.</li></ul><h2>Using Protected Notes</h2><p>By default, notes are unprotected. To protect a note, simply click on the shield icon next to the note's title, as shown here:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Protected%20Notes_protecting-note.gif\" alt=\"example animation of unlocking protected notes\"></p><h2>What is Encrypted?</h2><p>Trilium encrypts the data within protected notes but not their metadata. Specifically:</p><p><strong>Encrypted:</strong></p><ul><li>Note title</li><li>Note content</li><li>Images</li><li>File attachments</li></ul><p><strong>Not encrypted:</strong></p><ul><li>Note structure (i.e., it remains visible that there are protected notes)</li><li>Metadata, such as the last modified date</li><li><a href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a></li></ul><h2>Encryption Details</h2><p>The following steps outline how encryption and decryption work in Trilium:</p><ol><li>The user enters a password.</li><li>The password is passed through the <a href=\"https://en.wikipedia.org/wiki/Scrypt\">scrypt</a> algorithm along with a \"password verification\" <a href=\"https://en.wikipedia.org/wiki/Salt_(cryptography)\">salt</a> to confirm that the password is correct.</li><li>The password is then processed again through scrypt with an \"encryption\" salt, which generates a hash.<ul><li>Scrypt is used for <a href=\"https://en.wikipedia.org/wiki/Key_stretching\">key stretching</a> to make the password harder to guess.</li></ul></li><li>The generated hash is used to decrypt the actual <em>data encryption key</em>.<ul><li>The data encryption key is encrypted using <a href=\"https://en.wikipedia.org/wiki/Advanced_Encryption_Standard\">AES-128</a> with a random <a href=\"https://en.wikipedia.org/wiki/Initialization_vector\">IV</a>.</li><li>The data encryption key is randomly generated during the <a href=\"#root/_help_wX4HbRucYSDD\">database</a> initialization and remains constant throughout the document’s lifetime. When the password is changed, only this key is re-encrypted.</li></ul></li><li>The data encryption key is then used to decrypt the actual content of the note, including its title and body.<ul><li>The encryption algorithm used is AES-128 with <a href=\"https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation\">CBC mode</a>, where a unique IV is generated for each encryption operation and stored with the cipher text.</li></ul></li></ol><h2>Sharing Protected Notes</h2><p>Protected notes cannot be shared in the same way as regular notes. Their encryption ensures that only authorized users with the correct password can access them.</p>",
"_help_MKmLg5x6xkor": "<p>Archived notes are notes which have <code>archived</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> - either directly or <a href=\"#root/_help_bwZpz2ajCEwO\">inherited</a>.</p><p>Such notes are then by default not shown in the autocomplete and in the full text <a href=\"#root/_help_eIg8jdvaoNNd\">search</a>.</p><p>This can be useful for notes which are no longer very useful but still valuable enough to keep around without them getting too much in the way.</p><p>You can control whether archived notes are displayed in the note tree with a setting:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Archived%20Notes_hide-archived.png\"></p>",
"_help_vZWERwf8U3nx": "<figure class=\"image\"><img style=\"aspect-ratio:2089/1515;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20Revisions_image.png\" width=\"2089\" height=\"1515\"></figure><p>Trilium supports seamless versioning of notes by storing snapshots (\"revisions\") of notes at regular intervals.</p><p>To display the revisions, press the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and select <em>Note revisions…</em> (<span class=\"tn-icon bx bx-history\"></span>).</p><h2>Interaction</h2><aside class=\"admonition note\"><p>This documentation matches the redesign of the note revisions dialog on v0.103.0, older versions have a similar dialog but with some differences.</p></aside><ul><li>The full list of revisions are displayed on the left in reverse chronological order.<ul><li>The revisions are grouped by the date the revision was taken.</li><li>This list does not contain the <em>current state</em> of the note, so it is possible to have notes with no revisions/snapshots saved.</li></ul></li><li>The icon of a revision indicates the <em>source</em> of that revision (e.g. a <span class=\"tn-icon bx bx-save\"></span> icon for a manually saved revision).</li><li>Pressing the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> button on the top-right of the dialog displays multiple options, including:<ul><li><span class=\"tn-icon bx bx-save\"></span> Saving a new revision now.</li><li>Checking the interval and limit for this note (see below).</li><li><span class=\"tn-icon bx bx-trash\"></span> Deleting all the revisions of this note.</li></ul></li><li>For supported notes (text, code), changes are highlighted. This behavior can be toggled via the <em>Highlight changes</em> at the top of the dialog.<ul><li>The highlighted changes are relative to the <strong>current state of the note</strong>, not to the revision prior to this one.</li></ul></li><li>For any given revision, the buttons on the top-right allow operating on it:<ul><li><span class=\"tn-icon bx bx-trash\"></span> Deleting the revision.</li><li><span class=\"tn-icon bx bx-download\"></span> Downloading the revision locally.</li><li><span class=\"tn-icon bx bx-history\"></span> Restoring the revision, which replaces the current content of the note with the one from the revision. Another revision is saved containing the current content of the note.</li></ul></li></ul><h2>Named revisions</h2><p>Named revisions are a new feature of Trilium v0.103.0 which allows adding a short description of what the changes in the snapshot contain.</p><p>In the list of note revisions:</p><ul><li>The name of the revision is displayed underneath the time of the revision in the sidebar, as well as at the top of the dialog where it is displayed in full.</li><li>Clicking on the <span class=\"tn-icon bx bx-edit-alt\"></span> edit button near the name of the revision allows it to be changed.</li></ul><p>To create a named revision, either:</p><ul><li>Go to the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, select <em>Note revisions…</em> → <em>Save named revision…</em> (<span class=\"tn-icon bx bx-purchase-tag\"></span>), enter the name of revision and confirm.</li><li>Use the corresponding <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> or the <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to & command palette</a> command with the same name.</li><li>Save a revision normally, and adjust the name afterwards from the note revision list.</li></ul><h2>When revisions are saved</h2><p>Revisions are saved:</p><ul><li>Automatically at a fixed interval. This behavior can be configured (see below).</li><li>Manually, by:<ul><li>Going to the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and selecting <em>Note revisions…</em> → <em>Save revision</em> (<span class=\"tn-icon bx bx-save\"></span>).</li><li>Using the <em>Force Save Revision</em> <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a>.</li><li>In the <em>Note Revisions</em> dialog, pressing the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> button in the top-right and selecting <em>Save a revision now</em>.</li></ul></li></ul><p>Additionally, revisions can also come from somewhere else, and this is indicated via the icon of the revision:</p><ul><li><span class=\"tn-icon bx bx-code-alt\"></span> Generated externally, by <a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>.</li><li><span class=\"tn-icon bx bx-bot\"></span> A modification created by <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a>.</li><li><span class=\"tn-icon bx bx-history\"></span> A revision is restored, causing the existing note content to be saved as a revision to prevent potential data loss.</li></ul><h4>Snapshot interval</h4><p>Time interval of taking note snapshot is configurable in the Options → Other dialog. This provides a trade-off between more revisions and more data to store.</p><p>To turn off note versioning for a particular note (or sub-tree), add <code>disableVersioning</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> to the note.</p><h4>Maximum revisions</h4><p>The limit on the number of note snapshots can be configured in the Options → Other dialog. The note revision snapshot number limit refers to the maximum number of revisions that can be saved for each note. Where -1 means no limit, 0 means delete all revisions. You can set the maximum revisions for a single note through the <code>versioningLimit=X</code> label.</p><p>The note limit will not take effect immediately; it will only apply when the note is modified.</p><p>You can click the <em>Erase now</em> button under <em>Erase excess revision snapshots</em> to apply the changes immediately.</p>",
"_help_aGlEvb9hyDhS": "<p>Trilium can sort the child notes of a note once, using the <em>Sort by…</em> dialog, or keep them sorted permanently, using the <code>#sorted</code> label. Both sort by the same criteria: the title, the creation or modification date, or the value of a label on the child notes, and both can combine several of these into sorting levels.</p><h2>Sorting once with the dialog</h2><p>To sort the children of a note once, right-click it in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Sort by…</em>, or select it and press <kbd>Alt</kbd>+<kbd>S</kbd>. The order is applied to the existing child notes only; notes added later are placed wherever they are created.</p><p>The dialog consists of:</p><ul><li><em>Sorting criteria</em>, a list of levels. Each level sorts by <em>Title</em>, <em>Date created</em>, <em>Date modified</em> or <em>Label</em> (followed by the name of the label), <em>Ascending</em> or <em>Descending</em>.<ul><li>To sort by more than one criterion, select <em>Add level</em>. The first level decides the order; the next level only decides between notes the previous ones left equal (see <em>Sort levels</em> below).</li><li>To change the order of the levels, use the <span class=\"tn-icon bx bx-up-arrow-alt\"></span> and <span class=\"tn-icon bx bx-down-arrow-alt\"></span> buttons. To remove a level, use the <span class=\"tn-icon bx bx-x\"></span> button.</li></ul></li><li><em>Sort folders at the top</em>, which places notes that have children of their own before the others. When the first level is descending, they are placed at the bottom instead.</li><li><em>Natural sort</em>, which compares numbers and characters by the rules of a language (see <em>How values are compared</em> below). <em>Natural sort language</em> sets the language code, for example <code>zh-CN</code> for Chinese.</li></ul><p>Notes with <code>#top</code> or <code>#bottom</code> stay at the top or bottom, as with automatic sorting (see <em>Pinning notes to the top or bottom</em> below).</p><h2>Keeping child notes sorted</h2><p>To keep the children of a note sorted, add the <code>#sorted</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to it. Trilium sorts its child notes again whenever a child is added or changes, and whenever the sorting labels change.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>#sorted</code></td><td>Keeps the child notes sorted. Without a value, they are sorted by title; with a value, by the levels it lists (see <em>Sort levels</em> below). <code>#sorted=off</code> turns sorting off.</td></tr><tr><td><code>#sortDirection</code></td><td><code>asc</code> (the default) or <code>desc</code>. The direction of every level that doesn't specify its own.</td></tr><tr><td><code>#sortFoldersFirst</code></td><td>Places notes that have children of their own before the others, or after them when <code>#sortDirection</code> is <code>desc</code>.</td></tr><tr><td><code>#sortNatural</code></td><td>Compares numbers by their value instead of character by character, so 2 comes before 10.</td></tr><tr><td><code>#sortLocale</code></td><td>The language code for <code>#sortNatural</code>, for example <code>zh-CN</code> or <code>de</code>.</td></tr><tr><td><code>#top</code></td><td>On a child note: keeps it at the top of its sorted parent.</td></tr><tr><td><code>#bottom</code></td><td>On a child note: keeps it at the bottom of its sorted parent.</td></tr></tbody></table></figure><p>The labels apply to the note that carries them and, when made <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable</a>, to every note below it, so a single <code>#sorted(inheritable)</code> sorts a whole subtree. A note created from a <a href=\"#root/_help_KC1HB96bqqHX\">template</a> that has <code>#sorted</code> keeps its children sorted too. To exclude part of such a subtree, add <code>#sorted=off</code> to the note whose children must keep their manual order; to exclude everything below it as well, make that label inheritable too.</p><h2>Sort levels</h2><p>The value of <code>#sorted</code> is a comma-separated list of levels, written like the <code>orderBy</code> of a <a href=\"#root/_help_eIg8jdvaoNNd\">search</a>. Each level is one of:</p><ul><li>A label on the child notes, written with <code>#</code>, such as <code>#priority</code>.</li><li>One of the properties <code>title</code>, <code>dateCreated</code> and <code>dateModified</code>, written without <code>#</code>.</li><li><code>folders</code>, which only the notes with children of their own have (see <em>Grouping</em> below).</li></ul><p>A level can be followed by <code>asc</code> or <code>desc</code> to set its direction; otherwise it follows <code>#sortDirection</code>.</p><p>The child notes are sorted by the first level. Notes that are equal at that level are sorted by the second level, and so on. Notes equal at every level are sorted by title, in the direction of <code>#sortDirection</code>.</p><p>A child note that doesn't have a level's label is placed after every child that has it, whichever direction the level runs in. Between two notes that both lack it, the next level decides.</p><p>For example, <code>#sorted=\"#priority desc, #dueDate\"</code> on a parent with these children:</p><figure class=\"table\"><table><thead><tr><th>Child note</th><th>Labels</th></tr></thead><tbody><tr><td>Book report</td><td><code>#priority=2</code> <code>#dueDate=2026-11-01</code></td></tr><tr><td>Groceries</td><td><code>#priority=1</code></td></tr><tr><td>Taxes</td><td><code>#priority=2</code> <code>#dueDate=2026-10-25</code></td></tr><tr><td>Ideas</td><td>none</td></tr></tbody></table></figure><p>sorts them as <em>Taxes</em>, <em>Book report</em>, <em>Groceries</em>, <em>Ideas</em>. The highest priority comes first; <em>Taxes</em> and <em>Book report</em> share it, so the earlier due date decides between them. <em>Ideas</em> has no priority and goes last.</p><p>A value that is a single name without <code>#</code> is read the way older versions did: <code>title</code>, <code>dateCreated</code> or <code>dateModified</code> is a property, and any other name is a label, so <code>#sorted=myOrder</code> sorts by the <code>#myOrder</code> label of the children.</p><aside class=\"admonition warning\"><p>Since v0.107.0, a label in a <code>#sorted</code> value with more than one level, or with a direction, must be written with <code>#</code>. In v0.106.0 the names were written bare, as in <code>#sorted=\"priority desc, dueDate\"</code>; such a value now reads both names as properties that don't exist, and the notes fall back to sorting by title. Add a <code>#</code> before each label name to restore it.</p></aside><h2>Grouping with <code>first</code> and <code>last</code></h2><p>A label followed by <code>first</code> or <code>last</code> doesn't sort by the label's value: it places the child notes that have the label, with any value, before or after the rest. The levels that follow then sort within each group. Grouping ignores <code>#sortDirection</code>.</p><p>For example, <code>#sorted=\"#archived last, #priority desc\"</code> on a parent with these children:</p><figure class=\"table\"><table><thead><tr><th>Child note</th><th>Labels</th></tr></thead><tbody><tr><td>Old project</td><td><code>#archived</code> <code>#priority=3</code></td></tr><tr><td>Draft</td><td><code>#priority=1</code></td></tr><tr><td>Launch</td><td><code>#priority=3</code></td></tr><tr><td>Meeting notes</td><td>none</td></tr></tbody></table></figure><p>sorts them as <em>Launch</em>, <em>Draft</em>, <em>Meeting notes</em>, <em>Old project</em>. The <a href=\"#root/_help_MKmLg5x6xkor\">archived note</a> goes below all the others despite its high priority, and the rest are sorted by priority.</p><p><code>folders first</code> and <code>folders last</code> group the notes that have children of their own. A <code>folders</code> level without <code>first</code> or <code>last</code> also places them first, in either direction. <code>#sortFoldersFirst</code> is a shortcut for a <code>folders first</code> level; it has no effect when <code>#sorted</code> already contains <code>folders</code>.</p><h2>Pinning notes to the top or bottom</h2><p>A child note with <code>#top</code> stays at the top of a sorted parent, and one with <code>#bottom</code> stays at the bottom, whatever the levels of <code>#sorted</code> say. When several notes have <code>#top</code>, they are sorted by the label's value, so <code>#top=1</code> comes before <code>#top=2</code>, and a <code>#top</code> without a value comes first. <code>#bottom</code> works the other way round: the last notes are <code>#bottom=2</code>, then <code>#bottom=1</code>, then a <code>#bottom</code> without a value at the very end.</p><p><code>#sortFoldersFirst</code> places the folders right after the <code>#top</code> notes.</p><p>To pin notes within groups instead of the whole list, name <code>#top</code> and <code>#bottom</code> in <code>#sorted</code> at the position where they apply. For example:</p><ul><li><code>#sorted=\"#archived last, #top first, #bottom last, title\"</code> keeps archived notes below all the others, including those with <code>#bottom</code>. <code>#top</code> and <code>#bottom</code> then apply within the archived and the non-archived group separately.</li><li><code>#sorted=\"#archived last, #top first, #bottom last, folders first, title\"</code> also places folders first within each group. <code>#sortFoldersFirst</code> does the same: its <code>folders first</code> level goes right after the last of <code>#top</code> and <code>#bottom</code>.</li><li>Written with <code>first</code> or <code>last</code>, <code>#top</code> and <code>#bottom</code> ignore their values. To order several pinned notes by value, add a level after them, such as <code>#top first, #top, #bottom last, #bottom desc</code>.</li></ul><h2>How values are compared</h2><ul><li>Values are compared as text, character by character, without regard to letter case. Dates in the <code>YYYY-MM-DD</code> form sort correctly, but numbers don't: <code>\"10\"</code> comes before <code>\"2\"</code>. Either pad the numbers with zeros (<code>02</code>, <code>10</code>) or enable <code>#sortNatural</code>.</li><li>With <code>#sortNatural</code>, numbers are compared by their value, and the comparison follows the rules of the language set by <code>#sortLocale</code> (or the default one), which also ignores accents.</li><li>The title of a note includes its <a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a>, if it has one in this parent, as <code>prefix - title</code>.</li><li>A label without a value still counts as present: it sorts before the notes that don't have the label, and among the notes that have it, as the smallest value.</li></ul>",
"_help_NRnIZmSMc5sj": "<figure class=\"image\"><img style=\"aspect-ratio:2023/1488;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Printing%20%26%20Exporting%20as%20PDF_image.png\" width=\"2023\" height=\"1488\"><figcaption>Screenshot of the Print preview functionality introduced in v0.103.0.</figcaption></figure><p>Trilium allows printing notes to a real printer, or generating a structured PDF for a single note or for multiple notes through <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</p><p>Note that not all note types are printable as of now. We do plan to increase the coverage of supported note types in the future.</p><p>Printing and exporting as PDF are not perfect. Due to technical limitations, and sometimes even browser or Electron glitches the text might appear cut off in some circumstances. </p><h2>Printing a note or exporting as PDF on the desktop</h2><aside class=\"admonition note\"><p>Versions prior to v0.103.0 had two different options, one for printing and another one for exporting to PDF. With the introduction of the print preview, these functions have been unified.</p></aside><p>On the desktop application of Trilium it is possible to export a note as PDF. To print a note:</p><ul><li>Press the menu button in the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and select <em>Print/export to PDF…</em>.</li><li>Alternatively, printing can be triggered from a <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (unassigned by default) or through the <a href=\"#root/_help_F1r9QtzQLZqm\">command palette</a>.</li></ul><p>This will trigger the print preview screen next.</p><h3>Print preview & print options</h3><p>The print preview dialog allows the following printing options to be adjusted:</p><ul><li>The printer to use<ul><li><em>Save as PDF</em> generates a PDF that is structured (maintains a table of contents, keeps the text selectable). Prefer this over other virtual PDF printers that ship with the operating system.</li></ul></li><li>Page orientation: <em>Portrait</em> (default) or <em>Landscape</em>.</li><li>Page size</li><li>Scale the entire content from 10% to 200% to improve the fit within the page.</li><li>Margins, which can be removed completely or adjusted individually for all the four edges.</li><li>Print only a subset of pages. Individual page numbers are separated by colons and hyphen-based ranges are supported (e.g. 3-5 for pages 3 to 5).</li></ul><p>Additional interaction:</p><ul><li><em>Print using system dialog</em> allows setting more options that are otherwise not available in Trilium.</li></ul><p>If the note cannot be rendered with the current options, or stops making progress for 30 seconds, the preview is replaced by an error message. Adjust the options to try again.</p><aside class=\"admonition note\"><p>Most of the options here (except printer & which pages to print) are managed at note level through <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a> (such as <code>#printLandscape</code>, <code>#printPageSize</code>, <code>#printScale</code>, <code>#printMargins</code>).</p><p>This means that the print settings will be restored when printing the same note. There are no default settings that can be configured for all the notes, but this can be achieved via <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable attributes</a>.</p></aside><h2>Printing on the browser</h2><p>This feature allows printing of notes. It works on both the desktop client, but also on the web.</p><p>To print a note, click the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and select <em>Print/export to PDF…</em>. Depending on the size and type of the note, this can take up to a few seconds. Afterwards you will be redirected to the system/browser printing dialog.</p><p>On the server or PWA (mobile), the option is not available due to technical constraints and it will be hidden.</p><h2>Reporting issues with the rendering</h2><p>Should you encounter any visual issues in the resulting PDF file (e.g. a table does not fit properly, there is cut off text, etc.) feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report the issue</a>. In this case, it's best to offer a sample note (click on the <span class=\"tn-icon cke cke-three-vertical-dots\"></span> button, select <em>Export note</em> → <em>This note and all of its descendants</em> → <em>HTML in ZIP archive</em>). Make sure not to accidentally leak any personal information.</p><p>Consider adjusting font sizes and using <a href=\"#root/_help_CohkqWQC1iBv\">page breaks</a> to work around the layout.</p><aside class=\"admonition tip\"><p>Although direct export as PDF is not available in the browser version of the application, it's still possible to generate a PDF by selecting the <em>Print</em> option instead and selecting “Save to PDF” as the printer (depending on the browser). Generally, Mozilla Firefox has better printing capabilities.</p></aside><h3>Automatic opening of the file</h3><p>When the PDF is exported, it is automatically opened with the system default application for easy preview.</p><p>Note that if you are using Linux with the GNOME desktop environment, sometimes the default application might seem incorrect (such as opening in GIMP). This is because it uses Gnome's “Recommended applications” list.</p><p>To solve this, you can change the recommended application for PDFs via this command line. First, list the available applications via <code>gio mime application/pdf</code> and then set the desired one. For example to use GNOME's Evince:</p><pre><code class=\"language-text-x-trilium-auto\">gio mime application/pdf</code></pre><h2>Printing multiple notes</h2><p>Since v0.100.0, it is possible to print more than one note at the time by using <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>:</p><ol><li>First create a collection.</li><li>Configure it to use <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>.</li><li>Print the collection note normally.</li></ol><p>The resulting collection will contain all the children of the collection, while maintaining the hierarchy.</p><aside class=\"admonition note\"><p>Not all note types are supported when printing or exporting to PDF. When an unsupported note is encountered, it is skipped. At the end, if any of the notes were skipped, a message will be displayed with the possibility of viewing the full list of skipped notes. The same limitations as the ones described in <em>Constraints & limitations</em> apply.</p></aside><h2>Keyboard shortcut</h2><p>It's possible to trigger both printing and export as PDF from the keyboard by going to <em>Keyboard shortcuts</em> in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> and assigning a key combination for:</p><ul><li><em>Print Active Note</em></li><li><em>Export Active Note as PDF</em></li></ul><h2>Constraints & limitations</h2><p>Not all <a class=\"reference-link\" href=\"#root/_help_KSZ04uQ2D1St\">Note Types</a> are supported when printing, in which case the <em>Print</em> and <em>Export as PDF</em> options will be disabled.</p><ul><li>For <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, font, background and table colors are printed in the shades of light themes, whatever the current theme (see <a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>).</li><li><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes are printed with syntax highlighting, in the <em>Light theme</em> of <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Appearance</em>, whatever the current theme. The lines are numbered unless <em>Code Notes</em> → <em>Editor</em> → <em>Line numbers</em> is turned off.</li><li>A <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a> is printed as it is displayed, without running its script again, once its <code>~renderNote</code> relation is set.</li><li>For <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, the following are supported:<ul><li><a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>, allowing to print multiple notes at once while preserving hierarchy (similar to a book).</li><li><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a>, where each slide/sub-note is displayed.<ul><li>Most note types are supported, especially the ones that have an image representation such as <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> and <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, where the table is rendered in a print-friendly way.<ul><li>Tables that are too complex (especially if they have multiple columns) might not fit properly, however tables with a large number of rows are supported thanks to pagination.</li><li>Consider printing in landscape mode, or using <code>#printLandscape</code> if exporting to PDF.</li></ul></li><li>The rest of the collections are not supported, but we plan to add support for all the collection types at some point.</li></ul></li><li>A <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">saved search</a> prints its results as a list, in either the <em>Search preview</em> or the <em>List</em> view.</li><li>Using <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a> for printing is no longer supported, instead a custom <code>printCss</code> relation needs to be used (see below).</li></ul><h2>Customizing the print CSS</h2><p>As an advanced use case, it's possible to customize the CSS used for printing such as adjusting the fonts, sizes or margins. Note that <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a> will not work for printing.</p><p>To do so:</p><ul><li>Create a CSS <a href=\"#root/_help_6f9hih2hXXZk\">code note</a>.</li><li>On the note being printed, apply the <code>~printCss</code> relation to point to the newly created CSS code note.</li><li>To apply the CSS to multiple notes, consider using <a href=\"#root/_help_bwZpz2ajCEwO\">inheritable attributes</a> or <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>.</li></ul><p>For example, to change the font of the document from the one defined by the theme or the user to a serif one:</p><pre><code class=\"language-text-x-trilium-auto\">body {\n\t--print-font-family: serif;\n --print-font-size: 11pt;\n}</code></pre><aside class=\"admonition important\"><p>When altering <code>--print-font-family</code>, make sure the change is done at <code>body</code> level and not <code>:root</code>, since otherwise it won't be picked up due to specificity rules.</p></aside><p>To remark:</p><ul><li>Multiple CSS notes can be add by using multiple <code>~printCss</code> relations.</li><li>If the note pointing to the <code>printCss</code> doesn't have the right note type or mime type, it will be ignored.</li><li>If migrating from a previous version where <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>, there's no need for <code>@media print {</code> since the style-sheet is used only for printing.</li></ul><h2>Under the hood</h2><p>Both printing and exporting as PDF use the same mechanism: a note is rendered individually in a separate webpage that is then sent to the browser or the Electron application either for printing or exporting as PDF.</p><p>The webpage that renders a single note can actually be accessed in a web browser. For example <code>http://localhost:8080/#root/WWRGzqHUfRln/RRZsE9Al8AIZ?ntxId=0o4fzk</code> becomes <code>http://localhost:8080/?print#root/WWRGzqHUfRln/RRZsE9Al8AIZ</code>.</p><p>Accessing the print note in a web browser allows for easy debugging to understand why a particular note doesn't render well. The mechanism for rendering is similar to the one used in <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>.</p>",
"_help_CoFPLs3dRlXc": "<p>Some note types such as <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>, <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes and even some of the <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> can be set to read-only. When a note is in read-only mode, it is presented to the user in a non-editable view, with the option to switch to editing mode if needed.</p><h2>Automatic read-only mode</h2><p>For optimization purposes, Trilium will automatically set very large notes to read-only. Displaying such lengthy notes in editing mode can slow down performance, especially when editing is unnecessary.</p><p>This behavior can be disabled on a per-note basis, by following the instructions of the next section.</p><p>In addition, it's possible to change the number of characters at which the automatic read-only mode will trigger in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> by going to the options for <a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a> and <a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsCodeNotes\">Code Notes</a>.</p><h2>Changing a note's read-only behavior</h2><p>A note's read-only behavior can be changed via <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Editable.</em> The following options are possible:</p><ul><li><strong>Auto</strong><br>This is the default behavior in which the note will be editable by default, unless it becomes large enough to trigger read-only mode.</li><li><strong>Read-only</strong><br>The note will be always marked as read-only, regardless of its size. Nevertheless, it's still possible to temporarily edit the note if needed. This is generally useful for notes that are not prone to change.</li><li><strong>Always editable</strong><br>This option will bypass the automatic read-only activation for this particular note. It's useful for large notes that are frequently edited.</li></ul><p>If the <em>Editable</em> section is missing from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, then the note type does not support read-only mode.</p><h3>Manually setting the options</h3><p>Apart from using the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> as previously mentioned, it's also possible to use <a href=\"#root/_help_zEY4DaJG4YT5\">labels</a> to change the behavior:</p><ul><li>To set as read-only, apply the <code>readOnly</code> label to the note.</li><li>To disable automatic read-only (always editable), apply the <code>autoReadOnlyDisabled</code> label.</li></ul><h2>Temporarily editing a read-only note</h2><p>When accessing a read-only note, it's possible to temporarily edit it pressing the <em>Read-only</em> badge.</p><p>When pressed, the note will become editable but will become read-only again after navigating to a different note.</p><p>The pages of the built-in user guide are an exception: they are part of Trilium itself and cannot be edited, not even temporarily. Their <em>Read-only</em> badge cannot be pressed, the note menu does not offer to edit them, and their attributes are shown in the right sidebar without a way to change them.</p>",
"_help_0ESUbbAxVnoK": "<figure class=\"image\"><img style=\"aspect-ratio:990/590;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20List_image.png\" width=\"990\" height=\"590\"></figure><p>When a note has one or more child notes, they will be listed at the end of the note for easy navigation.</p><h2>Configuration</h2><ul><li>To hide the note list for a particular note, simply apply the <code>hideChildrenOverview</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li>For some view types, such as Grid view, only a subset of notes will be displayed and pagination can be used to navigate through all of them for performance reasons. To adjust the number of notes per page, set <code>pageSize</code> to the desired number.</li></ul><h2>View types</h2><p>The view types dictate how the child notes are represented. By default, the notes will be displayed in a grid, however there are also some other view types available.</p><p>Generally the view type can only be changed from the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, but it can also be changed manually on any type of note using the <code>#viewType</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>.</p><p>Saved searches use <em>Search preview</em> by default: it draws each result as a snippet card with the text and attributes that matched. It is limited to search notes and is described in <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p>",
"_help_S0Fos78ZfcY7": "<p>The inbox is the default destination for quickly captured notes. When a note is created without picking a location first, it lands in the inbox. This makes it easy to quickly capture notes and sort them later.</p><h2>Where the inbox is used</h2><ul><li>The <em>New note</em> button in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li><li>The global <em>Create note into inbox</em> shortcut (default <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).</li><li>The <em>New note</em> action in the <a href=\"#root/_help_7iwde4lsKc6O\">tray icon menu</a>.</li><li>The <a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a> extension.</li><li>The <em>Create note</em> option offered when a search finds no match, in <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to & command palette</a>, in an empty tab and in the <code>@</code> completion of a text note.</li></ul><h2>Setting a note inbox</h2><p>To create a note inbox, apply the <code>#inbox</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> to it.</p><p>Only one note should carry this label. If there are multiple notes, only one will be used by the application.</p><aside class=\"admonition note\"><p>If there is no inbox note, Trilium will fall back to today's <a href=\"#root/_help_l0tKav7yLHGF\">day note</a>, creating it and its calendar ancestors as needed. If the journal has been removed altogether, the note is created at the top level instead of a new journal being built for it.</p></aside><h2>Workspace inboxes</h2><p>Each <a href=\"#root/_help_9sRHySam5fXb\">workspace</a> can have its own inbox, set via the <code>#workspaceInbox</code> label.</p><p>When a new note is created while hoisted in a workspace, the location is determined in the following order:</p><ul><li>A note carrying the <code>#workspaceInbox</code> label in that workspace.</li><li>A note carrying the <code>#inbox</code> within that workspace.</li><li>Today's <a href=\"#root/_help_l0tKav7yLHGF\">day note</a>, if the workspace has a <code>#workspaceCalendarRoot</code>.</li><li>The workspace root note itself.</li></ul>",
"_help_5Ct4MAJTS4tQ": "<p>Deleted notes are listed in the <em>Deleted Notes</em> dialog (<a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> → <em>Deleted notes</em>) and can be restored by pressing the <em>undelete</em> link.</p><p>If a note has child notes, they will be restored along with it. Should the original location no longer exist (e.g. the parent has been deleted), the note will be restored into the default location for new notes (<a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>).</p><aside class=\"admonition note\"><p>When a note is hoisted in the tree, the dialog will only display notes deleted from the subtree of that hoisted note.</p></aside><p>To permanently erase deleted notes and clear the list, press the three-dots menu and select <em>Erase deleted notes now</em>.</p><p>Deleted notes are permanently erased after a certain amount of time (7 days by default). To change this interval, press the three-dots menu and select <em>Deleted Notes Settings</em>.</p>",
"_help_m3VlURMSeOrd": "<p>When an empty <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note is created, a note type switcher will appear below the inline <a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a>. Apart from changing the note type, it's also possible to apply a <a href=\"#root/_help_KC1HB96bqqHX\">template</a>:</p><ul><li><span class=\"tn-icon bx bxl-markdown\"></span> <em>Markdown</em> and <span class=\"tn-icon bx bx-pen\"></span> <em>Canvas</em> switch the note to that type in one click.</li><li><span class=\"tn-icon bx bx-code\"></span> <em>Code</em> lists the scripting notes (<em>Custom CSS</em>, <em>Widget</em> and <em>Backend script</em>), then the enabled code languages.</li><li><span class=\"tn-icon bx bx-book\"></span> <em>Collection</em> and <span class=\"tn-icon bx bx-copy-alt\"></span><em>Template</em> list the collections and the templates.</li><li><span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> <em>All types</em> displays the same menu as <em>Insert note after</em> in the <a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a>, with every note type and template.</li></ul><p>Typing while the <span class=\"tn-icon bx bx-code\"></span> <em>Code</em>, <span class=\"tn-icon bx bx-copy-alt\"></span> <em>Template</em> or <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> <em>All types</em> menu is open narrows it down to the matching entries.</p><p>The switcher will disappear as soon as a text is entered.</p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/New%20note%20type%20switcher_image.png\" width=\"735\" height=\"143\">",
"_help_B5dihXRDksTk": "<p>Note badges appear near the fixed note title and indicate important information about the note such as whether it is read-only. Some of the badges are also interactive.</p><figure class=\"image\"><img style=\"aspect-ratio:910/49;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Note%20badges_image.png\" width=\"910\" height=\"49\"></figure><p>The following badges are available:</p><ul><li><span class=\"tn-icon bx bx-lock-alt\"></span> <strong>Read-only badge</strong>, which will be shown if the note is not editable due to either automatic read-only or manual read-only. Clicking on the badge will temporarily edit the note. On the pages of the built-in user guide, which cannot be edited, the badge does nothing when clicked.</li><li><span class=\"tn-icon bx bx-share-alt\"></span> <strong>Share badge</strong>, which will indicate that the current note is shared. The badge will also indicate if the share is on the local network (for the desktop application without <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> set up) or publicly accessible (for the server).</li><li><span class=\"tn-icon bx bx-globe\"></span> <strong>Web clip badge</strong>, which will indicate if the note was clipped using the <a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a>. The badge acts as a link, so it can be clicked on to navigate to the page or right clicked for more options. When the clipper also saved the page's description, its author, or the dates it was published and last updated, clicking the badge shows these details instead, with a link to the page at the top.</li><li><span class=\"tn-icon bx bx-play\"></span> <strong>Execute badge</strong>, for <a href=\"#root/_help_CdNpE2pqjmI6\">scripts</a> or <a href=\"#root/_help_YKWqdJhzi2VY\">saved SQL queries</a> which have an execute button or a description.</li><li><span class=\"tn-icon bx bx-copy-alt\"></span> <strong>Template badge</strong>, for <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> (including workspace templates, for which the badge reads <em>Workspace template</em>). Notes created from a template inherit its attributes, so the badge is a reminder that changing them affects every such note. Clicking the badge switches the template between being offered everywhere and only while hoisted into its workspace, the latter only for a template inside a workspace (see <a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>). It also opens <em>Template properties...</em>, where the default title and location of new notes are set.</li><li>For <a class=\"reference-link\" href=\"#root/_help_YzMcWlCVeW09\">Active content</a> (e.g. scripts, styles), a dedicated badge will be shown indicating the type of note and with an option to easily enable or disable it.</li></ul>",
"_help_Bsm4fyzPJkSc": "<p><img class=\"image-style-align-right\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Notes/Save%20status%20indicator_image.png\" width=\"168\" height=\"47\">To the right of the note title, a temporary indicator appears after making a change to the document which shows whether the document has been saved.</p><p>It indicates the following states:</p><ul><li><span class=\"tn-icon bx bx-pencil\"></span> <em>Unsaved</em>, if the changes will be saved soon.</li><li><span class=\"tn-icon bx bx-loader\"></span> <em>Saving</em>, if the changes are being saved.</li><li><span class=\"tn-icon bx bx-check\"></span> <em>Saved</em>, if all the changes were successfully saved to the server.</li><li><span class=\"tn-icon bx bx-error\"></span> <em>Error</em>, if the changes could not be saved, for example due to a communication server with the server.</li></ul><p>In a text note, the changes are saved once typing pauses for a second, and at least every ten seconds while typing continues.</p><p>After all changes have been saved, the indicator will hide automatically after a few seconds.</p>",
"_help_kBrnXNG3Hplm": "<p>This page explains the basic concepts related to the tree structure of notes in TriliumNext.</p><h2>Note</h2><p>A note is the central entity in TriliumNext. For more details, see <a class=\"reference-link\" href=\"#root/_help_BFs8mudNFgCS\">Notes</a>.</p><h2>Branch</h2><p>A branch describes the placement of a note within the note tree. Essentially, it is a tuple of <code>parentNoteId</code> and <code>noteId</code>, indicating that the given note is placed as a child under the specified parent note.</p><p>Each note can have multiple branches, meaning any note can be placed in multiple locations within the tree. This concept is referred to as <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a>.</p><h2>Prefix</h2><p>A prefix is a branch-specific title modifier for a note. If you place your note in two different locations within the tree and want to alter the title slightly in one of those placements, you can use a prefix.</p><p>To edit a prefix, right-click on the note in the tree pane and select <em>Edit branch prefix</em>.</p><p>The prefix is not part of the note itself and is not encrypted when the note is protected. This can be useful if you want part of the title to remain visible in the tree for easier navigation, even when the note is protected.</p><h2>Subtree</h2><p>A subtree consists of a particular note (the subtree root) and all its children and descendants. Some operations, such as exporting, work on entire subtrees.</p>",
"_help_MMiBEQljMQh2": "<p>One of the Trilium's goals is to provide fast and comfortable navigation between notes.</p><h2>Backwards and forward</h2><p>To move back and forward in the history of viewed notes, press <kbd>Alt</kbd>+<kbd>←</kbd> and <kbd>Alt</kbd>+<kbd>→</kbd>, or use the <span class=\"tn-icon bx bx-left-arrow-alt\"></span> and <span class=\"tn-icon bx bx-right-arrow-alt\"></span> buttons to the left of the <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a>.</p><p>This works identically to browser backwards / forwards, it's actually using built-in browser support for this.</p><p>To go several notes back or forward at once, right-click one of the buttons or press and hold it. The back button lists the notes before the current one and the forward button the notes after it, the nearest first. Each entry shows the note's title, with the path of its parent notes at the end of the row. Selecting a note goes straight to it.</p><p>The <em>Go to Previous Note</em> and <em>Go to Next Note</em> launchers of the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> list the same notes, below the launch bar's own items.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Note%20Navigation_image.jpg\"></p><h2>Jump to note</h2><p>This is useful to quickly find and view arbitrary notes - click on <code>Jump to</code> button on the top or press <kbd>Ctrl</kbd> + <kbd>J</kbd> . Then type part of the note name and autocomplete will help you pick the desired note.</p><p>See <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to Note</a> for more information.</p>",
"_help_Ms1nauBra7gq": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:659/256;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Quick%20search_image.png\" width=\"659\" height=\"256\"></figure><p>The <em>Quick search</em> function does a full-text search (that is, it searches through the content of notes and not just the title of a note) and displays the result in an easy-to-access manner.</p><p>The alternative to the quick search is the <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> function, which opens in a dedicated tab and has support for advanced queries.</p><p>For even faster navigation, it's possible to use <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to & command palette</a> which will only search through the note titles instead of the content.</p><h2>Layout</h2><p>Based on the <a class=\"reference-link\" href=\"#root/_help_x0JgW8UqGXvq\">Vertical and horizontal layout</a>, the quick search is placed:</p><ul><li>On the vertical layout, it is displayed right above the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>On the horizontal layout, it is displayed in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, where it can be positioned just like any other icon.</li></ul><h2>Search Features</h2><p>Quick search includes the following features:</p><h3>Content Previews</h3><p>Search results now display a 200-character preview of the note content below the note title. This preview shows the context where your search terms appear, making it easier to identify the right note without opening it.</p><h3>All results in one list</h3><p>Quick search lists up to 200 matching notes in a single scrollable list, so the scrollbar shows how many results there are and how far through them you are.</p><h3>Continuing in the full search</h3><p>To refine a query with the options of the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, click <em>Show in full search</em> below the results, or press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> in the search field. The full search opens in a new tab with the same query. The button stays below the list, however far the results are scrolled.</p><h3>Visual Features</h3><ul><li><strong>Highlighting</strong>: Search terms appear in bold with accent colors</li><li><strong>Separation</strong>: Results are separated with dividers</li><li><strong>Theme Support</strong>: Highlighting colors adapt to light/dark themes</li></ul><h3>Search Behavior</h3><p>Quick search uses progressive search:</p><ol><li>Shows exact matches first</li><li>Includes fuzzy matches when exact results are fewer than 5</li><li>Exact matches appear before fuzzy matches</li></ol><h3>Search Scope</h3><p>Quick search covers only the subtree you are currently working in:</p><ul><li>Without hoisting, it covers the whole note tree.</li><li>Under a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or inside a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>, it covers only that subtree.</li><li>Notes that exist only in the hidden tree, such as the built-in help pages and the launch bar configuration, are not returned. Hoist into the help to search it, or use <a href=\"#root/_help_F1r9QtzQLZqm\">Jump to…</a>, which searches titles across the hidden tree.</li></ul><p>To search the whole database while hoisted, use the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> and leave <em>Ancestor</em> field empty.</p><h3>Keyboard Navigation</h3><ul><li>Press <kbd>Enter</kbd> in the search field to search, or to refresh the results already shown.</li><li>Press <kbd>Down</kbd> in the search field to move to the first result, then <kbd>Up</kbd> and <kbd>Down</kbd> to move between results. <kbd>Up</kbd> on the first result returns to the search field.</li><li>Press <kbd>Page Down</kbd> and <kbd>Page Up</kbd> to move through the results a page at a time.</li><li>Press <kbd>Enter</kbd> on a result to open it.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to open the query in the full search.</li><li>Press <kbd>Escape</kbd> to close the results.</li></ul><p>To see these shortcuts on screen, click the <kbd>?</kbd> button below the results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field is focused.</p><h2>Using Quick Search</h2><ol><li><strong>Typo tolerance</strong>: Search finds results despite minor typos</li><li><strong>Content previews</strong>: 200-character snippets show match context</li><li><strong>Specific terms</strong>: Specific search terms return more focused results</li><li><strong>Match locations</strong>: Bold text indicates where matches occur</li></ol><h2>Quick Search - Exact Match Operator</h2><p>Quick Search shares the same search engine as the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, so the exact match operator (<code>=</code>) behaves identically in both. Start your query with <code>=</code> (no space after it) to switch from the default \"contains\" behavior to exact whole-word or phrase matching.</p><p><strong>What</strong> <code>**=**</code> <strong>actually does:</strong> it finds notes where the title or content contains your term as a <strong>whole word or phrase</strong>, ignoring surrounding punctuation. It does <strong>not</strong> require the whole note to equal your term, and it does <strong>not</strong> do substring or fuzzy matching.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>synchronize the database now</code></td><td>Yes</td><td>default search matches the substring</td></tr><tr><td><code>=sync</code></td><td><code>see (sync) mode</code></td><td>Yes</td><td><code>=</code> matches the whole word <code>sync</code>, punctuation ignored</td></tr><tr><td><code>=sync</code></td><td><code>synchronize the database now</code></td><td>No</td><td><code>=</code> never matches substrings</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the (project plan) is ready to share</code></td><td>Yes</td><td>quote a multi-word phrase to match it exactly</td></tr></tbody></table></figure><p>The search is case- and diacritic-insensitive. For the complete explanation of the three matching modes, fuzzy operators and relevance ranking, see <a href=\"#root/_help_eIg8jdvaoNNd\">How search matches your text</a> in the full Search documentation.</p><h3>Limitations</h3><ul><li>The <code>=</code> operator must be at the very beginning of the search query.</li><li>A space immediately after <code>=</code> is treated as a regular search.</li><li>Multiple <code>=</code> operators (like <code>==example</code>) are treated as regular text search.</li></ul><h3>Related Features</h3><ul><li>For attribute, property, boolean and ordering queries, use the full <a href=\"#root/_help_eIg8jdvaoNNd\">Search</a> functionality.</li><li>For fuzzy matching (finding results despite typos), use the <code>~=</code> or <code>~*</code> operators in the full search.</li><li>For partial matches with wildcards, use operators like <code>*=*</code>, <code>=*</code>, or <code>*=</code> in the full search.</li></ul>",
"_help_F1r9QtzQLZqm": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:991/403;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/1_Jump%20to%20%26%20command%20palette_image.png\" width=\"991\" height=\"403\"></figure><h2>Jump to Note</h2><p>The <em>Jump to Note</em> function allows easy navigation between notes by searching for their title. In addition to that, it can also trigger a full search or create notes.</p><p>To enter the “Jump to” dialog:</p><ul><li>In the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, press <span class=\"tn-icon bx bx-send\"></span> button.</li><li>Using the keyboard, press <kbd>Ctrl</kbd> + <kbd>J</kbd>.</li></ul><p>In addition to searching for notes, it is also possible to search for commands. See the dedicated section below for more information.</p><h3>Interaction</h3><ul><li>By default, when there is no text entered it will display the most recent notes.</li><li>Using the keyboard, use the up or down arrow keys to navigate between items. Press <kbd>Enter</kbd> to open the desired note.</li><li>If the note doesn't exist, it's possible to create it by typing the desired note title and selecting one of two options:<ul><li><em>Create note</em> places it in the <a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a>: the note labelled <code>#inbox</code>, today's <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a> if there is none, or the top level if there is no journal either. While hoisted into a <a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>, the workspace's own inbox is used, then today's day note if the workspace has a <code>#workspaceCalendarRoot</code>, otherwise the workspace root itself. The option names the destination, so it is always visible before the note is created.</li><li><em>Create child note</em> places it under the note that is currently open.</li></ul></li><li>When the title search does not find a note, the bar below the results offers two ways to search further. It stays below the list, however far the results are scrolled. Both are hidden while the field is empty or lists commands.<ul><li>The <em>Include note contents</em> switch searches the content of the notes as well as their titles, and lists what it finds in place of the current results, without leaving the dialog. It stays on while the query changes, until it is switched off. Press <kbd>Shift</kbd>+<kbd>Enter</kbd> to switch it from the keyboard.</li><li><em>Show in full search</em> opens the query in the full <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>, in a new tab, where its options can refine it. Press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to run it from the keyboard.</li></ul></li><li>To see the keys the results answer to, click the <kbd>?</kbd> button below the results, or press <kbd>Alt</kbd>+<kbd>F1</kbd> while the search field is focused.</li><li>On a wide enough desktop window, the note highlighted in the results is previewed on their right: its path, title, attributes and the start of its content. The preview follows the highlight as it moves through the results, and is left out for the command palette.</li><li>The options to create a note are listed after the notes. When no note matches, the list says so above them. <kbd>Enter</kbd> opens the note that matches best, or creates the note when none matches. Otherwise, press <kbd>↑</kbd> from the first note to reach the options to create a note.</li></ul><h2>Recent notes</h2><p>Jump to note also has the ability to show the list of recently viewed / edited notes and quickly jump to it.</p><p>To access this functionality, click on <code>Jump to</code> button on the top. By default, (when nothing is entered into autocomplete), this dialog will show the list of recent notes.</p><p>The recent notes are grouped by when they were last visited: <em>Today</em>, <em>Yesterday</em>, <em>Past 7 days</em>, <em>Past 30 days</em> and <em>Older</em>. The same list, with the same groups, opens in any note field that is focused while empty.</p><h2>Command Palette</h2><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:982/524;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Jump%20to%20%26%20command%20palette_image.png\" width=\"982\" height=\"524\"></figure><p>The command palette is a feature which allows easy execution of various commands that can be found throughout the application, such as from menus or keyboard shortcuts. This feature integrates directly into the “Jump to” dialog.</p><h3>Interaction</h3><p>To trigger the command palette:</p><ul><li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>J</kbd> to display the command palette directly.</li><li>If in the “Jump to” dialog, type <code>></code> in the search to switch to the command palette.</li></ul><p>Interaction:</p><ul><li>Type a few words to filter between commands.</li><li>Use the up and down arrows on the keyboard or the mouse to select a command.</li><li>Press <kbd>Enter</kbd> to execute the command.</li></ul><p>To exit the command palette:</p><ul><li>Remove the <code>></code> in the search to go back to the note search.</li><li>Press <kbd>Esc</kbd> to dismiss the dialog entirely.</li></ul><h3>Options available</h3><p>Currently the following options are displayed:</p><ul><li>Most of the <a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a> have an entry, with the exception of those that are too specific to be run from a dialog.</li><li>Some additional options which are not yet available as keyboard shortcuts, but can be accessed from various menus such as: exporting a note, showing attachments, searching for notes or configuring the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>.</li></ul><h3>Limitations</h3><p>Currently it's not possible to define custom actions that are displayed in the command palette. In the future this might change by integrating the options in the launch bar, which can be customized if needed.</p>",
"_help_eIg8jdvaoNNd": "<figure class=\"image\"><img style=\"aspect-ratio:987/725;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Search_image.png\" width=\"987\" height=\"725\"></figure><p>Note search enables you to find notes by searching for text in the title, content, or <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> of the notes. You also have the option to save your searches, which will create a special search note which is visible on your navigation tree and contains the search results as sub-items.</p><h2>Types of search</h2><p>There are multiple types of searches, all using the same search mechanism and query language:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> which can be found in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> for small one-off searches.<ul><li>The results are shown in a popup and it has an infinite scroll.</li></ul></li><li><em>Full search</em> is the more advanced search mechanism.<ul><li>The results are displayed in a separate page and it has multiple advanced features (search script, fast search, include archived notes, order by, limit).</li><li><a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a> such as adding a label/relation can be applied to the results.</li><li>The results are paginated and they can be displayed in any <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> view (e.g. grid, list, calendar, table).</li></ul></li><li>Some <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> such as board view have a dedicated search bar which applies to that collection.<ul><li>In this case, the results are displayed directly in the collection instead of a popup and they are limited to the collection but the query language remains the same.</li></ul></li></ul><aside class=\"admonition note\"><p><a href=\"#root/_help_F1r9QtzQLZqm\">Jump to note</a> is a similar concept but it's mainly used to search for notes by title, not by content. Nevertheless, it also features a way to search in full text if the results are unsatisfactory.</p></aside><h2>Accessing the search</h2><ul><li>From the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a>, look for the dedicated <span class=\"tn-icon bx bx-search\"></span> search button.</li><li>To limit the search to a note and its children, select <em>Search in subtree</em> (<span class=\"tn-icon bx bx-search\"></span>) from the <a class=\"reference-link\" href=\"#root/_help_YtSN43OrfzaA\">Note tree contextual menu</a> or press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>S</kbd>.</li><li>Go to <a class=\"reference-link\" href=\"#root/_help_F1r9QtzQLZqm\">Jump to & command palette</a>, look for something then press <em>Show in full search</em> below the results (or <kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><h2>Interaction</h2><p>To search for notes, click on the <span class=\"tn-icon bx bx-search\"></span> icon in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> or press the keyboard <a href=\"#root/_help_A9Oc6YKKc65v\">shortcut</a>.</p><ol><li>Set the text to search for in the <em>Search string</em> field.<ol><li>Apart from searching for words literally, there is also the possibility to search for attributes or properties of notes.</li><li>See the examples below for more information.</li></ol></li><li>To limit the search to a note and its sub-children, set a note in <em>Ancestor</em>.<ol><li>This value is also pre-filled if the search is triggered from a <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> or a <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li><li>To search the entire database, keep the value empty.</li></ol></li><li>To limit the search to only a few levels of hierarchy (e.g. look in sub-children but not in sub-sub-children of a note), set the <em>depth</em> field to one of the provided values.</li><li>In addition to that, the search can be configured via the <em>Add search option</em> menu, as described in the follow-up section.</li><li>Press <em>Search</em> (<span class=\"tn-icon bx bx-search\"></span>) to trigger the search. The results are displayed below the search configuration pane.</li><li>The <em>Search & Execute actions</em> (<span class=\"tn-icon bx bxs-zap\"></span>) entry in the menu beside <em>Search</em> is only relevant if at least one action has been added (as described in the section below).</li><li>The <em>Save to note</em> (<span class=\"tn-icon bx bx-save\"></span>) entry in the same menu will create a new note with the search configuration. For more information, see <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</li></ol><h2>Features</h2><h3>Autocomplete</h3><p>To help with the syntax, Trilium offers an autocomplete functionality which can be triggered by pressing <kbd>Ctrl</kbd>+<kbd>Space</kbd>.</p><p>Some suggestions also open on their own as you type: label and relation names after <code>#</code> and <code>~</code>, fields after <code>.</code>, operators, values, and notes after <code>@</code>. Keywords such as <code>and</code>, <code>or</code>, <code>not</code>, <code>orderBy</code> and <code>limit</code> appear only on <kbd>Ctrl</kbd>+<kbd>Space</kbd>, since a plain word is usually a search term.</p><p>No suggestion is selected when a list opens on its own, so <kbd>Enter</kbd> runs the search as typed. To insert a suggestion, select it with <kbd>Down</kbd> and press <kbd>Enter</kbd>. The list opened with <kbd>Ctrl</kbd>+<kbd>Space</kbd> and the notes after <code>@</code> open on the best match instead, so <kbd>Enter</kbd> inserts it.</p><p>The autocomplete offers:</p><ul><li>Basic operators such as <code>*=</code> and keywords (<code>limit</code>, <code>not</code>).</li><li>Fields for object-like fields such as <code>note</code> or <code>~relation</code>, triggered by typing <code>.</code>.</li><li>Contextual enumerations such as <code>note.type = \"</code> or <code>note.mime = \"</code>.</li><li><a href=\"#root/_help_HI6GBBIduIgv\">Label</a> names by typing <code>#</code>.<ul><li>A small gear on the name's icon indicates a system attribute.</li><li>After typing the label name, the value is also autocompleted with values that are present in the database.</li></ul></li><li><a href=\"#root/_help_Cq5X6iKQop6R\">Relation</a> names by typing <code>~</code>.</li><li><a href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>s can be inserted easily by typing <code>@</code> and looking for a note.<ul><li>If the note ID is under a valid syntax, it will be shown as a chip of the note instead of the raw ID.</li><li>This is especially useful for queries that make use of the note ID such as searching by template: <code>~template.noteId = @</code></li></ul></li></ul><h3>Syntax highlighting</h3><p>The search input features syntax highlighting, making recognized fields such as <code>note.</code> and operators like <code>NOT</code> stand out.</p><p>The same highlighting is available in <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, for example to keep a collection of queries: set the language of the note to <em>Trilium Search Query</em>. The language is not enabled by default; add it from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Available MIME types in the dropdown</em>.</p><h3>Error highlighting & linting</h3><p>The search is also checked for errors in two phases, which will be displayed as a red squiggle:</p><ul><li>Linter errors which identify common error patterns and also provide a way to fix them.</li><li>Search errors which are checked by the server, without indicating the exact place the error occurred.</li></ul><p>An error the search only runs into while running, such as an operator that note content cannot be searched with, is shown in a <em>Search error</em> card instead: below the search string, or at the top of the <a class=\"reference-link\" href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> results.</p><h3>Multiline</h3><p>Long or complicated searches can be formatted by using newlines, similar to SQL queries. Newlines are treated just like spaces.</p><p>To add a new line, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</p><aside class=\"admonition note\"><p>Multiline is available only for the full search, other inputs such as the quick search or the collection filter are single line.</p></aside><h2>Search options</h2><p>Click <em>Add search option</em> to choose an option to apply.</p><ul><li>For each search option selected, the search configuration will update to reveal the entry. Each search option will have its own configuration.</li><li>To remove a search option, simply press the <span class=\"tn-icon bx bx-x\"></span> button to the right of it.</li></ul><p>The options available are:</p><ol><li><span class=\"tn-icon bx bx-code\"></span> Search script<ol><li>This feature allows writing a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note that will handle the search on its own.</li></ol></li><li><span class=\"tn-icon bx bx-run\"></span> Fast search<ol><li>The search will not look into the content of the notes, but it will still look into note titles and attributes, relations (based on the search query).</li><li>This method can speed up the search considerably for large <a href=\"#root/_help_wX4HbRucYSDD\">databases</a>.</li></ol></li><li><span class=\"tn-icon bx bx-archive\"></span> Include archived<ol><li><a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a> will also be included in the results, whereas otherwise they would be ignored.</li></ol></li><li><span class=\"tn-icon bx bx-arrow-from-top\"></span> Order by<ol><li>Allows changing the criteria for ordering the results, for example to order by creation date or alphabetically instead of by relevancy (default).</li><li>It's also possible to change the order (ascending or descending) of the results.</li></ol></li><li><span class=\"tn-icon bx bx-stop\"></span> Limit<ol><li>Limits the results to a given maximum.</li><li>This can help if the number of results would otherwise be high, at the cost of not being able to view all the results.</li></ol></li><li><span class=\"tn-icon bx bx-bug\"></span> Debug<ol><li>This will print additional information in the server log (see <a class=\"reference-link\" href=\"#root/_help_qzNzp9LYQyPT\">Error logs</a>), regarding how the search expression was parsed.</li><li>This function is especially useful after understanding the search functionality in detail, in order to determine why a complex search query is not working as expected.</li></ol></li></ol><p>The same menu ends with a <em>Bulk actions</em> section for applying changes such as adding a label or a relation to the matched notes. Its groups—<em>Labels</em>, <em>Relations</em>, <em>Notes</em> and <em>Other</em>—each open a list of the actions in the corresponding group of the <a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a> dialog, which is an alternative for operating directly with notes within the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. Choosing one adds it to the search; unlike the other options, the same action can be added more than once (e.g. to apply multiple labels). After defining the actions, first press <em>Search</em> to check the matched notes and then choose <em>Search & Execute actions</em> from the menu beside it to trigger the actions.</p><h2>Viewing search results</h2><p>Results appear below the search pane, by default in the <em>Search preview</em> view. Each result is drawn as a <strong>snippet card</strong> with the note title, the path to it, a short excerpt of the matching text, and the attributes that matched. The excerpt of a code note keeps its indentation and is shown in the code font.</p><p>To show the results as a plain note list instead, choose <em>List</em> from the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> bar. The <em>List</em> view shows one row per note, with the note's title and content preview.</p><p>The search will also highlight the words from the title or content that matched:</p><ul><li>With a solid underlined green for a direct match;</li><li>With a dotted underline orange for a partial match (matched by the fuzzy search).</li></ul><p>In addition, the <em>Search preview</em> view offers:</p><ul><li>The <strong>total number of results</strong> is always shown, so you can immediately tell how broad a query is.</li><li>A <strong>page-size selector</strong> lets you choose how many results to display per page. Your choice is remembered and synced across your devices (stored in the <code>searchResultsPageSize</code> option), so you do not have to reset it on every device.</li><li><strong>Clicking a result's title</strong> opens the note and jumps straight to the first match. The in-note find bar opens pre-filled with the first word of your search, so you can step through its matches with the find controls. To have the find bar look for a whole phrase instead, put the phrase in quotes in the search, e.g. <code>\"The Lord of the Rings\"</code>. In read-only notes, the other words of the search are highlighted as well. The excerpt and attributes can be selected without opening the note.</li><li><em>Open all results in new tabs</em> (<span class=\"tn-icon bx bx-window-open\"></span>, the button above the results) opens every result in a tab of its own, up to 50. Each tab opens on its first match with the find bar pre-filled, as when clicking a result.</li><li>If a match is inside a <strong>collapsed section</strong> (for example a folded heading), that section is expanded automatically so the match is visible.</li><li>When the excerpt is cut short, a <em>Show more</em> button expands the card to the note's full content, with the search terms highlighted. <em>Show less</em> returns to the excerpt.</li></ul><p>A saved search can also be <a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">printed or exported as PDF</a> from the <em>Print/export to PDF…</em> item of the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, in either <em>Search preview</em> or <em>List</em> view. The results are laid out as a list, as they stand when printing starts.</p><h2>Simple Note Search Examples</h2><ul><li><code>rings tolkien</code>: Full-text search to find notes containing both \"rings\" and \"tolkien\".</li><li><code>\"The Lord of the Rings\" Tolkien</code>: Full-text search where \"The Lord of the Rings\" must match exactly.</li><li><code>note.content *=* rings OR note.content *=* tolkien</code>: Find notes containing \"rings\" or \"tolkien\" in their content.</li><li><code>towers #book</code>: Combine full-text and attribute search to find notes containing \"towers\" and having the \"book\" label. Writing <code>towers AND #book</code> does the same; to search for the word \"and\" itself, put it in quotes.</li><li><code>c#</code> or <code>towers#book</code>: A <code>#</code> or <code>~</code> inside a word is part of the text, so these find notes containing \"c#\" or \"towers#book\". To start a label or relation, put a space before it.</li><li><code>towers #book or #author</code>: Search for notes containing \"towers\" and having either the \"book\" or \"author\" label.</li><li><code>towers #!book</code>: Search for notes containing \"towers\" and not having the \"book\" label.</li><li><code>#book #publicationYear = 1954</code>: Find notes with the \"book\" label and \"publicationYear\" set to 1954.</li><li><code>#genre *=* fan</code>: Find notes with the \"genre\" label containing the substring \"fan\". Additional operators include <code>*=*</code> for \"contains\", <code>=*</code> for \"starts with\", <code>*=</code> for \"ends with\", and <code>!=</code> for \"is not equal to\".</li><li><code>#book #publicationYear >= 1950 #publicationYear < 1960</code>: Use numeric operators to find all books published in the 1950s.</li><li><code>#dateNote >= TODAY-30</code>: Find notes with the \"dateNote\" label within the last 30 days. Supported date values include NOW +- seconds, TODAY +- days, MONTH +- months, YEAR +- years.</li><li><code>~author.title *=* Tolkien</code>: Find notes related to an author whose title contains \"Tolkien\".</li><li><code>#publicationYear %= '19[0-9]{2}'</code>: Use the '%=' operator to match a regular expression (regex). This feature has been available since Trilium 0.52.</li><li><code>note.content %= '\\\\d{2}:\\\\d{2} (PM|AM)'</code>: Find notes that mention a time. Backslashes in a regex must be escaped.</li></ul><h2>Advanced Use Cases</h2><ul><li><code>~author.relations.son.title = 'Christopher Tolkien'</code>: Search for notes with an \"author\" relation to a note that has a \"son\" relation to \"Christopher Tolkien\". This can be modeled with the following note structure:<ul><li>Books<ul><li>Lord of the Rings<ul><li>label: “book”</li><li>relation: “author” points to “J. R. R. Tolkien” note</li></ul></li></ul></li><li>People<ul><li>J. R. R. Tolkien<ul><li>relation: “son” points to \"Christopher Tolkien\" note</li><li>Christopher Tolkien</li></ul></li></ul></li></ul></li><li><code>~author.title *= Tolkien OR (#publicationDate >= 1954 AND #publicationDate <= 1960)</code>: Use boolean expressions and parentheses to group expressions.</li><li><code>towers (#genre = fantasy OR #genre = scifi)</code>: A group can open the expression part directly, without a <code>#</code> or <code>~</code> before the parenthesis. Here it finds notes containing \"towers\" whose genre is fantasy or scifi.</li><li><code>note.parents.title = 'Books'</code>: Find notes with a parent named \"Books\".</li><li><code>note.parents.parents.title = 'Books'</code>: Find notes with a grandparent named \"Books\".</li><li><code>note.ancestors.title = 'Books'</code>: Find notes with an ancestor named \"Books\".</li><li><code>note.children.title = 'sub-note'</code>: Find notes with a child named \"sub-note\".</li><li><code>note.links.title = 'Tolkien'</code>: Find notes linking to a note named \"Tolkien\".</li><li><code>note.backlinks.title = 'Reading list'</code>: Find the notes that \"Reading list\" links to.</li><li>A link is a relation you created, such as <code>~author</code>, or one that content creates: an internal link (<code>~internalLink</code>), an image (<code>~imageLink</code>), an included note (<code>~includeNoteLink</code>) or a relation map connection (<code>~relationMapLink</code>). Relations that configure a note, such as <code>~template</code> or a saved search's <code>~ancestor</code>, are not links.</li></ul><p>See also <a class=\"reference-link\" href=\"#root/_help_Oxyb6jOjjVNL\">Under the hood</a> for more syntax references.</p><h3>Search with Note Properties</h3><p>Notes have properties that can be used in searches, such as <code>noteId</code>, <code>dateModified</code>, <code>dateCreated</code>, <code>isProtected</code>, <code>type</code>, <code>title</code>, <code>text</code>, <code>content</code>, <code>rawContent</code>, <code>ownedLabelCount</code>, <code>labelCount</code>, <code>ownedRelationCount</code>, <code>relationCount</code>, <code>ownedRelationCountIncludingLinks</code>, <code>relationCountIncludingLinks</code>, <code>ownedAttributeCount</code>, <code>attributeCount</code>, <code>targetRelationCount</code>, <code>targetRelationCountIncludingLinks</code>, <code>parentCount</code>, <code>childrenCount</code>, <code>isArchived</code>, <code>contentSize</code>, <code>noteSize</code>, and <code>revisionCount</code>.</p><p>These properties can be accessed via the <code>note.</code> prefix, e.g., <code>note.type = code AND note.mime = 'application/json'</code>.</p><h3>Order by and Limit</h3><pre><code class=\"language-text-x-trilium-auto\">#author=Tolkien orderBy #publicationDate desc, note.title limit 10</code></pre><p>This example will:</p><ol><li>Find notes with the author label \"Tolkien\".</li><li>Order the results by <code>publicationDate</code> in descending order.</li><li>Use <code>note.title</code> as a secondary ordering if publication dates are equal.</li><li>Limit the results to the first 10 notes.</li></ol><h3>Negation</h3><p>Some queries can only be expressed with negation:</p><pre><code class=\"language-text-x-trilium-auto\">#book AND not(note.ancestors.title = 'Tolkien')</code></pre><p>This query finds all book notes not in the \"Tolkien\" subtree.</p><h2>Under the Hood</h2><p>See the <a href=\"#root/_help_Oxyb6jOjjVNL\">dedicated page</a> to understand how progressive search works in Trilium, as well as some advanced use cases.</p><h2>Auto-Trigger Search from URL</h2><p>You can open Trilium and automatically trigger a search by including the search <a href=\"https://meyerweb.com/eric/tools/dencoder/\">url encoded</a> string in the URL:</p><p><code>http://localhost:8080/#?searchString=abc</code></p><h2>Search Configuration</h2><h3>Parameters</h3><figure class=\"table\"><table><thead><tr><th>Parameter</th><th>Value</th><th>Description</th></tr></thead><tbody><tr><td><code>MIN_FUZZY_TOKEN_LENGTH</code></td><td>3</td><td>Minimum characters the <code>~=</code> and <code>~*</code> operators accept</td></tr><tr><td><code>MAX_EDIT_DISTANCE</code></td><td>2</td><td>Ceiling on character changes, reached only by 7+ character terms; shorter terms allow fewer. See the <em>Fuzzy tolerance</em> section above</td></tr><tr><td><code>RESULT_SUFFICIENCY_THRESHOLD</code></td><td>5</td><td>Minimum exact results before fuzzy fallback</td></tr><tr><td><code>MAX_CONTENT_SIZE</code></td><td>10MB</td><td>Maximum note content size for search processing</td></tr></tbody></table></figure><h3>Limits</h3><ul><li>Searched note content is limited to 10MB per note to prevent performance issues</li><li>Notes exceeding this limit will still be included in title and attribute searches</li><li>Terms of 3 characters or fewer are matched exactly; typo tolerance starts at 4 characters</li></ul>",
"_help_Oxyb6jOjjVNL": "<h2>Progressive Search Strategy</h2><p>Trilium uses a progressive search strategy that performs exact matching first, then adds fuzzy matching when needed.</p><p>The search has three phases:</p><ol><li><strong>Phase 1 - Exact Matching</strong>: When you search, Trilium first looks for exact matches of your search terms. This handles the vast majority of searches (90%+) and returns results almost instantly.</li><li><strong>Phase 2 - Fuzzy Fallback</strong>: If Phase 1 doesn't find enough high-quality results (fewer than 5 results with good relevance scores), Trilium automatically adds fuzzy matching to find results with typos or spelling variations.</li><li><strong>Result Ordering</strong>: Exact matches always appear before fuzzy matches, regardless of individual scores. This ensures that when you search for \"project\", notes containing the exact word \"project\" will appear before notes containing similar words like \"projects\" or \"projection\".</li></ol><h3>Progressive Search Behavior</h3><ul><li><strong>Speed</strong>: Most searches complete using only exact matching</li><li><strong>Ordering</strong>: Exact matches appear before fuzzy matches</li><li><strong>Fallback</strong>: Fuzzy matching activates when exact matches return fewer than 5 results</li><li><strong>Identification</strong>: Results indicate whether they are exact or fuzzy matches</li></ul><h2>Search Performance</h2><p>Search system specifications:</p><ul><li>Content size limit: 10MB per note (previously 50KB)</li><li>Edit distance calculations for fuzzy matching</li><li>Infinite scrolling in Quick Search</li></ul><h2>Label and Relation Shortcuts</h2><p>The \"full\" syntax for searching by labels is:</p><pre><code class=\"language-text-x-trilium-auto\">note.labels.publicationYear = 1954</code></pre><p>For relations:</p><pre><code class=\"language-text-x-trilium-auto\">note.relations.author.title *=* Tolkien</code></pre><p>However, common label and relation searches have shortcut syntax:</p><pre><code class=\"language-text-x-trilium-auto\">#publicationYear = 1954\n~author.title *=* Tolkien</code></pre><h2>Separating Full-Text and Attribute Parts</h2><p>Search syntax allows combining full-text search with attribute-based search. For example, <code>tolkien #book</code> contains:</p><ol><li>Full-text tokens - <code>tolkien</code></li><li>Attribute expressions - <code>#book</code></li></ol><p>Trilium detects the separation between full text search and attribute/property search by looking for certain special characters or words that denote attributes and properties (e.g., #, ~, note.). If you need to include these in full-text search, escape them with a backslash so they are processed as regular text:</p><pre><code class=\"language-text-x-trilium-auto\">\"note.txt\" \n\\#hash \n#myLabel = 'Say \"Hello World\"'</code></pre><h2>Escaping Special Characters</h2><p>Special characters can be enclosed in quotes or escaped with a backslash to be used in full-text search:</p><pre><code class=\"language-text-x-trilium-auto\">\"note.txt\"\n\\#hash\n#myLabel = 'Say \"Hello World\"'</code></pre><p>Three types of quotes are supported: single, double, and backtick.</p><h2>Type Coercion</h2><p>Label values are technically strings but can be coerced for numeric comparisons:</p><pre><code class=\"language-text-x-trilium-auto\">note.dateCreated =* '2019-05'</code></pre><p>This finds notes created in May 2019. Numeric operators like <code>#publicationYear >= 1960</code> convert string values to numbers for comparison.</p>",
"_help_WbjlujkUhEb5": "<p>The single most common source of confusion is that the <code>=</code> sign means two <em>different</em> things depending on where it appears. Read this section once and the rest of search becomes predictable.</p><p>There are three matching modes:</p><figure class=\"table\"><table><thead><tr><th>Mode</th><th>How you trigger it</th><th>What it matches</th><th>Substring?</th><th>Fuzzy (typos)?</th></tr></thead><tbody><tr><td><strong>Default</strong></td><td>type words with no prefix</td><td>whole words <em>and</em> substrings, anywhere in title, content or attributes, relevance-ranked</td><td>Yes</td><td>Yes</td></tr><tr><td><strong>Exact full-text</strong></td><td>a leading <code>=</code> (e.g. <code>=sync</code>)</td><td>the exact whole word or phrase, ignoring surrounding punctuation</td><td>No</td><td>No</td></tr><tr><td><strong>Attribute / property equality</strong></td><td><code>=</code> inside a <code>#label=value</code> or <code>note.property=value</code> clause</td><td>the <em>entire</em> attribute or property value, exactly</td><td>No</td><td>No</td></tr></tbody></table></figure><h3>Default matching (no prefix)</h3><p><strong>Rule:</strong> typing words with no prefix finds notes that contain those words anywhere in the title, content or attributes, as whole words or as substrings. The closest matches are ranked first.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>please sync the folders</code></td><td>Yes (ranked higher)</td><td>contains the exact word <code>sync</code></td></tr><tr><td><code>sync</code></td><td><code>synchronize the database now</code></td><td>Yes (ranked lower)</td><td><code>sync</code> is a substring of <code>synchronize</code></td></tr></tbody></table></figure><h3>Exact match with the <code>=</code> prefix</h3><p><strong>Rule:</strong> a leading <code>=</code> switches the full-text search to exact matching. It finds the whole word or phrase only, ignoring surrounding punctuation, with <strong>no</strong> substring and <strong>no</strong> fuzzy matching. Use it when a normal search returns too many near-matches.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>=sync</code></td><td><code>see (sync) mode</code></td><td>Yes</td><td><code>(sync)</code> is the whole word <code>sync</code>; punctuation is ignored</td></tr><tr><td><code>=sync</code></td><td><code>in sync, then continue</code></td><td>Yes</td><td><code>sync,</code> is the whole word <code>sync</code></td></tr><tr><td><code>=sync</code></td><td><code>he said \"sync\" out loud</code></td><td>Yes</td><td><code>\"sync\"</code> is the whole word <code>sync</code></td></tr><tr><td><code>=sync</code></td><td><code>synchronize the database now</code></td><td>No</td><td><code>=</code> never matches substrings</td></tr><tr><td><code>=sync</code></td><td><code>please send the file</code></td><td>No</td><td><code>=</code> never matches typos / fuzzy</td></tr></tbody></table></figure><p>To match an exact <strong>phrase</strong>, quote it after the <code>=</code> (single, double or backtick quotes all work). The phrase must appear as consecutive words, but punctuation between or around them is ignored:</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note (title or content)</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>=\"project plan\"</code></td><td>title <code>Project Plan</code></td><td>Yes</td><td>the title is exactly the phrase</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the (project plan) is ready to share</code></td><td>Yes</td><td>the consecutive phrase appears; punctuation is ignored</td></tr><tr><td><code>=\"project plan\"</code></td><td><code>the plan for this project is late</code></td><td>No</td><td>the words are present but not consecutive</td></tr></tbody></table></figure><h3>Attribute and property equality (<code>=</code>, <code>!=</code>)</h3><p><strong>Rule:</strong> when <code>=</code> compares an attribute or property, as in <code>#label=value</code> or <code>note.title=value</code>, it is <strong>strict full-value equality</strong>: the <em>whole</em> value must equal what you typed, ignoring case and diacritics. This is <strong>not</strong> word matching. <code>!=</code> inverts it.</p><p>The examples below assume four notes: <em>Austria</em> (<code>#capital=Vienna</code>), <em>Somewhere</em> (<code>#capital=Vienna Austria</code>), <em>Czech Republic</em> (<code>#capital=Prague</code>) and <em>Switzerland</em> (<code>#capital=Zürich</code>).</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example label value</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>#capital=Vienna</code></td><td><code>Vienna</code></td><td>Yes</td><td>the whole value equals <code>Vienna</code></td></tr><tr><td><code>#capital=Vienna</code></td><td><code>Vienna Austria</code></td><td>No</td><td>the whole value is <code>Vienna Austria</code>, not <code>Vienna</code></td></tr><tr><td><code>#capital=\"Vienna Austria\"</code></td><td><code>Vienna Austria</code></td><td>Yes</td><td>quote a multi-word value to match it in full</td></tr><tr><td><code>#capital=Zurich</code></td><td><code>Zürich</code></td><td>Yes</td><td>equality ignores diacritics</td></tr><tr><td><code>#capital!=Vienna</code></td><td><code>Prague</code></td><td>Yes</td><td><code>!=</code> matches every value that is not <code>Vienna</code></td></tr><tr><td><code>#capital!=Vienna</code></td><td><code>Vienna</code></td><td>No</td><td><code>!=</code> excludes the exact value</td></tr></tbody></table></figure><blockquote><p><strong>Quick search relaxes this.</strong> The <a href=\"#root/_help_Ms1nauBra7gq\">Quick search</a> bar and autocomplete treat an attribute <code>=</code> as \"contains\", so <code>#capital=Vienna</code> typed there also matches <code>Vienna Austria</code>. The strict full-value equality described here applies only in the full Search.</p></blockquote><h3>Fuzzy operators (<code>~=</code> and <code>~*</code>)</h3><p><strong>Rule:</strong> the fuzzy operators tolerate typos. <code>~=</code> (fuzzy-equals) matches a value that is a close whole-word variant of your term. <code>~*</code> (fuzzy-contains) matches when your term appears anywhere inside the value, either as a fragment or as a near-miss. Both work on note properties such as <code>note.title</code> and <code>note.content</code>, and on labels (<code>#label</code>). Fuzzy operators accept terms of at least 3 characters, though how many typos each term tolerates depends on its length — see <em>Fuzzy tolerance</em> below.</p><p>The examples assume a note titled <code>Books</code> carrying the label <code>#author=Tolkien</code>, and a note whose content is <code>learn programming today</code>.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example value</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>note.title ~= boks</code></td><td>title <code>Books</code></td><td>Yes</td><td>one edit away from <code>books</code></td></tr><tr><td><code>#author ~= tolkein</code></td><td>author <code>Tolkien</code></td><td>Yes</td><td><code>tolkein</code> is a typo of <code>tolkien</code></td></tr><tr><td><code>note.content ~* progr</code></td><td><code>learn programming today</code></td><td>Yes</td><td><code>progr</code> is a fragment of <code>programming</code></td></tr><tr><td><code>note.content ~* programing</code></td><td><code>learn programming today</code></td><td>Yes</td><td><code>programing</code> is one edit from <code>programming</code></td></tr></tbody></table></figure><h3>Fuzzy tolerance</h3><p><strong>Rule:</strong> how many typos are tolerated depends on the <strong>length</strong> of your search term. Short terms must match exactly, because a single edit is enough to turn one short word into an unrelated one; longer terms have greater tolerance.</p><figure class=\"table\"><table><thead><tr><th>Term length</th><th>Edits allowed</th></tr></thead><tbody><tr><td>1–3 characters</td><td>0 (exact only)</td></tr><tr><td>4–6 characters</td><td>1</td></tr><tr><td>7+ characters</td><td>2</td></tr></tbody></table></figure><figure class=\"table\"><table><thead><tr><th>Query</th><th>Term length</th><th>Example note content</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>cat</code></td><td>3</td><td><code>a bright red car</code></td><td>No</td><td>No edits are allowed below 4 characters, so <code>cat</code> does not reach <code>car</code></td></tr><tr><td><code>carr</code></td><td>4</td><td><code>a blue debit card</code></td><td>Yes</td><td>1 edit is within budget for 4–6 character terms</td></tr><tr><td><code>ceck</code></td><td>4</td><td><code>the latest tech trends</code></td><td>No</td><td><code>ceck</code>→<code>tech</code> needs 2 edits; only 1 is allowed at this length</td></tr><tr><td><code>combinef</code></td><td>8</td><td><code>the values were combined together</code></td><td>Yes</td><td><code>combinef</code>→<code>combined</code> is 1 edit; up to 2 are allowed at 7+ characters</td></tr></tbody></table></figure><h3>Relevance ranking</h3><p><strong>Rule:</strong> results are ordered by <em>how well</em> they match, not merely whether they match. Exact whole-word and phrase matches rank above substring and fuzzy matches, and a note where your words appear as a consecutive phrase outranks one where they are scattered.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Ranked higher</th><th>Ranked lower</th><th>Why</th></tr></thead><tbody><tr><td><code>sync</code></td><td><code>please sync the folders</code></td><td><code>synchronize the database now</code></td><td>exact word beats substring</td></tr><tr><td><code>you and me</code></td><td><code>I like you and me as a phrase</code></td><td><code>the menu is here and you know it</code></td><td>consecutive phrase beats scattered words</td></tr></tbody></table></figure><h3>What is searchable</h3><p>A search looks at more than the visible body text. All of the following are indexed and searchable:</p><ul><li>note titles,</li><li>note body content,</li><li>labels and relations (<a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a>),</li><li>link URLs and the titles/descriptions of link previews,</li><li>the titles of notes that a note reference-links to.</li></ul><p>The last point is the least obvious: if a note's only content is a reference link to another note, searching for that other note's <strong>title</strong> still finds the linking note.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Setup</th><th>Matches?</th><th>Why</th></tr></thead><tbody><tr><td><code>special topic</code></td><td>a note whose only content is a reference link to a note titled <code>Special Topic</code></td><td>Yes, and the linked target ranks first</td><td>the target's title is indexed into the linking note's searchable text</td></tr><tr><td><code>special</code></td><td>the same note (only a reference link to <code>Special Topic</code>)</td><td>Yes, one word from the target's title is enough</td><td>the indexed title is normalized just like body text, so even one lowercased word matches</td></tr><tr><td><code>zurich</code></td><td>a note whose only content is a reference link to a note titled <code>Zürich</code></td><td>Yes</td><td>the indexed title has its accents normalized, so the plain form matches the accented title</td></tr></tbody></table></figure><h3>Diacritics</h3><p><strong>Rule:</strong> accents are normalized on both sides, so an accented word and its plain form match each other.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th></tr></thead><tbody><tr><td><code>ktory</code></td><td><code>slovo ktorý znamena nieco</code></td><td>Yes</td></tr><tr><td><code>ktorý</code></td><td><code>the word ktory appears here</code></td><td>Yes</td></tr></tbody></table></figure><h3>Regular expressions (<code>%=</code>)</h3><p><strong>Rule:</strong> the <code>%=</code> operator matches a property or label value against a regular expression.</p><figure class=\"table\"><table><thead><tr><th>Query</th><th>Example note content</th><th>Matches?</th></tr></thead><tbody><tr><td><code>note.content %= 'colou?r'</code></td><td><code>my favorite color of all</code></td><td>Yes</td></tr><tr><td><code>note.content %= 'colou?r'</code></td><td><code>my favourite colour of all</code></td><td>Yes</td></tr></tbody></table></figure><p>The search on <a href=\"#root/_help_R9pX4DGra2Vt\">shared pages</a> does not accept <code>%=</code>: a query that uses it returns no results and reports an error.</p>",
"_help_u3YFHC9tQlpm": "<p>Frequently used notes can be bookmarked, which will make them appear in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> for easy access.</p><h2>Configuring the launch bar</h2><p>If bookmarks don't appear in the launch bar, then most likely the bookmark section has been hidden. Go to the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> configuration from the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> and ensure <em>Bookmarks</em> is in the <em>Visible Launchers</em> section.</p><h2>Bookmark folder</h2><p>Space in the left panel is limited, and you might want to bookmark many items. One possible solution is to bookmark a folder, so it shows its children:</p><p>To do this, bookmark a folder, then right click its button in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> and check <em>Show as a folder</em>. The button then opens a menu instead of the note itself: the note is at the top, followed by its children. Uncheck <em>Show as a folder</em> to turn it back into a regular bookmark.</p><p>A child that has children of its own shows an arrow at the end of its row. Click the arrow to list its children in a submenu, or click the rest of the row to open the note. Submenus nest up to four levels deep. A menu that lists more than 15 children shows a filter field above them: type part of a title to list only the notes that match. A note whose subtree is hidden (see <a class=\"reference-link\" href=\"#root/_help_wyaGBBQrl4i3\">Hiding the subtree</a>) doesn't list its children here either.</p><p>The notes in the menu open the way links do: a middle click or <kbd>Ctrl</kbd>+click opens a note in a new tab, <kbd>Shift</kbd>+click opens it in a new window, and a right click lists the other places it can be opened in.</p><p><em>Show as a folder</em> assigns the <code>#bookmarkFolder</code> label to the note, so adding the label by hand works as well. Because the label belongs to the note, a note that is both bookmarked and dropped onto the launch bar shows its children in both places.</p><h2>Choosing where a bookmark opens</h2><p>A bookmark opens its note in the current tab. To open it somewhere else, right click its button in the <a class=\"reference-link\" href=\"#root/_help_xYmIYSP6wE3F\">Launch Bar</a> and pick a place under <em>Open mode</em>. The place in effect is checked.</p><figure class=\"table\"><table><thead><tr><th><em>Open mode</em></th><th>Label value</th><th>Where the note opens</th></tr></thead><tbody><tr><td><em>Current tab</em></td><td><code>currentTab</code></td><td>In the current tab. This is the default.</td></tr><tr><td><em>New tab</em></td><td><code>newTab</code></td><td>In a new tab after the current one (see <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a>).</td></tr><tr><td><em>New split</em></td><td><code>newSplit</code></td><td>In a new split next to the current note (see <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>).</td></tr><tr><td><em>New window</em></td><td><code>newWindow</code></td><td>In a new window.</td></tr><tr><td><em>Quick edit</em></td><td><code>quickEdit</code></td><td>In a popup over the current note (see <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>).</td></tr></tbody></table></figure><p><em>Open mode</em> sets the <code>#bookmarkOpenMode</code> label on the note, so adding the label by hand works as well. The label works the same way for a note dropped onto the launch bar and for the notes in a bookmark folder's menu. On a folder, <em>Open mode</em> makes the label inheritable, so every note in the folder's menu and its submenus follows it, the folder's own note included (see <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>). A note in the folder can still have a value of its own, such as <code>currentTab</code>, added by hand.</p><p>The open mode applies to a plain click only. A middle click or <kbd>Ctrl</kbd>+click still opens the note in a new tab, and <kbd>Shift</kbd>+click on a note in a folder's menu still opens it in a new window.</p><h2>Mobile</h2><p>On mobile, bookmarks are only displayed starting with v0.102.0. Because of the more constrained screen size, the bookmarks are grouped under a single icon instead of displaying them as separate icons.</p><p>When pressed, a menu will appear listing all the bookmarks. Bookmark folders are also supported and will appear as submenus. Each submenu starts with its own note, so a note with children can be opened as well as browsed.</p><p>On a phone, the bookmarks are also listed at the top of the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> while it shows the root of a tab that is not hoisted, below the <a class=\"reference-link\" href=\"#root/_help_9sRHySam5fXb\">Workspaces</a>. Tap a bookmark to open it, or, for one with children, to list them, as with the other notes of the tree.</p>",
"_help_OR8WJ7Iz9K4U": "<p>Hoisting is a standard outliner feature which allows you to focus on (or \"zoom into\") a specific note and its subtree by hiding all parent and sibling notes. Demo:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Note%20Hoisting_note-hoisting.gif\"></p><p>In addition to showing only this subtree, this also narrows both full text search and <a href=\"#root/_help_MMiBEQljMQh2\">“jump to note”</a> to just notes present in hoisted subtree.</p><h2>Showing all notes again</h2><p>While a note is hoisted, the desktop interface shows a <em>Show all notes</em> button with the <span class=\"tn-icon bx bx-arrow-back\"></span> icon above the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. Click it to unhoist the note and see the whole tree again.</p><p>On a phone, the back button at the top level of the hoisted tree turns into a <span class=\"tn-icon bx bx-exit\"></span> button, followed by the hoisted note's title. Tap it to unhoist the note; the tree then shows the level holding the hoisted note, as one more step up.</p><p>See also <a href=\"#root/_help_9sRHySam5fXb\">Workspace</a> which extends this feature.</p>",
"_help_ZjLYv08Rp3qC": "<figure class=\"image image-style-align-right image_resized\" style=\"width:53.13%;\"><img style=\"aspect-ratio:895/694;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Quick%20edit_image.png\" width=\"895\" height=\"694\"></figure><p><em>Quick edit</em> provides an alternative to the standard tab-based navigation and editing.</p><p>Instead of clicking on a note which switches the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> to the newly selected note, or navigating between two different <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a>, the <em>Quick edit</em> feature opens as a popup window that can be easily dismissed.</p><p>This feature is also well integrated with <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> such as the calendar view, which makes it easy to edit entries without having to go back and forth between the child note and the calendar.</p><h2>Feature highlights</h2><ul><li>All note types are supported, including <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li>Note that the <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> will not be displayed, except for notes of type <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</li><li>For <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, depending on user preference, both the floating and classic editors are supported. See <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</li><li>The title and the note and the icon are editable, just like a normal tab.</li><li>The note's actions and its menu are shown in the header of the popup, as in the title row of a tab.<ul><li>When other notes link to the note, a button with a link icon lists the <a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>. Pressing one opens that note in the popup.</li><li>The menu items that only work in a tab are not shown: <em>Note map</em>, <em>Full width</em> and <em>Convert into attachment</em>.</li><li><em>Find</em> in the menu, or <kbd>Ctrl</kbd>+<kbd>F</kbd> on the desktop application, opens the <a class=\"reference-link\" href=\"#root/_help_McngOG2jbUWX\">Search in note</a> bar at the bottom of the popup. It searches the note in the popup, not the note in the tab behind it.</li><li>A help page opened from the popup, such as through the help button of the note type, opens in a second popup on top of it. Closing that popup returns to the note being edited.</li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> are also displayed.<ul><li>This integrates well with <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> where there are predefined attributes such as the <em>Start date</em> and <em>End date</em>, allowing for easy editing.</li></ul></li></ul><h2>Accessing the quick edit</h2><ul><li>From the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>:<ul><li>Right click on a note and select <em>Quick edit</em>.</li><li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on a note.</li></ul></li><li>On <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>: <ul><li>Right click and select <em>Quick edit</em>.</li><li>or, press <kbd>Ctrl</kbd>+<kbd>Right click</kbd> on the link.</li></ul></li><li>On a <a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a>, press the quick edit icon.</li><li>In <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>:<ul><li>For <a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>:<ul><li>Clicking on an event will open that event for quick editing.</li><li>If the calendar is for the <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a> root, clicking on the day number will open the popup for that day note.</li></ul></li><li>For <a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>:<ul><li>Clicking on a marker will open that marker, but only if the map is in read-only mode.</li></ul></li></ul></li></ul><h2>Handling of read-only notes</h2><p>The Quick edit feature has a unique behavior for <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>: </p><ul><li>If the note is read-only due to performance reasons (auto read-only), then the note is made editable for quick editing.</li><li>If the note has been manually set to read-only, then the note is read-only to prevent accidental change.<ul><li>In this case, the note can still be edited by on-screen instructions.</li></ul></li></ul><h2>Mobile support</h2><p>On a phone, the popup uses the full width of the screen and the note's content keeps the same side margin as a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. The <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> of a text note sits at the foot of the dialog, below the note; its dropdowns open upwards so the keyboard does not cover them.</p>",
"_help_9sRHySam5fXb": "<p>Workspace is a concept built up on top of <a href=\"#root/_help_OR8WJ7Iz9K4U\">note hoisting</a>. It is based on the idea that a user has several distinct spheres of interest. An example might be \"Personal\" and \"Work\", these two spheres are quite distinct and don't interact together. When I focus on Work, I don't really care about personal notes.</p><p>So far workspace consists of these features:</p><ul><li><p><a href=\"#root/_help_OR8WJ7Iz9K4U\">note hoisting</a> - you can \"zoom\" into a workspace subtree to focus only on the relevant notes</p></li><li><p>easy entering of workspace: </p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/1_Workspaces_image.jpg\"></p></li><li><p>opening a workspace in a new tab: right-click the <span class=\"tn-icon bx bx-plus\"></span> button of the <a class=\"reference-link\" href=\"#root/_help_3seOhtN8uLIY\">Tabs</a> bar and select the workspace.</p></li><li><p>on a phone, the workspaces are listed at the top of the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> while it shows the root of a tab that is not hoisted, such as a new tab. Tap one to enter it, and tap the <span class=\"tn-icon bx bx-exit\"></span> button at the top of the workspace's tree to leave it.</p></li><li><p>visual identification of workspace in tabs:<br><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Workspaces_image.jpg\"></p></li></ul><h3>Configuration</h3><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>workspace</code></td><td>Marks this note as a workspace, button to enter the workspace is controlled by this</td></tr><tr><td><code>workspaceIconClass</code></td><td>defines box icon CSS class which will be used in tab when hoisted to this note, and in the menu of the tab bar's <span class=\"tn-icon bx bx-plus\"></span> button</td></tr><tr><td><code>workspaceTabBackgroundColor</code></td><td>CSS color used in the note tab when hoisted to this note, for the workspace's icon in the menu of the tab bar's <span class=\"tn-icon bx bx-plus\"></span> button, and for the <span class=\"tn-icon bx bx-exit\"></span> button that leaves the workspace on a phone; use any CSS color format, e.g. \"lightblue\" or \"#ddd\". See <a href=\"https://www.w3schools.com/cssref/css_colors.asp\">https://www.w3schools.com/cssref/css_colors.asp</a>.</td></tr><tr><td><code>workspaceCalendarRoot</code></td><td>Marking a note with this label will define a new per-workspace calendar for <a class=\"reference-link\" href=\"#root/_help_l0tKav7yLHGF\">Day Notes</a>. If there's no such note, the global calendar will be used.</td></tr><tr><td><code>workspaceTemplate</code></td><td>This note will appear in the selection of available template when creating new note, but only when hoisted into a workspace containing this template</td></tr><tr><td><code>workspaceSearchHome</code></td><td>new search notes will be created as children of this note when hoisted to some ancestor of this workspace note</td></tr><tr><td><code>workspaceInbox</code></td><td>Default inbox location for new notes when hoisted to some ancestor of this workspace note. See <a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a> for more information.</td></tr></tbody></table></figure>",
"_help_xWtq5NUHOwql": "<figure class=\"image image-style-align-right image_resized\" style=\"width:50.46%;\"><img style=\"aspect-ratio:538/290;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Similar%20Notes_image.png\" width=\"538\" height=\"290\"></figure><p>The Similar Notes feature tries to identify notes that relate to the current note by looking at the content of the notes, their relationships, as well as the date they were created.</p><p>To access the list of similar notes:</p><ul><li>Go to the <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a> in the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> and look for the corresponding section.</li><li>Alternatively, press the <span class=\"tn-icon bx bx-info-circle\"></span> in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a> and select <em>Show similar notes</em> which will open a pane at the bottom.</li><li>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, open the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Note info</em> and select <em>Show similar notes</em>.</li></ul><h2>Interaction</h2><ul><li>Hover over a note to see a short preview of the note.</li><li>Click over a note to open it in the current view.</li><li><kbd>Ctrl</kbd> + click a note to open it in a separate tab.</li></ul>",
"_help_McngOG2jbUWX": "<figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:898/93;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Navigation/Search%20in%20note_image.png\" width=\"898\" height=\"93\"></figure><p>Local search allows you to search within the currently displayed note. </p><h2>Alternatives</h2><ul><li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> while in a browser while not focused in a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> or a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note will trigger the browser's native search. This will also find text that is part of Trilium's UI.</li><li>Pressing <kbd>Ctrl</kbd>+<kbd>F</kbd> in a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note will reveal <a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>'s search functionality.</li></ul><h2>Accessing the search</h2><ul><li>On desktop, press<kbd>Ctrl</kbd> + <kbd>F</kbd>.</li><li>From the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, select <em>Find</em> in the row of icons at the top.</li><li>In <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, both open a search bar at the bottom of the popup, for the note in the popup.</li></ul><h2>Interaction</h2><ul><li>Finding:<ul><li>Fill in the <em>Find in text…</em> with the text to search for.</li><li>The search will be executed automatically in the background.</li><li>Use up and down arrows of the text box to navigate between results.</li></ul></li><li>Replacing:<ul><li>Fill in the <em>Find in text</em>… field with the text to replace.</li><li>Fill in the <em>Replace with…</em> field the text to replace it with.</li><li>Press <em>Replace</em> to replace only the current result.</li><li>Press <em>Replace all</em> to replace all of them at once.</li></ul></li><li>Options:<ul><li><em>Case sensitive</em> – the search will distinguish upper case characters from lower case (e.g. searching for Hello will not match <code>hello</code>).</li><li><em>Match words</em> - the search will find only exact word matches (e.g. searching for <code>Java</code> will not match <code>JavaScript</code>).</li></ul></li></ul><h2>Included notes</h2><p>In a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note, the search also finds the text of the notes included with <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>, in the order they appear in the note.</p><ul><li>The text of included text and code notes and of embedded code files, such as a <code>.js</code> or <code>.txt</code> attachment, is searched. The title of an include and the content of other notes, such as a collection or a drawing, are not.</li><li>The up and down arrows move through the results of an include as through the rest of the note.</li><li>A result in a collapsed <em>Expandable</em> include expands the include while that result is the current one, and collapses it again once the search moves on.</li><li><em>Replace</em> and <em>Replace all</em> change an included note only while its <em>Editable</em> button is on. While the current result is in an include that cannot be edited, <em>Replace</em> is disabled, and <em>Replace all</em> leaves such results unchanged.</li></ul>",
"_help_A9Oc6YKKc65v": "<p>This is supposed to be a complete list of keyboard shortcuts. Note that some of these may work only in certain contexts (e.g. in tree pane or note editor).</p><h2>Configuring keyboard shortcuts</h2><p>It is also possible to configure most keyboard shortcuts in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Shortcuts</em>.</p><p>On the <a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, it's also possible to make shortcuts global by pressing on the globe icon near the key combination, which makes the shortcut work even without Trilium being in focus.</p><h3>Keyboard layouts</h3><p>Shortcuts follow the characters printed on the keys of the active keyboard layout. On a French AZERTY keyboard, for example, <kbd>Ctrl</kbd>+<kbd>Z</kbd> is the key labeled Z.</p><p>On a layout that doesn't type Latin letters, such as Russian, Greek or Hebrew, a key that types a letter of that alphabet counts as the key at the same position on a US QWERTY keyboard. <kbd>Ctrl</kbd>+<kbd>J</kbd> is then the key that types <code>о</code> on a Russian keyboard, so shortcuts keep working without switching the layout first.</p><p>Keys that type punctuation still follow their own character. On a Russian keyboard, the key that types <code>.</code> triggers <kbd>Ctrl</kbd>+<kbd>.</kbd>, not the shortcut of the US key at its position.</p><h2>Shortcut reference</h2><aside class=\"admonition note\"><p>All these shortcuts indicate the default key-bindings which can be changed individually from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Shortcuts.</em></p></aside><h3>Tree</h3><p>See the corresponding section: <a class=\"reference-link\" href=\"#root/_help_DvdZhoQZY9Yd\">Keyboard shortcuts</a></p><h3>Note navigation</h3><ul><li><kbd>Alt</kbd>+<kbd>←</kbd>, <kbd>Alt</kbd>+<kbd>→</kbd> – go back / forwards in the history</li><li><kbd>Ctrl</kbd>+<kbd>J</kbd> – show <a href=\"#root/_help_MMiBEQljMQh2\">\"Jump to\" dialog</a></li><li><kbd>Ctrl</kbd>+<kbd>.</kbd> – scroll to current note (useful when you scroll away from your note or your focus is currently in the editor)</li><li><kbd>Backspace</kbd> – jumps to parent note</li><li><kbd>Alt</kbd>+<kbd>C</kbd> – collapse whole note tree</li><li><kbd>Alt</kbd>+<kbd>-</kbd> (alt with minus sign) – collapse subtree (if some subtree takes too much space on tree pane you can collapse it)</li><li>you can define a <a href=\"#root/_help_zEY4DaJG4YT5\">label</a> <code>#keyboardShortcut</code> with e.g. value <code>Ctrl + I</code> . Pressing this keyboard combination will then bring you to the note on which it is defined. Note that Trilium must be reloaded/restarted (<kbd>Ctrl</kbd>+<kbd>R</kbd> ) for changes to be in effect.</li></ul><p>See demo of some of these features in <a href=\"#root/_help_MMiBEQljMQh2\">note navigation</a>.</p><h3>Tabs</h3><ul><li><kbd>Ctrl</kbd> + <kbd>🖱 Left click</kbd> – (or middle mouse click) on note link opens note in a new tab</li></ul><p>Only in desktop (electron build):</p><ul><li><kbd>Ctrl</kbd>+<kbd>T</kbd> – opens empty tab</li><li><kbd>Ctrl</kbd>+<kbd>W</kbd> – closes active tab</li><li><kbd>Ctrl</kbd>+<kbd>Tab</kbd> – activates next tab</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd> – activates previous tab</li></ul><h3>Splits</h3><p><a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a> can also be controlled through keyboard actions, such as:</p><ul><li>Creating a new split</li><li>Closing the active split</li><li>Moving a split left/right</li><li>Focusing the split to the left/right.</li></ul><p>All these keyboard shortcuts do not have a default set, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Shortcuts</em> and look for the <em>Split View</em> category.</p><h3>Context menus</h3><p>Every context menu can be operated from the keyboard, however it was opened, for example with the <kbd>Menu</kbd> key in a text note to reach the spelling suggestions. These keys are fixed and cannot be changed in the options.</p><ul><li><kbd>↑</kbd>, <kbd>↓</kbd> – move to the previous / next item, skipping disabled ones and wrapping around at either end</li><li><kbd>Home</kbd>, <kbd>End</kbd> – move to the first / last item</li><li><kbd>→</kbd> – open the submenu of the current item, or move to the next column in a submenu laid out in columns</li><li><kbd>←</kbd> – move to the previous column, or close the submenu and go back to its item</li><li><kbd>Enter</kbd> or <kbd>Space</kbd> – run the current item, or open its submenu</li><li><kbd>Esc</kbd> – close the innermost submenu, then the menu itself</li><li>typing the first letters of an item – jump to the next item whose title starts with them</li></ul><p>With a right-to-left language, <kbd>←</kbd> and <kbd>→</kbd> swap roles.</p><h3>Creating notes</h3><ul><li><kbd>Ctrl</kbd>+<kbd>O</kbd> – creates new note after the current note</li><li><kbd>Ctrl</kbd>+<kbd>P</kbd> – creates new sub-note into current note</li><li><kbd>F2</kbd> – edit the <a class=\"reference-link\" href=\"#root/_help_TBwsyfadTA18\">Branch prefix</a> of current note clone</li></ul><h3>Editing notes</h3><aside class=\"admonition note\"><p>For keyboard shortcuts specific to <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, refer to <a class=\"reference-link\" href=\"#root/_help_oiVPnW8QfnvS\">Keyboard shortcuts</a> and <a class=\"reference-link\" href=\"#root/_help_QrtTYPmdd1qq\">Markdown-like formatting</a>.</p></aside><ul><li>Enter in tree pane switches from tree pane into note title. Enter from note title switches focus to text editor. <kbd>Ctrl</kbd>+<kbd>.</kbd> switches back from editor to tree pane.</li><li><kbd>Ctrl</kbd>+<kbd>.</kbd> – jump away from the editor to tree pane and scroll to current note</li></ul><h3>Runtime shortcuts</h3><p>These are hooked in Electron to be similar to native browser keyboard shortcuts.</p><ul><li><kbd>F5</kbd>, <kbd>Ctrl</kbd>+<kbd>R</kbd> – reloads Trilium front-end</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> – show developer tools</li><li><kbd>Ctrl</kbd>+<kbd>F</kbd> – show search dialog</li><li><kbd>Ctrl</kbd>+<kbd>-</kbd> – zoom out</li><li><kbd>Ctrl</kbd>+<kbd>=</kbd> – zoom in</li></ul><h3>Other</h3><ul><li><kbd>Alt</kbd>+<kbd>O</kbd> – show SQL console (use only if you know what you're doing)</li><li><kbd>Alt</kbd>+<kbd>M</kbd> – distraction-free mode - display only note editor, everything else is hidden</li><li><kbd>F11 </kbd> – toggle full screen</li><li><kbd>Ctrl</kbd>+<kbd>S</kbd> – toggle <a href=\"#root/_help_eIg8jdvaoNNd\">search</a> form in tree pane</li><li><kbd>Alt</kbd>+<kbd>A</kbd> – show note <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> dialog</li></ul>",
"_help_Wy267RK4M69c": "<h2>Default Themes</h2><p>Trilium comes with a couple pre-installed color themes, with the default being a light theme. To switch to a dark theme or any other available theme, navigate to the <span class=\"tn-icon bx bx-cog\"></span> Options menu (accessible via the app icon in the top-left corner), select the Appearance tab, and choose your preferred theme. The <em>Theme</em> submenu of the <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> switches the theme and the color scheme as well.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_dark-theme.png\" alt=\"Dark Theme\"></p><p>While a dark theme is active, Trilium asks the Dark Reader browser extension not to darken the page a second time. Dark Reader still darkens the light themes. After switching from a dark theme to a light one, reload the page (<kbd>Ctrl</kbd>+<kbd>R</kbd>) for Dark Reader to take effect again.</p><h2>Creating Custom CSS Themes</h2><p>Trilium supports custom user themes, allowing you to personalize the application's appearance. To create a custom theme, follow these steps:</p><ol><li><strong>Create a CSS Code Note</strong>: Start by creating a new <a href=\"#root/_help_6f9hih2hXXZk\">code note</a> with the <code>CSS</code> type.</li><li><strong>Annotate with</strong> <code>#appTheme</code>: Add the <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> <code>#appTheme=my-theme-name</code> to your note, where <code>my-theme-name</code> is the name of your custom theme.</li><li><strong>Define Your Styles</strong>: Write your custom CSS within the note.</li></ol><details class=\"trilium-collapsible\" open=\"\"><summary>Example of a custom theme</summary><pre><code class=\"language-text-x-trilium-auto\">@font-face {\n font-family: 'Raleway';\n font-style: normal;\n font-weight: 400;\n src: url('/custom/fonts/raleway.woff2') format('woff2');\n}\n\n:root {\n --main-font-family: 'Raleway' !important;\n --main-font-size: normal;\n --tree-font-family: inherit;\n --tree-font-size: normal;\n --detail-font-family: inherit;\n --detail-font-size: normal;\n --detail-text-font-family: 'Garamond' !important;\n\n --main-background-color: #404552;\n --main-text-color: #AFB8C6;\n --main-border-color: #AFB8C6;\n --accented-background-color: #383C4A;\n --more-accented-background-color: #2F343F;\n --header-background-color: #383C4A;\n --button-background-color: #2F343F;\n --button-disabled-background-color: #404552;\n --button-border-color: #333;\n --button-text-color: #AFB8C6;\n --button-border-radius: 2px;\n --primary-button-background-color: #6c757d;\n --primary-button-text-color: white;\n --primary-button-border-color: #6c757d;\n --muted-text-color: #86919F;\n --input-text-color: #AFB8C6;\n --input-background-color: #404552;\n --hover-item-text-color: white;\n --hover-item-background-color: #4877B1;\n --active-item-text-color: white;\n --active-item-background-color: #4877B1;\n --menu-text-color: #AFB8C6;\n --menu-background-color: #383C4A;\n --tooltip-background-color: #383C4A;\n --link-color: lightskyblue;\n --modal-background-color: #404552;\n --modal-backdrop-color: black;\n --scrollbar-thumb-color: rgba(175, 184, 198, 0.5);\n}\n\nbody .note-detail-text {\n font-size: 120%;\n}\n\nbody .CodeMirror {\n filter: invert(100%) hue-rotate(180deg);\n}</code></pre><p> </p></details><p> </p><h3>Activating Your Custom Theme</h3><p>Once you've created your custom theme:</p><ol><li>Go to \"Menu\" -> \"Options\" (<span class=\"tn-icon bx bx-cog\"></span>) -> \"Appearance.\"</li><li>In the theme selection dropdown, you should see your custom theme listed under the name you provided with the <code>#appTheme</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li>Select your custom theme to activate it.</li></ol><p>Your custom theme is also listed under <a class=\"reference-link\" href=\"#root/_help_x3i7MxGccDuM\">Global menu</a> → <em>Theme</em>, with the icon of its note.</p><p>If you make changes to your theme, press Ctrl + R to reload the frontend and apply your updates.</p><h3>Sharing and Importing Themes</h3><p>Custom themes can be exported as <code>.tar</code> archives, which can be shared with other users. However, be cautious when importing themes from untrusted sources, as they may contain executable scripts that could pose security risks.</p><p>An example user theme, <em>Steel Blue</em>, is available in the demo document.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_steel-blue.png\" alt=\"Steel Blue Theme\"></p><h3>Using Custom CSS for Specific Purposes</h3><p>In addition to full themes, Trilium allows for custom CSS that isn't tied to a theme. This can be particularly useful in scripting contexts, where you might want to modify specific UI elements, such as changing the colors of notes in the tree view.</p><h3>Applying Custom CSS</h3><p>To use custom CSS:</p><ol><li><strong>Create a CSS Code Note</strong>: Create a new <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note with the <code>CSS</code> type.</li><li><strong>Add the</strong> <code>appCss</code> <strong>Label</strong>: Annotate the note with the <code>#appCss</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>.</li><li><strong>Write Your CSS</strong>: Add your custom CSS rules to the note.</li></ol><p>For example:</p><pre><code class=\"language-text-x-trilium-auto\">/* Custom CSS to style specific elements */\n.tree-item {\n color: #ff6347; /* Change tree item color */\n}</code></pre><p>When Trilium's frontend starts, all notes labeled with <code>appCss</code> are automatically included in the style element of the HTML page.</p><p>After making changes, press Ctrl + R to reload the frontend and apply your new styles.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes_image.jpg\"></p><h3>Styling Specific Notes in the Tree</h3><p>To apply specific styles to certain notes in the tree:</p><ul><li><strong>Use the</strong> <code>cssClass</code> <strong>Attribute</strong>: Add the <code>cssClass</code> <a href=\"#root/_help_zEY4DaJG4YT5\">attribute</a> to a note, and assign it a value representing the desired CSS class.</li><li><strong>Define an</strong> <code>iconClass</code>: You can also define a custom icon for a note using the <code>iconClass</code> attribute, selecting from <a href=\"https://boxicons.com\">Box Icons</a> or your own custom classes.</li></ul><p>For example, if you want to style notes of a specific type, such as notes containing PNG images, you can target them with classes like <code>type-image mime-image-png</code>.</p><h3>User-Provided Themes</h3><p>A gallery of user-created themes is available, showcasing the variety of customizations that the Trilium community has developed. For more information, check the <a class=\"reference-link\" href=\"#root/_help_VbjZvtUek0Ln\">Theme Gallery</a>.</p><h3>Asset Path Management</h3><p>When referencing built-in assets like images in your custom themes or CSS, you can avoid hardcoding version numbers by using the <code>vX</code> alias. For example, instead of specifying <code>/assets/v0.57.0-beta/images/icon-grey.png</code>, you can use <code>/assets/vX/images/icon-grey.png</code> to keep your theme compatible with future versions of Trilium.</p>",
"_help_VbjZvtUek0Ln": "<p>These are user-created themes which were made publicly available:</p><h2>Legacy Themes</h2><p>These themes may or may not be compatible with the latest versions of TriliumNext and are based on the original/legacy theme.</p><figure class=\"table\"><table><thead><tr><th>Theme</th><th>Author</th></tr></thead><tbody><tr><td><a href=\"https://github.com/tobealive/trilium-midnight-theme\">Midnight</a></td><td><a href=\"https://github.com/tobealive\">tobealive</a></td></tr><tr><td><a href=\"https://github.com/tobealive/trilum-eote-theme\">EOTE</a></td><td><a href=\"https://github.com/tobealive\">tobealive</a></td></tr><tr><td><a href=\"https://github.com/Abourass/TriliumThemes\">Trilium Themes</a></td><td><a href=\"https://github.com/Abourass\">Abourass</a></td></tr><tr><td><a href=\"https://github.com/ZMonk91/Material-Dark-Trilium\">MaterialDark</a></td><td><a href=\"https://github.com/ZMonk91\">ZMonk91</a></td></tr><tr><td><a href=\"https://github.com/jaroet/trilium-theme-lightslategray\">lightslategray</a></td><td><a href=\"https://github.com/jaroet\">jaroet</a></td></tr><tr><td><a href=\"https://github.com/raphwriter/trilium-theme-melon\">melon-4</a></td><td><a href=\"https://github.com/raphwriter\">raphwriter</a></td></tr><tr><td><a href=\"https://github.com/Engr-AllanG/trilium-themes\">Neon_Dark</a></td><td><a href=\"https://github.com/Engr-AllanG\">Engr-AllanG</a></td></tr><tr><td><a href=\"https://github.com/Engr-AllanG/trilium-themes\">Coder_Dark</a></td><td><a href=\"https://github.com/Engr-AllanG\">Engr-AllanG</a></td></tr><tr><td><a href=\"https://github.com/idelem/trilium-theme-velvet\">velvet</a></td><td><a href=\"https://github.com/idelem\">idelem</a></td></tr><tr><td><a href=\"https://github.com/SADAVA/trilium-notes-theme-dark-plus\">Dark Plus</a></td><td><a href=\"https://github.com/SADAVA\">SADAVA</a></td></tr><tr><td><a href=\"https://github.com/WKSu/trilium-solarized-theme\">Solarized</a></td><td><a href=\"https://github.com/WKSu\">WKSu</a></td></tr><tr><td><a href=\"https://github.com/en3r0/Trilium-Nord-Theme\">Nord</a></td><td><a href=\"https://github.com/en3r0\">en3r0</a></td></tr><tr><td><a href=\"https://github.com/AllanZyne/trilium-bear-theme\">Bear Note Light</a></td><td><a href=\"https://github.com/AllanZyne\">AllanZyne</a></td></tr><tr><td><a href=\"https://github.com/AllanZyne/trilium-bear-theme\">Bear Note Dark</a></td><td><a href=\"https://github.com/AllanZyne\">AllanZyne</a></td></tr><tr><td><a href=\"https://github.com/Sebiann/miku-hatsune-trilium-theme\">Miku Hatsune</a></td><td><a href=\"https://github.com/Sebiann\">Sebiann</a></td></tr><tr><td><a href=\"https://github.com/cwilliams5/Midnight-Trilium-Dark-Mode\">Midnight</a></td><td><a href=\"https://github.com/cwilliams5\">cwilliams5</a></td></tr><tr><td><a href=\"https://github.com/SiriusXT/trilium-theme-blue\">Blue</a> (light)</td><td><a href=\"https://github.com/SiriusXT\">SiriusXT</a></td></tr><tr><td><a href=\"https://github.com/SiriusXT/trilium-theme-blue\">Blue</a> (dark)</td><td><a href=\"https://github.com/SiriusXT\">SiriusXT</a></td></tr></tbody></table></figure><aside class=\"admonition tip\"><p>If you would like to add your theme to this gallery, write a new post in <a href=\"https://github.com/TriliumNext/Trilium/discussions/categories/show-and-tell\">👐 Show and tell</a>.</p></aside>",
"_help_gOKqSJgXLcIj": "<figure class=\"image image-style-align-right image_resized\" style=\"width:45.14%;\"><img style=\"aspect-ratio:854/649;\" src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Themes/Icon%20Packs_image.png\" width=\"854\" height=\"649\"></figure><p>By default, Trilium comes with a set of icons called Boxicons v2. Since v0.102.0, custom icon packs allow a wider selection of icons for notes.</p><p>Icon packs are specific to Trilium, so they must either be created from scratch (see below) or imported from a ZIP file from a third-party developer.</p><h2>Sample icon packs</h2><p>The Trilium team maintains a few icon packs that are not shipped with Trilium. These icon packs can be found on the official website on the <a href=\"https://triliumnotes.org/resources\">Resources page</a>.</p><h2>Importing an existing icon pack</h2><aside class=\"admonition note\"><p><strong>Icon packs are third-party content</strong></p><p>Apart from the <a href=\"https://triliumnotes.org/resources\">sample icon packs</a>, the Trilium maintainers are not responsible for keeping icon packs up to date. If you have an issue with a specific icon pack, then the issue must be reported to the third-party developer responsible for it, not the Trilium team.</p></aside><p>To import an icon pack:</p><ol><li>Ideally, create a dedicated spot in your note tree where to place the icon packs.</li><li>Right click the note where to put it and select <em>Import into note</em>.</li><li>Uncheck <em>Safe import</em>.</li><li>Select <em>Import</em>.</li><li><a href=\"#root/_help_s8alTXmpFR61\">Refresh the application</a>.</li></ol><aside class=\"admonition warning\"><p>Since <em>Safe import</em> is disabled, make sure you trust the source as it could contain dangerous third-party scripts. One good way to check if the icon pack is safe is to manually extract the .zip and inspect the file contents. Icon packs should only contain a font file and a JSON file. Other files (especially scripts) are to be considered harmful.</p></aside><h2>Creating an icon pack</h2><p>Creating an icon pack requires some scripting knowledge outside Trilium in order to generate the list of icons. For information, see <a class=\"reference-link\" href=\"#root/_help_g1mlRoU8CsqC\">Creating an icon pack</a>.</p><h2>Using an icon from an icon pack</h2><p>After <a href=\"#root/_help_s8alTXmpFR61\">refreshing the application</a>, the icon pack should be enabled by default. To test this, simply select an existing note or create a new one and try to change the note icon.</p><p>There should be a <em>Filter</em> button to the right of the search bar in the icon list. Clicking it allows filtering by icon pack and the newly imported icon pack should be displayed there.</p><aside class=\"admonition note\"><p>If the icon pack is missing from that list, then most likely there's something wrong with it.</p><ul><li>Try checking the <a class=\"reference-link\" href=\"#root/_help_bnyigUA2UK7s\">Backend (server) logs</a> for clues and make sure that the icon pack has the <code>#iconPack</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> with a value assigned to it (a prefix).</li><li>Icon packs that are <a href=\"#root/_help_bwg0e8ewQMak\">protected</a> are ignored.</li></ul></aside><h2>Integration with the share and export functionality</h2><p>Custom icon packs are also supported by the <a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a> feature, where they will be shown in the note tree. However, in order for an icon pack to be visible to the share function, the icon pack note must also be shared.</p><p>If you are using a custom share theme, make sure it supports the <code>iconPackCss</code>, otherwise icons will not show up. Check the original share template source code for reference.</p><p>Custom icon packs will also be preserved when <a class=\"reference-link\" href=\"#root/_help_ycBFjKrrwE9p\">Exporting static HTML for web publishing</a>. In this case, there's no requirement to make the icon pack shared.</p><h2>What happens if I remove an icon pack</h2><p>If an icon pack is removed or disabled (by removing or altering its <code>#iconPack</code> label), all the notes that use this icon pack will show in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> with no icon. This won't cause any issues apart from looking strange.</p><p>The solution is to replace the icons with some else, try using <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> which supports bulk actions, to identify the notes with the now deleted icon pack (by looking for the prefix) and changing or removing their <code>iconClass</code>.</p>",
"_help_w4rMEhJsALlA": "<h2>Using different fonts</h2><p>Trilium comes by default with its own font (<em>Inter</em>), but the font can be adjusted in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em>, by checking <em>Use different fonts</em> in the <em>Fonts</em> section.</p><p>The font can be personalized for the following areas of the application:</p><ul><li>Interface text, for most of the UI (menus, toolbars, dialogs).</li><li><a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Document text, for the actual content of the notes (especially for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes).</li><li>Monospace text, e.g. for <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes and <a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.</li></ul><p>Each area also has its own <em>Size</em>. The note tree and document sizes are relative to the interface size, so changing the interface size moves them along with it.</p><p>The list of fonts contains the following items:</p><ul><li><strong>Generic fonts</strong><ul><li><em>Theme defined</em> which uses the font that is embedded with the current <a href=\"#root/_help_Wy267RK4M69c\">theme</a>. For example on the default modern theme, the font is <em>Inter</em>. This does not require the font to be installed.</li><li><em>System default</em> which uses a combination of fonts that works best for the <a href=\"#root/_help_poXkQfguuA0U\">desktop app</a>. For example on Windows it will use <em>Segoe UI</em>.</li><li>Generic font selections for fonts with serifs (e.g. <em>Times New Roman</em>-like), no serifs and monospace.</li></ul></li><li><strong>Web fonts</strong> which appear on the <a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>, which is a predefined list of fonts and grouped into Sans-serif, serif, monospace and handwriting. The fonts that are not supported by your system (i.e. not installed) are not displayed.</li><li><strong>System fonts</strong> which appear on the <a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>. Unlike the server fonts which are predefined, the system fonts are listed from your operating system.</li><li><strong>Custom fonts</strong>, allowing any font to be used provided it's imported into Trilium. See the section below for more information.</li></ul><p>Font changes take effect after a reload; the section offers a <em>Reload to apply changes</em> button once something has been changed.</p><h2>Custom fonts</h2><p>A font file imported into Trilium can be used by the application itself, without writing any CSS.</p><h3>Adding a font</h3><ol><li>Import the font file, by dragging it into the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> or through <em>Import into note</em>. TrueType (<code>.ttf</code>), OpenType (<code>.otf</code>) and Web Open Font Format (<code>.woff</code>, <code>.woff2</code>) files are recognized; the note takes the font's name without its extension and is marked with a font icon (an “A” icon).</li><li>Select the resulting note where a preview of a font will be displayed: a specimen line to type your own text into, a slider for its size, a preview in multiple sizes, and the Latin character set.</li><li>Turn on <em>In font picker</em> above the specimen.</li><li>In <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> → <em>Fonts</em>, the font is now offered under <em>Custom fonts</em>, ahead of the built-in families, and can be set for any of the four areas.</li></ol><aside class=\"admonition note\"><p>Embedded OpenType (<code>.eot</code>) files and TrueType collections (<code>.ttc</code>) cannot be drawn by the browser, so they are treated as ordinary files: no preview, and no entry in the picker.</p></aside><h3>How custom fonts behave</h3><ul><li>Each entry is named after its note, so renaming the note renames the entry. The setting refers to the note itself rather than to its name, and keeps working across a rename.</li><li>The font file is an ordinary note, so <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> carries it to your other devices. The choice of font is not synced: appearance settings are deliberately kept per-device, so on another device the font is already there and only needs to be selected again.</li><li>A font kept in a <a href=\"#root/_help_bwg0e8ewQMak\">protected note</a> can only be previewed and used while the protected session is open.</li></ul><p>For theme authors, a font can also be embedded in a theme's CSS through <a class=\"reference-link\" href=\"#root/_help_d3fAXQ2diepH\">Custom Resource Providers</a>, which is the route to take when the font should come with the theme rather than be chosen in the settings.</p><h3>Downloading from Google Fonts</h3><p>A large selection of fonts can be easily retrieved from Google Fonts, as follows:</p><ol><li>Go to <a href=\"https://fonts.google.com\">https://fonts.google.com</a>.</li><li>Search for a desired font.</li><li>Press <em>Get font</em> in the top right.</li><li>Check that the list of fonts on the left side corresponds to your selection.</li><li>Press <em>Download all</em>.</li><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, create a note where to store the new fonts.</li><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, drag-and-drop the .zip file directly onto the newly created note and follow the steps from the previous section.</li></ol><h2>Programming ligatures</h2><p>Some fonts support programming ligatures, which will turn character combinations such as <code>!=</code> into <code>≠</code> or <code>-></code> as <code>→</code> in <a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a> and <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes.</p><p>These are only a display affordance, so copying the text is not affected. Regardless, this feature can be disabled in Trilium by unchecking <em>Programming ligatures</em> in the font settings.</p>",
"_help_mHbBMPDPkVV5": "<p>To import a note:</p><ul><li>The easiest way to import is to simply drag & drop a file or an archive into the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.<ul><li>This will automatically detect some formats such as <a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>.</li><li><em>Safe import</em> is automatically on to prevent accidental running of foreign scripts.</li></ul></li><li>To configure an import, there is a dedicated dialog which can be accessed from either <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> → <em>Import into note</em> or <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Import into note</em>.<ul><li>This feature allows for dedicated importers for others apps such as <a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a> or <a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>.</li><li><em>Safe import</em> as well as other options can be configured from the collapsed <em>Options</em> section at the bottom.</li></ul></li></ul><p>To export a note, right click the note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Export</em>. Similarly, in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> there is a <em>Export note</em> option.</p><h2>Supported formats</h2><p>Trilium natively supports the following formats for both import and export.</p><ul><li>HTML:<ul><li>This is the main format used by Trilium, where standard tags are used to represent basic formatting and layout (e.g. <code><strong></code>, <code><table></code>, <code><pre></code>).</li><li>Note that HTML is not a standardized format so some more specific features such as admonitions or <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> might not be supported by other applications.</li><li>The notes can also be exported as <a href=\"#root/_help_ycBFjKrrwE9p\">static HTML that can be used for web publishing</a>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a><ul><li>Most of the formatting is preserved, see <a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>.</li></ul></li><li>OPML (Outliner Interchange Format)<ul><li>Supports both OPML v1.0 for plain text and v2.0 with HTML support.</li></ul></li></ul><p>To import from other applications such as OneNote, Notion and others, see <a class=\"reference-link\" href=\"#root/_help_ckZ2uNWQmVeX\">Importing data from other applications</a>.</p><h2>Maximum import size</h2><p>Versions prior to v0.104.0 had an upload limit of 250 MiB that could be bypassed via a <code>TRILIUM_NO_UPLOAD_LIMIT</code> environment variable; with v0.104.0 this limit was removed.</p><p>Nevertheless, there is still a limit for the maximum size of a <strong>single item</strong> (whether it's a <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>, an <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> or even a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note). The limit is approximately 374 MiB and it's determined by the <a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a> protocol. Attempts to import such large files will be refused.</p><p>During large imports or exports, memory consumption might spike but it will remain somewhere around the 2 gigabyte mark. Tested with a 2.4 GB database with ~21k notes.</p><aside class=\"admonition important\"><p>For the <a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a>, there are two distinct import mechanisms:</p><ul><li>A quick import, from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>The import dialog (via right click in the note tree → <em>Import into note</em> or from <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>).</li></ul><p>When dealing with large files (multi-gigabyte), prefer using the import dialog as it has a special mechanism which makes sure that the file is read directly from disk rather than uploaded again.</p></aside><h2>Exporting the root note</h2><p>The root note is the top-most note. Exporting it behaves just like any other note: right click on it in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Export</em>.</p><p>Starting with v0.104.0, when a root note is imported, it will be imported as a child of your existing root note. This behavior makes sure that the import cannot change or overwrite your existing notes.</p><p>You can easily move the notes onto the root using the tree's <a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a> and delete the redundant root note.</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Before</th><th scope=\"col\">After</th></tr></thead><tbody><tr><td><ul><li>root<ul><li>one</li><li>two</li></ul></li></ul></td><td><ul><li>root (existing)<ul><li>root (from import)<ul><li>one</li><li>two</li></ul></li></ul></li></ul></td></tr></tbody></table></figure><aside class=\"admonition tip\"><p>Instead of exporting full ZIPs (including the root note), consider using <a href=\"#root/_help_ODY7qQn5m2FT\">backups</a> instead. Backups always contain the entire structure, as well as additional information a ZIP export does not have: maintains note IDs, contains the options/tokens and handle <a class=\"reference-link\" href=\"#root/_help_bwg0e8ewQMak\">Protected Notes</a> better.</p></aside><h2>Exporting the User Guide</h2><p>The in-app User Guide can be exported like any other note: right click one of its pages or chapters in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Export</em>, or use <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Export note</em>.</p><ul><li>Exporting a chapter with <em>This note & all descendants</em> writes the pictures and files of each page as its attachments. Importing that archive creates an ordinary copy that you can edit, with its pictures and the links between its pages working.</li><li>Exporting a single page with <em>Only this note</em> embeds its pictures in the exported file.</li></ul>",
"_help_Oau6X9rCuegd": "<p>Trilium supports Markdown for both import and export, while trying to keep compatibility as high as possible.</p><h2>Import</h2><h3>Clipboard import</h3><p>If you want to import just a chunk of markdown from clipboard, you can do it from editor block menu:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-inline-import.gif\"></p><h3>File import</h3><p>You can also import Markdown files from files:</p><ul><li>single markdown file (with .md extension)</li><li>whole tree of markdown files (packaged into <a href=\"https://en.wikipedia.org/wiki/Tar_(computing)\">.zip</a> archive)<ul><li>Markdown files need to be packaged into ZIP archive because browser can't read directories, only single files.</li><li>You can use e.g. <a href=\"https://www.7-zip.org\">7-zip</a> to package directory of markdown files into the ZIP file</li></ul></li></ul><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-file-import.gif\"></p><h2>Export</h2><h3>Subtree export</h3><p>You can export whole subtree to ZIP archive which will have directory structured modelled after subtree structure:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-export-subtree.gif\"></p><h3>Single note export</h3><p>If you want to export just single note without its subtree, you can do it from Note actions menu:</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Import%20%26%20Export/Markdown_markdown-export-note.gif\"></p><h3>Exporting protected notes</h3><p>If you want to export protected notes, enter a protected session first! This will export the notes in an unencrypted form, so if you reimport into Trilium, make sure to re-protect these notes.</p><h2>Supported syntax</h2><p>See the dedicated page: <a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a></p>",
"_help_rJ9grSgoExl9": "<p><a href=\"https://github.github.com/gfm/\">GitHub-Flavored Markdown</a> is the main syntax that Trilium is following.</p><h2>Images</h2><p>When exporting, images are usually kept in the basic Markdown syntax but will use the HTML syntax if the image has a custom width. Figures are always embedded as HTML.</p><h2>Tables</h2><p>Simple tables are supported with the Markdown syntax. If the table is too complex or contains elements that would render as HTML, the table is also rendered as HTML.</p><h2>Links</h2><p>Standard Markdown links are supported.</p><p>Trilium internal links (that mirror a note's title and display its icon) are embedded as HTML in order to preserve the information on import.</p><p><a class=\"reference-link\" href=\"#root/_help_oSuaNgyyKnhu\">Anchors</a> are kept as HTML as well, so links to an anchor still lead to it after the note is imported again.</p><h2>Math equations</h2><p>Both inline and display equations are supported, using the <code>$</code> and <code>$$</code> syntaxes.</p><h2>Admonitions</h2><p>The Markdown syntax for admonitions as supported by Trilium is the one that GitHub uses, which is as follows:</p><pre><code class=\"language-text-x-trilium-auto\">> [!NOTE]\n> This is a note.\n\n> [!TIP]\n> This is a tip.\n\n> [!IMPORTANT]\n> This is a very important information.\n\n> [!CAUTION]\n> This is a caution.</code></pre><p>There are currently no plans of supporting alternative admonition syntaxes such as <code>!!! note</code>.</p><h2>Tabs</h2><p>Tabs use the syntax of <a href=\"https://squidfunk.github.io/mkdocs-material/reference/content-tabs/\">Material for MkDocs</a>: each tab starts with a <code>=== \"Title\"</code> line, followed by its content indented by four spaces. Consecutive tabs form one tabs block, and <code>===!</code> starts a new block right after another one:</p><pre><code class=\"language-text-x-trilium-auto\">=== \"Windows\"\n\n Run the **installer**.\n\n=== \"Linux\"\n\n Use the package.\n\n===! \"Another block\"\n\n This tab starts a separate tabs block.</code></pre><p>Tabs can be nested by indenting the inner tabs inside the content of a tab. A tab title is plain text, so its formatting is not kept on export. For how tabs blocks work in a text note, see <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a>.</p><h2>Wikilinks</h2><p>Basic support for wikilinks has been added in v0.96.0:</p><ul><li><code>[[foo/bar]]</code> will look for the <code>bar.md</code> file in the <code>foo</code> directory and turn it into an internal link.</li><li><code>![[foo/baz.png]]</code> will look for the <code>baz.png</code> file in the <code>foo</code> directory and turn it into an image.</li></ul><p>This feature is import-only, which means that it will turn wikilinks into Trilium-compatible syntax, but it will not export Trilium Notes into Markdown files with this syntax.</p><aside class=\"admonition important\"><p>The path to pages in wikilinks is resolved relatively to the <em>import root</em> and not the current directory of the note. This is to be inline with other platforms that use wikilinks such as SilverBullet.</p><p>The root path of the import is determined as follows:</p><ul><li>If there is a single directory within the archive at root level, then that directory is considered the root.</li><li>If there are multiple files & directories at root level, then the archive root (containing all of these items) is considered the root.</li></ul></aside><h2>Highlights</h2><p>Background highlights are supported in two ways:</p><ul><li><p>The Markdown <code>==</code> extension which is supported by other Markdown-based applications such as Obsidian:</p><pre><code class=\"language-text-x-trilium-auto\">==highlighted==</code></pre></li><li><p>The canonical HTML representation of highlights, as supported by Trilium:</p><pre><code class=\"language-text-html\"><span style=\"background-color:hsl(0,0%,100%);\">Highlighted</span></code></pre></li></ul><p>When the yellow highlight is used, import/export prefers the <code>==</code> syntax whereas the canonical HTML reprepresentation is used otherwise.</p>",
"_help_ckZ2uNWQmVeX": "<p>Starting with version v0.104.0, Trilium's importer was expanded to application-specific imports. Unlike the standard HTML or <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a> import/export, these importers are tailored to support the features and note structure of a particular application.</p><h2>Supported applications</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a>, by connecting to your account using Microsoft Graph.</li><li><a class=\"reference-link\" href=\"#root/_help_Y5mKeJ6dsCld\">Notion</a>, via a ZIP export.</li><li><a class=\"reference-link\" href=\"#root/_help_nhQVuO4zvIxi\">Google Keep</a>, via a ZIP export from <em>Google Takeout</em> (Keep has no dedicated export mechanism).</li><li><a class=\"reference-link\" href=\"#root/_help_syuSEKf2rUGr\">Evernote</a>, via an ENEX export.</li><li><a class=\"reference-link\" href=\"#root/_help_83zmPBJRgfnW\">Anytype</a>, via a JSON export.</li><li><a class=\"reference-link\" href=\"#root/_help_iWD7wiIuMtgV\">Obsidian</a>, via a ZIP of the vault.</li></ul><h2>Importing data from another application</h2><p>To import from an application, there are two ways to access the import dialog:</p><ul><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click on a note and select <em>Import into note</em>.</li><li>In the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, select <em>Import files</em>.</li></ul><p>A list of supported applications will appear at the top, each with their own configuration. Simply click one and proceed with the on-screen instructions.</p><h2>Acknowledgement</h2><ul><li>Trilium's importer is inspired by Obsidian's <a href=\"https://github.com/obsidianmd/obsidian-importer\">Importer plugin</a> (licensed under the MIT license), for example regarding the OneNote connection process or the Notion ID management.</li></ul>",
"_help_GnhlmrATVqcH": "<p>Trilium allows importing from OneNote. Currently the only mechanism supported is via the Microsoft Graph API which requires you to authenticate in a browser in order for the notes to be obtained by Trilium.</p><h2>Import process</h2><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-onenote\"></span> <em>OneNote</em>.</li><li>Press the <em>Connect</em> button:<ol><li>On the desktop app, you will be redirected to Microsoft's authentication screen where you can log into your account.</li><li>On the web app, the process is slightly more involved as it requires copying the code to clipboard, accessing the link, pasting the code and then signing in once more.</li></ol></li><li>After the connection is successful, you should be able to see a list of sections that can be imported. Simply check the ones to import and press the <em>Import selected</em> button.</li><li>Wait for the import to finish.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, subscript, super script, font sizes, headings, colors, highlights).<ul><li>Black-colored text is intentionally stripped to allow it to work in dark themes.</li></ul></li><li>Inline code is automatically detected and formatted. Paragraphs that use the Code style are also converted to <a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.<ul><li>Unfortunately the indentation of the code might be lost because the information is simply not present in the data from the Microsoft API.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a> with different bullet types.</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a><ul><li>Cell backgrounds are preserved, including a best-effort hue correction because the colors returned by the Graph API are sometimes incorrect.</li><li>Cell widths are also preserved proportionally, with the only difference that tables in Trilium have a percentage-based width, not fixed pixel sizes.</li></ul></li><li>Images and <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.<ul><li>Screen clippings are also properly supported since v0.104.1, displaying their timestamp as a figure caption.</li></ul></li><li>To-do lists</li><li>Hand-drawing is preserved and displayed as an SVG image inside the note<ul><li>OneNote's default color (black) is special since it also renders as white for dark themes. Since v0.104.1, this is also supported by using a special SVG tweak which reacts to light/dark themes.</li></ul></li><li>Links between other imported pages are converted to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> if the text of the link matches the name of the page, or plain links otherwise. If the pages are not part of the import, the original <code>onenote:</code> link is kept.</li><li>Tags (apart from to-do lists) are preserved by converting them to <a href=\"#root/_help_hD8GawVuazff\">inline icons</a>, which are searchable by the icon's name and can be recolored like any other icon. Some icons are turned into emojis instead.</li></ul><p>Regarding the note structure:</p><ul><li>The order of the pages within a section is maintained.</li><li>Sub-pages and section groups are maintained by nesting notes in a hierarchical structure.</li><li>Creation and modification of both notes and sections is preserved. The order of section or section groups is not preserved (see limitations).</li></ul><h2>Error management and reporting</h2><p>The OneNote importer uses Microsoft's Graph API which handles the HTML export (that we later post-process for Trilium use). The Graph API itself has to process the OneNote pages before sending them to us, and as such it's a time-consuming operation that is directly proportional to the number of notes and the complexity/size of the notes.</p><p>The Graph API throttles access if it detects too many operations. The importer takes that into account, but sometimes this means that most of the time is spent waiting for the Graph API to unblock access rather than actually importing data.</p><p>In addition, some pages may fail at the Graph API level due to an internal timeout on their side or other issues. Trilium will try to refetch pages in order to avoid that but sometimes pages cannot be retrieved even after multiple retries. In that case, the importer will still create a corresponding note in Trilium but with an error report instead of a content. This preserves <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> and makes it easy to identify and manually fix the pages that failed.</p><p>At the end of the import, the top-level note called <em>OneNote</em> <em>import</em> will contain information about how the import went:</p><ul><li>The number of notes imported;</li><li>The success rate;</li><li>A list of notes that could not be imported, as well as the failure reason;</li><li>Pages whose images/attachments failed to download</li><li>How long the import spent waiting out throttling.</li></ul><p>To avoid cases in which the import is fundamentally broken (e.g. an expired sign-in), the import will error out if it fails to import 6 pages in a row.</p><h2>Attributes</h2><p>Pages imported from OneNote have a few built-in <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>:</p><ul><li><code>oneNotePageId</code>, with the corresponding page ID in OneNote. This can be used to identify the original OneNote page. Trilium doesn't use it in any way at this moment.</li><li><code>oneNoteImportFailed</code> attached to notes that couldn't be imported. This can be used to quickly <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> for failed notes.</li></ul><h2>Limitations</h2><h3>Regarding OneNote's freehand structure</h3><p>OneNote is fundamentally different to Trilium in structure because it allows freehand drawing to coexist with text, and text boxes can be placed anywhere in the document (e.g. a common use case is to have columns). Trilium has a document flow mechanism for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes which means that it can't be freely positioned.</p><p>To cope with this difference, Trilium will flatten the text structure into normal paragraphs. The paragraphs will be ordered visually based on the original position of the text boxes, but their horizontal position will not be preserved. Parallel text such as columns may appear interleaved which can cause problems.</p><p>In addition, drawing in OneNote can be interleaved with text boxes. Text notes in Trilium do not allow for this feature, so all drawing will appear at the end. For some use cases (diagrams, for example) this will work fine, but if you have highlights or other text-dependent drawings they will appear out of order.</p><aside class=\"admonition note\"><p>There are plans to support drawing-heavy notes that interleave with text boxes by converting them to a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> instead.</p></aside><h3>Password-protected sections</h3><p>OneNote supports encryption at section level; when importing a notebook that contains these password-protection sections, Trilium will not be able to read the content of password-protected sections so they will appear empty. This is not a limitation of Trilium, the information is simply not available from the source (Graph API).</p><p>The section itself is kept for reference and all the sections that could not be imported will be shown in the report (the top-level note called <em>OneNote import</em>).</p><p>To unprotect a section in OneNote Desktop, right click on the protected section → <em>Password Protect This Section</em> and press <em>Remove Password</em> and sync. Then re-import either only the protected sections or remove everything and start the import from scratch.</p><h2>Other limitations</h2><p>The following are known limitations due to how the information comes from the import (Microsoft Graph API), which means that they cannot be fixed.</p><ul><li>The order of the sections (and section groups) is not available, the sections are ordered by creation date instead.</li><li>Revision history.</li><li>Paragraph indentation, as well as code block indentation.</li><li>Section colors.</li><li>Drawings inside titles, the title might appear incomplete or “Untitled”.</li></ul><h2>Reporting issues</h2><p>When importing notes, you might find that some text is not rendered properly or the structure is not properly maintained. As long as this issue is not a fundamental issue (like the issue with freehand text not being preserved exactly), it's a good idea to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a>.</p><p>When reporting, make sure that you provide the following information:</p><ul><li>Import again the section, checking the debug checkbox before importing. This preserves the original document (and the hand-drawing data if any) as it came through from OneNote's cloud API so that it can be used for comparison.</li><li>Export only the affected page as ZIP, making sure not to accidentally expose any sensitive information.</li><li>Take screenshots of how the note looked like in OneNote and how it ends up in Trilium.</li><li>Attach the ZIP and the screenshots to the issue report.</li></ul>",
"_help_LpvyEIBIAAj7": "<p>OneNote's <em>Tags</em> functionality is imported in Trilium as <a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a> using the default icon pack or emojis (if there is no suitable replacement).</p><aside class=\"admonition important\"><p>Custom tags are not supported by OneNote's Graph API so Trilium cannot import them.</p></aside><h3>Decorative tags</h3><p>These remain formatted as paragraphs, with the glyph prepended to the text. A paragraph can carry several tags at once, in which case their glyphs stack.</p><figure class=\"table\"><table><thead><tr><th>OneNote tag</th><th><code>data-tag</code></th><th>Imported as</th><th>Searchable as</th></tr></thead><tbody><tr><td>Important</td><td><code>important</code></td><td><span class=\"tn-icon bx bx-star\"></span></td><td><code>star</code></td></tr><tr><td>Critical</td><td><code>critical</code></td><td><span class=\"tn-icon bx bx-error-circle\"></span></td><td><code>error-circle</code></td></tr><tr><td>Question</td><td><code>question</code></td><td><span class=\"tn-icon bx bx-help-circle\"></span></td><td><code>help-circle</code></td></tr><tr><td>Highlight</td><td><code>highlight</code></td><td><span class=\"tn-icon bx bx-highlight\"></span></td><td><code>highlight</code></td></tr><tr><td>Definition</td><td><code>remember-for-later</code></td><td><span class=\"tn-icon bx bx-pin\"></span></td><td><code>pin</code></td></tr><tr><td>Remember for later</td><td><code>remember-for-later</code></td><td><span class=\"tn-icon bx bx-pin\"></span></td><td><code>pin</code></td></tr><tr><td>Remember for blog</td><td><code>remember-for-blog</code></td><td><span class=\"tn-icon bx bx-edit\"></span></td><td><code>edit</code></td></tr><tr><td>Idea</td><td><code>idea</code></td><td><span class=\"tn-icon bx bx-bulb\"></span></td><td><code>bulb</code></td></tr><tr><td>Password</td><td><code>password</code></td><td><span class=\"tn-icon bx bx-key\"></span></td><td><code>key</code></td></tr><tr><td>Contact</td><td><code>contact</code></td><td><span class=\"tn-icon bx bx-user\"></span></td><td><code>user</code></td></tr><tr><td>Address</td><td><code>address</code></td><td><span class=\"tn-icon bx bx-home\"></span></td><td><code>home</code></td></tr><tr><td>Phone number</td><td><code>phone-number</code></td><td><span class=\"tn-icon bx bx-phone\"></span></td><td><code>phone</code></td></tr><tr><td>Web site to visit</td><td><code>web-site-to-visit</code></td><td><span class=\"tn-icon bx bx-globe\"></span></td><td><code>globe</code></td></tr><tr><td>Source for article</td><td><code>source-for-article</code></td><td><span class=\"tn-icon bx bx-news\"></span></td><td><code>news</code></td></tr><tr><td>Send in email</td><td><code>send-in-email</code></td><td><span class=\"tn-icon bx bx-envelope\"></span></td><td><code>envelope</code></td></tr><tr><td>Movie to see</td><td><code>movie-to-see</code></td><td><span class=\"tn-icon bx bx-movie\"></span></td><td><code>movie</code></td></tr><tr><td>Book to read</td><td><code>book-to-read</code></td><td><span class=\"tn-icon bx bx-book\"></span></td><td><code>book</code></td></tr><tr><td>Music to listen to</td><td><code>music-to-listen-to</code></td><td><span class=\"tn-icon bx bx-music\"></span></td><td><code>music</code></td></tr><tr><td>Project A</td><td><code>project-a</code></td><td>🅰️</td><td>🅰️</td></tr><tr><td>Project B</td><td><code>project-b</code></td><td>🅱️</td><td>🅱️</td></tr></tbody></table></figure><h3>Check box tags</h3><p>These become <a class=\"reference-link\" href=\"#root/_help_fASfBrYnquKU\">To-do Lists</a>, with the glyph inside the item with the tick state preserved:</p><figure class=\"table\"><table><thead><tr><th>OneNote tag</th><th><code>data-tag</code></th><th>Imported as</th><th>Searchable as</th></tr></thead><tbody><tr><td>To Do</td><td><code>to-do</code></td><td><em>(none)</em></td><td>—</td></tr><tr><td>To Do priority 1</td><td><code>to-do-priority-1</code></td><td>1️⃣</td><td>1️⃣</td></tr><tr><td>To Do priority 2</td><td><code>to-do-priority-2</code></td><td>2️⃣</td><td>2️⃣</td></tr><tr><td>Discuss with Person A</td><td><code>discuss-with-person-a</code></td><td><span class=\"tn-icon bx bx-message-rounded\"></span></td><td><code>message-rounded</code></td></tr><tr><td>Discuss with Person B</td><td><code>discuss-with-person-b</code></td><td><span class=\"tn-icon bx bx-message-rounded\"></span></td><td><code>message-rounded</code></td></tr><tr><td>Discuss with manager</td><td><code>discuss-with-manager</code></td><td><span class=\"tn-icon bx bx-conversation\"></span></td><td><code>conversation</code></td></tr><tr><td>Schedule meeting</td><td><code>schedule-meeting</code></td><td><span class=\"tn-icon bx bx-calendar\"></span></td><td><code>calendar</code></td></tr><tr><td>Call back</td><td><code>call-back</code></td><td><span class=\"tn-icon bx bx-phone-call\"></span></td><td><code>phone-call</code></td></tr><tr><td>Client request</td><td><code>client-request</code></td><td><span class=\"tn-icon bx bx-clipboard\"></span></td><td><code>clipboard</code></td></tr></tbody></table></figure>",
"_help_Y5mKeJ6dsCld": "<p>Trilium can import ZIP exports from Notion while preserving structure and formatting.</p><h2>Import process</h2><p>In Notion, there are two ways to export data:</p><ul><li>To export a single page (and optionally its sub-pages):<ul><li>Select the page to export.</li><li>Press the […] button at the top-right of the window and select <em>Export</em>.</li><li>Ensure the following options are set:<ul><li>Export format: HTML</li><li>Page content: Everything</li><li>Include subpages: On</li><li>Create folders for subpages: On</li></ul></li><li>Press the Export button.</li><li>Wait for the download to finish.</li></ul></li><li>To export an entire workspace, press your user name badge at top-left and select <em>Settings</em>.<ul><li>In the left section, look for the <em>Workspace</em> category and select <em>General</em>.</li><li>In the <em>General</em> settings page, look for the <em>Export</em> section and press the <em>Export</em> button corresponding to <em>Workspace content</em>.</li><li>Ensure the following options are set:<ul><li>Export format: HTML</li><li>Page content: Everything</li><li>Include subpages: On</li><li>Create folders for subpages: On</li></ul></li><li>Press the Export button.</li><li>Wait for the download to finish. Depending on the size of your workspace it might take a while. You will get a downloadable copy via email if takes too long.</li></ul></li></ul><p>In Trilium Notes:</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em> (<span class=\"tn-icon bx bx-import\"></span>).</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-notion\"></span> <em>Notion</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, headings, colors, highlights).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> and <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Toggle sections<ul><li>Nested toggle sections are also supported.</li><li>Toggle headings are stripped of their toggle button and become normal headings instead.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> (inline or block)</li><li><a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a><ul><li>The icon and image of the links need to be retrieved online since the exports don't carry the images. This operation is done only if <em>Download images automatically</em> is enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li>Links between other imported pages are converted to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> if they are part of the same import.</li><li>Databases are imported as <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> (see below).</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li>Columns are imported as transparent <a href=\"#root/_help_NdowYOC1GFKS\">tables</a>, preserving the column definition.</li><li>Table of content blocks are <em>removed</em>, as the table of contents is already present in the sidebar (see <a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a>), as well as in shared notes.</li></ul><h2>Databases</h2><p>Notion databases are imported into <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>, where each item of the database is saved as a page in the collection. Through the use of <a href=\"#root/_help_bwZpz2ajCEwO\">inherited</a> <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>, most of the page properties in Notion are preserved by the import.</p><p>The resulting collection will be <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> regardless of the original view the database was exported in. That's because the active view is not saved in the export and the table collection is the most compatible with Notion.</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Notion type</th><th scope=\"col\">Trilium</th></tr></thead><tbody><tr><td>Text / Select / Status / Place</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label for plain numbers. Formatted values (currency, percent, thousands separators) are normalized to a bare number, e.g. <code>$1,200.50</code> → <code>1200.50</code>.</td></tr><tr><td>ID</td><td>Single-valued <code>number</code> or <code>text</code> label (depending on whether a prefix is configured)</td></tr><tr><td>Multi-select</td><td>One text label per option (multi)</td></tr><tr><td>URL / Email / Phone</td><td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td></tr><tr><td>Date</td><td><ul><li><code>datetime</code> if at least one has time.</li><li><code>date</code> if only dates.</li><li>Two attributes if any of the dates have an end date.</li></ul></td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>Person</td><td>One text label per user (multi)</td></tr><tr><td>Created by / Edited by</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Created time / Last edited time</td><td>Assigned to the note's creation and modification date.</td></tr><tr><td>Relation</td><td>Mapped to <a href=\"#root/_help_Cq5X6iKQop6R\">relations</a>, each link resolved to its target note via the existing cross-page map; targets outside the import are dropped.</td></tr><tr><td>Files & Media</td><td>The files are preserved as attachments, and a link to them is prepended to the content of the note for visibility.</td></tr><tr><td>Formulas / Rollup</td><td><p>A <code>text</code>, <code>number</code> or <code>boolean</code> label depending on the value. Dates are rendered as <code>text</code> because the export doesn't offer any type information.</p><p>The Notion export does not preserve the formula/rollup configuration itself, instead it just exports the value.</p></td></tr><tr><td>Button / Verification / any other type</td><td>Unsupported, they will be dropped from the import.</td></tr></tbody></table></figure><aside class=\"admonition note\"><p><strong>Technical information</strong></p><p>Every page property that can be preserved according to the table above is saved as a label or relation to the corresponding note (except for creation and modification dates which are saved at note level).</p><p>To maintain a similar UX to Notion, every property is also turned into <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> at collection level. This also makes the columns visible in the table collection. The promoted attributes are made inheritable so that they appear when navigating in the child notes as well.</p><p>The names of the labels are intentionally converted to <code>camelCase</code> to match Trilium's conventions, but the full name of the column is preserved through the <em>Alias</em> mechanism of promoted attributes.</p></aside><h2>Limitations</h2><h3>Missing data from the import</h3><p>The following information is not preserved by the import because it is not available in the export so it cannot be restored:</p><ul><li>The order of the pages and sub-pages.</li><li>Creation/modification dates are restored only when the page includes Created time / Last edited time properties (collection or not); otherwise the import time is used.</li></ul><h3>Cover images and page icon</h3><p>The page icon or emoji is not preserved, with created notes having the default icon. The cover image is not imported at all.</p><h2>Reporting issues</h2><p>When importing your Notion workspace, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A .zip export of the original Notion note (and children if applicable). This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
"_help_nhQVuO4zvIxi": "<p>Trilium can import notes from Google Keep, preserving their structure and formatting.</p><h2>Import process</h2><p>Google Keep has no native export process, but Google Takeout allows you to download a ZIP of all the notes.</p><p>The first step is to download your Google Keep information:</p><ol><li>Navigate to <a href=\"https://takeout.google.com/\">takeout.google.com</a>.</li><li>In the <em>Create a new export</em> section, press <em>Deselect all.</em></li><li>In the list of data to export, check <em>Keep</em>.</li><li>Scroll all the way down and choose <em>Next step</em>.</li><li>In <em>Choose file type, frequency & destination</em> make sure the following options are set:<ol><li><em>Transfer to</em> is set to <em>Send download link via email</em>.</li><li><em>Frequency</em> is set to <em>Export once</em>.</li><li><em>File type</em> is set to <em>.zip</em>.</li><li><em>File size</em> can remain set to <em>2 GB</em>.</li></ol></li><li>Press <em>Create export</em> and wait for the export to finish.</li></ol><p>Then in Trilium Notes:</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-google-keep\"></span> <em>Google Keep</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><h2>Supported features</h2><ul><li>Basic formatting (bold, italic, underline)</li><li><a href=\"#root/_help_p9kXRFAkwN4o\">Note color</a></li><li>Note titles are maintained, if present.<ul><li>In Google Keep it's common for notes not to have a title, case in which the date and time of the note are used as a title.</li></ul></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> and <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Creation and modification dates are preserved.</li></ul><h2>Limitations</h2><p>Currently the following information is not imported:</p><ul><li>Labels are disregarded.</li><li>Pinned, archived or trashed state is not preserved, all notes are treated the same.</li></ul><h2>Reporting issues</h2><p>When importing your notes from Google Keep, you might encounter some issues with how the notes are imported, or there might be some missing information. In this case, consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting it</a>.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A sample of the note is required to better understand what happened.<ul><li>Because Google Keep has no per-note export, extract the Google Takeout ZIP and copy the files corresponding to the problematic note (<code>.html</code>, <code>.json</code> and any attachments if you are able to identify them).</li></ul></li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
"_help_syuSEKf2rUGr": "<p>Trilium can import ENEX files, which are used by Evernote for backup/export. One ENEX file represents the content (notes and resources) of one notebook.</p><h2>Import process</h2><p>The first step is to export the data from Evernote:</p><ul><li>To export a single notebook:<ul><li>In the left sidebar, select <em>Notebooks</em>.</li><li>If you have a notebook stack, expand it.</li><li>Right click on a notebook and select <em>Export notebook</em>.</li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li><li>To export a bunch of notes (up to 100 notes):<ul><li>In the left sidebar, select <em>Notes</em>.</li><li>In the list of notes, <kbd>Ctrl</kbd>-click individual notes to select them. Alternatively, click on a note and then <kbd>Shift</kbd>-click a more distant note to select all the notes in between.</li><li>At the bottom there should be a floating bar with some options. Select […] → <em>Export.</em></li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li><li>To export a single note:<ul><li>Select the note.</li><li>In the top-right, press the […] button and select <em>Export</em>.</li><li>Make sure the following options are set:<ul><li>File format is set to <em>ENEX format</em>.</li><li>All the options in <em>Export note attributes</em> are checked.</li></ul></li></ul></li></ul><aside class=\"admonition tip\"><p>To export multiple notebooks in bulk, consider using a third-party CLI tool called <a href=\"https://github.com/vzhd1701/evernote-backup\">evernote-backup</a></p></aside><p>Once you have your ENEX files, do the following to import them in Trilium:</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-evernote\"></span> <em>Evernote</em>.</li><li>During the import, you will see \"Import in progress\" message. If the import is successful, the message will change to “Import finished successfully” and then disappear.</li><li>We recommend you to check the imported notes and their attachments to verify that you haven’t lost any data.</li></ol><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, colors, highlights, superscript, subscript, text alignment, inline code).</li><li>The hierarchy of headings (these are shifted to start with H2 because H1 is reserved for note title, see <a href=\"#root/_help_Gr6xFaF6ioJ5\">Headings</a>)</li><li>To-do lists. The new task format is collapsed to standard to-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> and <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a></li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a> (with bullets or with numbers)</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></li><li>Block quotes</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Toggle sections</li><li>External links</li><li>Internal links are re-written to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> if the target note is part of the same import.</li></ul><h2>Limitations</h2><ul><li>The size limit of one import is 250Mb. If the total size of your files is larger, you can increase the <a href=\"#root/_help_WOcw2SLH6tbX\">upload limit</a>, or divide your files, and run the import as many times as necessary.</li><li>All resources (except for images) are created as notes’ attachments.</li><li>If you have HTML inside ENEX files, the HTML formatting may be broken or lost after import in Trilium. See <a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</li></ul><h3>Links to other notes</h3><p>Since v0.104.0, the ENEX importer tries to recreate links to other notes automatically by converting their Evernote-specific URLs to Trilium's <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</p><p>Since the ENEX format does not provide the unique ID of notes, the note references are determined via their note title.</p><p>Limitations:</p><ul><li>Only notes that are part of the same import will have their links rewritten to reference links, to avoid linking to the wrong note.</li><li>If there are to notes with the same name, internal links will not be created to avoid pointing to the wrong note.</li><li>Links that couldn't be rewritten (e.g. referring to a missing/duplicate note) will be kept with their original <code>evernote://</code> URL.</li><li>It will not fix links to anchors and links to notes that you renamed in Evernote after you created the links.</li></ul><h4>Post-processing notes</h4><aside class=\"admonition tip\"><p>This script allows rewriting links after the import has been done, and it should also allow finding links between two different imports.</p></aside><p>If you want to restore the internal links in Trilium after you import all of your ENEX files, you can use or adapt this custom script: <a class=\"reference-link\" href=\"#root/_help_dj3j8dG4th4l\">Process internal links by title</a></p><p>The script does the following:</p><ol><li>It finds all Evernote internal links.</li><li>For each one, it checks if its link text matches a note title, and if yes, it replaces the Evernote link with an internal Trilium link. If not, it leaves the Evernote link in place.</li><li>If it finds more than one note with a matching note title, it leaves the Evernote link in place.</li><li>It outputs the results in a log that you can see in the respective code note in Trilium.</li></ol><p>The script has the following limitations:</p><ul><li>It will not fix links to anchors and links to notes that you renamed in Evernote after you created the links.</li><li>Some note titles might not be well identified, even if they exist. This is especially the case if the note title contains some special characters. Should this be problematic, consider <a class=\"reference-link\" href=\"#root/_help_wy8So3yZZlH9\">Reporting issues</a>.</li></ul><h2>Reporting issues</h2><p>When importing your Evernote notebooks, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A <code>.enex</code> export of the original note. This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
"_help_dj3j8dG4th4l": "const query = `note.type = \"text\" and note.content *=* \"evernote:///view/\"`;\nconst notes = api.searchForNotes(query);\n\nfor (const note of notes) {\n api.log(`Processing note ${note.title}...`);\n \n const content = note.getContent();\n const root = api.htmlParser.parse(content);\n \n for (const el of root.querySelectorAll(\"a\")) {\n const url = el.getAttribute(\"href\");\n if (!url?.startsWith(\"evernote:///\")) continue;\n\n const text = el.textContent;\n const matchingNotes = api.searchForNotes(`note.title = \"${text}\"`);\n if (matchingNotes.length === 0) {\n api.log(`No matching notes for \"${text}...\"`);\n continue;\n }\n\n if (matchingNotes.length > 1) {\n api.log(`Found multiple matching notes for \"${text}\". Skipping.`);\n continue;\n }\n\n const matchingNote = matchingNotes[0];\n \n api.log(`Found matching note: ${matchingNote.title} ${matchingNote.noteId}`);\n el.setAttribute(\"href\", `#root/${matchingNote.noteId}`);\n el.classList.add(\"reference-link\");\n }\n note.setContent(root.toString()); \n}\n",
"_help_83zmPBJRgfnW": "<p>Starting with v0.104.0, Trilium is able to import data from Anytype from JSON imports which preserve most of the formatting and the metainformation.</p><h2>Import process</h2><p>The first step is to export the data from Anytype:</p><ul><li>To export a single page:<ul><li>Select the page to export.</li><li>Press the […] at the top-right of the window and select <em>Export</em>.</li><li>Ensure the following options are set:<ul><li>Export format: Any-Block</li><li>File Format: JSON</li><li>Zip archive: On</li><li>Include linked objects: On</li><li>Include files: On</li><li>Include archived objects: On</li></ul></li></ul></li><li>To export an entire channel:<ul><li>Select the desired channel from the left bar.</li><li>Underneath the channel icon in the left sidebar, press the name of the channel with an arrow and select <em>Channel Settings</em>.</li><li>In the left sidebar, look for the <em>Integrations</em> section and select <em>Export</em>.</li><li>Press <em>Any-Block</em>.</li><li>Ensure the following options are set:<ul><li>File Format: JSON</li><li>Zip archive: On</li><li>Include files: On</li><li>Include archived objects: On</li></ul></li></ul></li></ul><p>In Trilium Notes:</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-anytype\"></span> <em>Anytype</em>.</li><li>Upload the ZIP.</li></ol><aside class=\"admonition note\"><p>Exporting collections individually can sometimes miss information that would otherwise be picked up from an export of the entire channel. The reason is that Anytype leaves out some information when exporting individual pages/collections.</p></aside><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Basic formatting (bold, italic, underline, strikethrough, headings, colors, highlights, inline code).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a> (numbered or bullet)</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> and files are handled as <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>To-do lists</li><li>Toggle sections</li><li><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></li><li>Inline <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Highlight blocks are imported as block quotes.</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li>Links between other imported pages are converted to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> if they are part of the same import.<ul><li>Applies to both block links and inline links.</li></ul></li><li>Collections are imported as Trilium-native <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> (see below).<ul><li>Files inside collections are imported as <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> notes.</li></ul></li><li>Dividers (line, dots) are imported as horizontal rules.</li><li><a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a> are preserved, including its emoji (added as part of the content).</li><li>Creation and modification date of pages is preserved.</li></ul><h2>Collections</h2><p>Collections created in Anytype are imported on a best-effort basis, preserving both the view mode and the page properties as <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><p>The following view modes are supported:</p><ul><li>List as <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a></li><li>Gallery as <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a></li><li><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a>, preserving the attribute which identifies the date.</li><li><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>, preserving the board group column.</li><li><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, also used as fallback for unsupported collection layouts.</li></ul><p>The following types are supported:</p><figure class=\"table\"><table><thead><tr><th scope=\"col\">Anytype property type</th><th scope=\"col\">Trilium</th></tr></thead><tbody><tr><td>Text / Select</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label</td></tr><tr><td>Multi-select</td><td>One <code>text</code> label per option (multi)</td></tr><tr><td>Date / Date with time</td><td><ul><li><code>datetime</code> if the time is included.</li><li><code>date</code> if only dates.</li></ul></td></tr><tr><td>File</td><td>The files are preserved as attachments, and a link to them is prepended to the content of the note for visibility.</td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>URL / Email / Phone</td><td><code>url</code> label (<code>mailto:</code>, <code>tel:</code> prefix)</td></tr></tbody></table></figure><h2>Reporting issues</h2><p>When importing your Anytype notes, you might find issues in how a note is imported; in that case consider <a href=\"#root/_help_wy8So3yZZlH9\">reporting</a> it.</p><p>When reporting such an issue make sure to provide the following information:</p><ul><li>A .zip export of the original note (and children if applicable). This allows us to reproduce the issue.</li><li>A screenshot with how it originally looked like before the import and how it looks after the import.</li></ul>",
"_help_iWD7wiIuMtgV": "<p>Although Obsidian was indirectly supported through the standard <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a> import, its vault structure is distinct enough to warrant its own dedicated import channel.</p><h2>Import process</h2><p>The first step is to obtain a .zip of your Obsidian vault:</p><ol><li>First, identify where your Obsidian vault is located. The easiest way to do so is to open Obsidian and right clicking the name of the vault at the bottom of the left sidebar and then selecting <em>Show in system explorer</em>.</li><li>In your system explorer, right click the directory containing your Obsidian vault and compress it to a ZIP file (e.g. on Windows, <em>Compress To</em> → <em>ZIP</em>).</li></ol><aside class=\"admonition tip\"><p>When zipping, you can either ZIP the outer folder of the vault, or the contents of the vault as Trilium will automatically determine the position of the vault in the archive via the <code>.obsidian</code> directory.</p></aside><p>Then, in Trilium Notes:</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right click and select <em>Import into note</em>.</li><li>In the <em>Import from</em> section, select <span class=\"tn-icon tn-brand tn-brand-obsidian\"></span> <em>Obsidian</em>.</li><li>Upload the ZIP obtained in the previous step.</li></ol><p>Alternatively, simply drag & drop the .zip archive in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and Trilium will auto-detect it as an Obsidian import provided there is a <code>.obsidian</code> directory. If not, follow the previous steps instead.</p><h2>Supported features</h2><p>The following features are preserved by Trilium during the import process:</p><ul><li>Folder hierarchy is preserved.</li><li>Basic Markdown formatting (bold, italic, underline, strikethrough, headings).</li><li>Specific Obsidian formatting (highlighting).</li><li><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></li><li>To-do lists</li><li><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> and <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a><ul><li>Non-Markdown files in the Vault are treated as attachments by default if they are referenced by at least one note.</li><li>Otherwise, they will be imported as <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a> notes.</li></ul></li><li>Transclusions are converted to <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> or <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a> (depending on type).</li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> (inline or block)</li><li><a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, with a best-effort attempt to restore the language.</li><li>Links between pages are converted to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>.</li><li>Callouts are converted to Trilium's <a href=\"#root/_help_NwBbFdNZ9h7O\">Admonitions</a>.<ul><li>Obsidian has many more types of callouts (<code>tldr</code>, <code>question</code>, <code>attention</code>), these are all mapped to one of Trilium's existing admonition types (e.g. Note, Tip, Important).</li><li>Custom titles are kept and shown as a bold line at the top of the admonition, since there is no concept of admonition title in Trilium.</li><li>Foldable callouts are imported expanded and without a fold marker.</li></ul></li><li>Notes created by the <a href=\"https://github.com/zsviczian/obsidian-excalidraw-plugin\"><em>Excalidraw</em></a> community plugin for Obsidian are converted to <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> (same underlying technology).<ul><li>Note that custom features introduced by that plugin will not be supported.</li></ul></li><li>Modification date is preserved via the information obtained from the .zip archive, creation date is not recoverable so it's kept the same as the modification date.</li></ul><h2>Properties</h2><p>Properties are Obsidian's equivalent of <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. One of the core differences between the two is where the property information is stored (i.e. name and type): in Obsidian everything is stored at vault level and shared across all notes, whereas in Trilium each page can have individual promoted attributes, shared through <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> or <a class=\"reference-link\" href=\"#root/_help_bwZpz2ajCEwO\">Attribute Inheritance</a>.</p><p>Another important difference is that promoted attributes in Trilium are always displayed, even if empty. In Obsidian, these are simply suggested when creating a new property.</p><p>To reconcile all these differences, properties are converted to <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> at note level.</p><p>The following note types are supported:</p><figure class=\"table\"><table><thead><tr><th>Obsidian type</th><th>Trilium</th></tr></thead><tbody><tr><td>Text or not defined</td><td>Single-valued <code>text</code> label</td></tr><tr><td>Number</td><td>Single-valued <code>number</code> label</td></tr><tr><td>Multitext</td><td>Multi-valued <code>text</code> label</td></tr><tr><td>Checkbox</td><td><code>boolean</code> label (<code>true</code>/<code>false</code>).</td></tr><tr><td>Date</td><td><code>date</code></td></tr><tr><td>Date & Time</td><td><code>datetime</code></td></tr></tbody></table></figure><h3>Special properties</h3><p>Obsidian has a few reserved property names, which are treated differently in Trilium as well:</p><ul><li><code>tags</code>, where every tag is turned into its own <a href=\"#root/_help_HI6GBBIduIgv\">label</a> (e.g. <code>#one</code>, <code>#two</code> when <code>tags: [ one, two ]</code>).</li><li><code>aliases</code> are simply mapped to individual <code>#alias</code> labels</li><li><code>cssclasses</code>, <code>publish</code>, <code>permalink</code> are ignored.</li></ul><h2>Limitations</h2><ul><li>Comments (<code>%%</code> syntax) are simply stripped.</li><li>Obsidian <em>bases</em> functionality is not preserved.<ul><li>The closest equivalent in Trilium would be <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> but they work fundamentally different because bases don't store particular notes, they act more like a <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> with a collection view.</li><li>Since the base query format is quite different to Trilium's <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> syntax, it's unlikely they'll ever be supported.</li><li>When a base is encountered, it is simply ignored from the import.</li></ul></li><li>Canvases are not imported.<ul><li>Theoretically they could map to either <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> or <a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a> but they are too different to reconcile.</li></ul></li><li>Links<ul><li>Links to a specific heading in another note will still point to the right note, but the heading anchor will be dropped.</li><li>Dangling links (pointing to a note that doesn't exist) and ambiguous links (same base name in 2+ notes) are unwrapped to plain text.</li></ul></li></ul>",
"_help_rC3pL2aptaRE": "<p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/2_Zen%20mode_image.png\"></p><p>Screenshot of Zen Mode activated on a Windows 11 system with native title bar off and background effects on.</p><p>When Zen Mode is activated (pictured on the side), most of the user interface of Trilium is hidden away in order to be able to focus on the content, whether it's for reading or writing.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/1_Zen%20mode_image.png\"></p><p>Screenshot of the Zen Mode option in the global menu.</p><h2>Activating & deactivating</h2><p>The Zen Mode can be activated by accessing the global menu and selecting the “Zen mode” option:</p><p>Aside from the global menu, it's also possible to activate this mode by using a keyboard shortcut (which is <kbd>F9</kbd> since TriliumNext 0.92.5 and <kbd>Alt</kbd>+<kbd>Z</kbd> for older versions). Look for <code>toggleZenMode</code> in the shortcut configuration.</p><p>Once Zen Mode is activated, all the UI elements of the application will be hidden away, including the global menu. In that case, the Zen Mode can be deactivated either by pressing the <span class=\"tn-icon bx bxs-yin-yang\"></span> icon in the top-right corner of the window or by pressing the keyboard combination again.</p><p>Do note that, by design, activating or deactivating the Zen Mode applies only to the current window. Restarting the application will also disable the Zen Mode.</p><h2>Moving the window around</h2><p>If “Native title bar” is activated, then the operating system's default title bar can be used to drag the window around. If deactivated, the window can still be moved by dragging the mouse across the top part of the window where the note titles are.</p><p><img src=\"{{helpAssets}}/User%20Guide/Basic%20Concepts%20and%20Features/Zen%20mode_image.png\"></p><p>Screenshot of two notes side-by-side while Zen Mode is active, on Windows 11 with background effects off.</p><h2>Split windows and tabs</h2><p>Tabs are completely hidden, however it's still possible to use keyboard shortcuts such as <code>firstTab</code> (<kbd>Ctrl</kbd>+<kbd>1</kbd> by default), <code>secondTab</code> (<kbd>Ctrl</kbd>+<kbd>2</kbd> by default). There are also some newer shortcuts such as <code>activateNextTab</code> (<kbd>Ctrl</kbd>+<kbd>Tab</kbd>) or <code>activatePreviousTab</code> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Tab</kbd>) that allow easy navigation, however make sure that they are configured properly in the settings.</p><p>For the split view of notes, there are no keyboard shortcuts at the time of writing, but it's still possible to have them in Zen Mode by creating the split while the Zen Mode is off and then reactivating it afterwards.</p>",
"_help_YzMcWlCVeW09": "<p><em>Active content</em> is a generic name for powerful features in Trilium, these range from customizing the UI to advanced scripting that can alter your notes or even your PC.</p><h2>Safe import</h2><p>Active content problem of safety, especially when this active content comes from a third-party such as if it is downloaded from a website and then imported into Trilium.</p><p>When <a href=\"#root/_help_mHbBMPDPkVV5\">importing</a> .zip archives into Trilium, <em>safe mode</em> is active by default which will try to prevent untrusted code from executing. For example, a <a href=\"#root/_help_MgibgPcfeuGz\">custom widget</a> needs the <code>#widget</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> in order to function; safe import works by renaming that label to <code>#disabled:widget</code>.</p><h2>Safe mode</h2><p>Sometimes active content can cause issues with the UI or the server, preventing it from functioning properly. <a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a> allows starting Trilium in such a way that active content is not loaded by default at start-up, allowing the user to fix the problematic scripts or widgets.</p><h2>Types of active content</h2><p>These are the types of active content in Trilium, along with a few examples of what untrusted content of that type could cause:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Disabled on a safe <a href=\"#root/_help_mHbBMPDPkVV5\">import</a></th><th>Description</th><th>Potential risks of untrusted code</th></tr></thead><tbody><tr><td><a href=\"#root/_help_yIhgI5H7A2Sm\">Front-end scripts</a></td><td>Yes</td><td>Allow running arbitrary code on the client (UI) of Trilium, which can alter the user interface.</td><td>A malicious script can execute server-side code, access un-encrypted notes or change their contents.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_MgibgPcfeuGz\">Custom Widgets</a></td><td>Yes</td><td>Can add new UI features to Trilium, for example by adding a new section in the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>.</td><td>The UI can be altered in such a way that it can be used to extract sensitive information or it can simply cause the application to crash.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_SPirpZypehBG\">Backend scripts</a></td><td>Yes</td><td>Can run custom code on the server of Trilium (Node.js environment), with full access to the notes and the database.</td><td>Has access to all the unencrypted notes, but with full access to the database it can completely destroy the data. It also has access to execute other applications or alter the files and folders on the server).</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a></td><td>Yes</td><td>Displays a website inside a note.</td><td>Can point to a phishing website which can collect the data (for example on a log in page).</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></td><td>Yes</td><td>Renders custom content inside a note, such as a dashboard or a new editor that is not officially supported by Trilium.</td><td>Can affect the UI similar to front-end scripts or custom widgets since the scripts are not completely encapsulated, or they can act similar to a web view where they can collect data entered by the user.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a></td><td>No</td><td>Can alter the layout and style of the UI using CSS, applied regardless of theme.</td><td>Generally less problematic than the rest of active content, but a badly written CSS can affect the layout of the application, requiring the use of <a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a> to be able to use the application.</td></tr><tr><td><a href=\"#root/_help_pKK96zzmvBGf\">Custom themes</a></td><td>No</td><td>Can change the style of the entire UI.</td><td>Similar to custom app-wide CSS.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a></td><td>No</td><td>Introduces new icons that can be used for notes.</td><td>Generally are more contained and less prone to cause issues, but they can cause performance issues (for example if the icon pack has millions of icons in it).</td></tr></tbody></table></figure><h2>Active content badge</h2><p>If a note is considered to have active content, a badge is shown in the <a class=\"reference-link\" href=\"#root/_help_B5dihXRDksTk\">Note badges</a> area. Clicking the badge will reveal a menu with various options related to that content type, for example to open the documentation or to configure the execution of scripts.</p><p>For some active content types, such as backend scripts with custom triggering conditions a toggle button will appear. This makes it possible to easily disable scripts or widgets, but also to re-enable them if an import was made with safe mode active.</p>",
"_help_s3YCWHBfmYuM": "<h2>Choose the setup</h2><p><strong>Local only desktop/laptop</strong> - Allows a single instance on a desktop and will save the notes locally on that desktop.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a></li></ul><p><strong>Server with web only access</strong> - Installs the application on the server and allows access from any web browser on any device, including mobile.</p><ol><li><a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a> (optional)</li><li><a class=\"reference-link\" href=\"#root/_help_yeEaYqosGLSh\">Third-party cloud hosting</a></li></ol><p><strong>Combination of server and desktop/laptop</strong> - Install the application on both a server, for web access and data synchronisation, and desktop instance(s). This allows all the data to be stored on the server and either accessed from the web browser, or the desktop application. The desktop application will sync and store the data locally so that it can be used when offline.</p><ol><li><a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a> (optional)</li><li><a class=\"reference-link\" href=\"#root/_help_poXkQfguuA0U\">Desktop Installation</a></li><li><a class=\"reference-link\" href=\"#root/_help_cbkrhQjrkKrh\">Synchronization</a></li></ol>",
"_help_i6dbnitykE5D": "<h2>Inspiration for the name “Trilium”</h2><blockquote><p>Naming software is hard. I lived in Ontario when I first started the project and Trillium (the flower) is sort of a provincial logo, many institutions in Ontario are named \"Trillium [something]\". So I kept hearing/reading it almost everyday, I liked the sound of it and its nature motif, so I just reused it.</p><p><em>– Zadam (original Trilium maintainer)</em></p></blockquote><aside class=\"admonition note\"><p>Despite the fact that the Trillium flower has two “l\"s, the Trilium application only has one.</p></aside><h2>How do I create a folder?</h2><p>Trilium has no separate folder type: any note can have child notes, so any note can act as a folder. A note can hold its own content and have children at the same time, unlike a file system, which separates files from directories.</p><p>To organize notes into a folder:</p><ol><li>Create a note that acts as the folder, for example \"Projects\".</li><li>Right-click it in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em>, or hover over it and press the <span class=\"tn-icon bx bx-plus\"></span> button.</li><li>To move existing notes into it, drag them onto it in the tree.</li></ol><p>The children of a note are listed at the end of its content (see <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>).</p><p>If you want the note to look like a folder, with no content of its own and only its children shown, make it a collection instead: right-click in the tree, select <em>Insert child note</em> → <em>Collection</em>, then choose <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a> or <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a>. See <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> for the other views, such as tables, boards and calendars.</p><h2>macOS support</h2><p>Originally, Trilium Notes considered the macOS build unsupported. TriliumNext commits to make the experience on macOS as good as possible.</p><p>if you find any platform-specific issues, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report them</a>.</p><h2>Translation / localisation support</h2><p>The original Trilium Notes application did not support multiple languages. Since we believe that internationalisation is a core part of an application, we have added support for it.</p><p>Contributions to translations are welcome.</p><h2>Multi-user support</h2><p>Common request is to allow multiple users collaborate, share notes etc. So far I'm resisting this because of these reasons:</p><ul><li>it's a huge feature, or rather a Pandora's box of collaboration features like user management, permissions, conflict resolution, real-time editing of a note by multiple people etc. This would be a huge amount of work. Trilium Notes is project made mostly by one person in free time and that's unlikely to change in the future.</li><li>given its size it would probably pivot the attention away from my main focus which is a personal note-taking</li><li>the assumption that only single person has access to the app simplifies many things, or just outright makes them possible. In multi-user app, our <a href=\"#root/_help_CdNpE2pqjmI6\">scripting</a>support would be a XSS security hole, while with the single user assumption it's an endless customizable tool.</li></ul><h2>How to open multiple documents in one Trilium instance</h2><p>This is normally not supported - one Trilium process can open only a single instance of a <a href=\"#root/_help_wX4HbRucYSDD\">database</a>. However, you can run two Trilium processes (from one installation), each connected to a separate document. To achieve this, you need to set a location for the <a href=\"#root/_help_tAassRL4RSQL\">data directory</a> in the <code>TRILIUM_DATA_DIR</code> environment variable and separate port on <code>TRILIUM_PORT</code> environment variable. How to do that depends on the platform, in Unix-based systems you can achieve that by running command such as this:</p><pre><code class=\"language-text-x-sh\">TRILIUM_DATA_DIR=/home/me/path/to/data/dir TRILIUM_PORT=12345 trilium </code></pre><p>You can save this command into a <code>.sh</code> script file or make an alias. Do this similarly for a second instance with different data directory and port.</p><h2>Can I use Dropbox / Google Drive / OneDrive to sync data across multiple computers.</h2><p>No.</p><p>These general purpose sync apps are not suitable to sync database files which are open and being worked on by another application. The result is that they will corrupt the database file, resulting in data loss and this message in the Trilium logs:</p><pre><code class=\"language-text-x-trilium-auto\">SqliteError: database disk image is malformed</code></pre><p>The only supported way to sync Trilium's data across the network is to use a <a href=\"#root/_help_cbkrhQjrkKrh\">sync/web server</a>.</p><h2>Why database instead of flat files?</h2><p>Trilium stores notes in a <a href=\"#root/_help_wX4HbRucYSDD\">database</a> which is an SQLite database. People often ask why doesn't Trilium rather use flat files for note storage - it's fair question since flat files are easily interoperable, work with SCM/git etc.</p><p>Short answer is that file systems are simply not powerful enough for what we want to achieve with Trilium. Using filesystem would mean fewer features with probably more problems.</p><p>More detailed answer:</p><ul><li><a href=\"#root/_help_IakOLONlIfGI\">clones</a> are what you might call \"hard directory link\" in filesystem lingo, but this concept is not implemented in any filesystem</li><li>filesystems make a distinction between directory and file while there's intentionally no such difference in Trilium</li><li>files are stored in no particular order and user can't change this</li><li>Trilium allows storing note <a href=\"#root/_help_zEY4DaJG4YT5\">attributes</a> which could be represented in extended user attributes but their support differs greatly among different filesystems / operating systems</li><li>Trilium makes links / relations between different notes which can be quickly retrieved / navigated (e.g. for <a href=\"#root/_help_BCkXAVs63Ttv\">note map</a>). There's no such support in file systems which means these would have to be stored in some kind of side-car files (mini-databases).</li><li>Filesystems are generally not transactional. While this is not completely required for a note-taking application, having transactions make it way easier to keep notes and their metadata in predictable and consistent state.</li></ul><h2>Search-related Questions</h2><h3>Why does search sometimes find results with typos?</h3><p>Trilium uses a progressive search strategy that includes fuzzy matching when exact matches return fewer than 5 results. This finds notes despite minor typos in your search query. You can use fuzzy search operators (<code>~=</code> for fuzzy exact match and <code>~*</code> for fuzzy contains). See the <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> documentation for details.</p><h3>How can I search for notes when I'm not sure of the exact spelling?</h3><p>Use the fuzzy search operators:</p><ul><li><code>#title ~= \"projct\"</code> - finds notes with titles like \"project\" despite the typo</li><li><code>note.content ~* \"algoritm\"</code> - finds content containing \"algorithm\" or similar words</li></ul><h3>Why do some search results appear before others with lower scores?</h3><p>Trilium places exact matches before fuzzy matches. When you search for \"project\", notes containing exactly \"project\" appear before notes with variations like \"projects\" or \"projection\", regardless of other scoring factors.</p><h3>How can I make my searches faster?</h3><ol><li>Use the \"Fast search\" option to search only titles and attributes (not content)</li><li>Limit search scope using the \"Ancestor\" field</li><li>Set a result limit to prevent loading too many results</li><li>For large databases, consider archiving old notes to reduce search scope</li></ol>",
"_help_KSZ04uQ2D1St": "<p>One of the core features of Trilium is that it supports multiple types of notes, depending on the need.</p><h2>Creating a new note with a different type via the note tree</h2><p>The default note type in Trilium (e.g. when creating a new note) is <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>, since it's for general use.</p><p>To create a new note of a different type, head to the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and right click an existing note where to place the new one and select:</p><ul><li><em>Insert note after</em>, to put the new note underneath the one selected.</li><li><em>Insert child note</em>, to insert the note as a child of the selected note.</li></ul><p>The note types created less often, <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>, <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>, <a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a> and <a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>, are in the <em>More</em> submenu.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types_image.png\"></p><h2>Creating a new note of a different type via add link or new tab</h2><ul><li>When adding a <a href=\"#root/_help_QEAPj01N5f7w\">link</a> in a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note, type the desired title of the new note and press Enter. Afterwards the type of the note will be asked.</li><li>Similarly, when creating a new tab, type the desired title and press Enter.</li></ul><p>The note type is chosen from the same menu as in the note tree, with its submenus (code languages, snippets, collections and the note types created less often) and its search box: type to narrow the list, then press <kbd>Enter</kbd> to create the first match. <kbd>Enter</kbd> right away creates a Text note.</p><h2>Changing the type of a note</h2><p>It is possible to change the type of a note after it has been created via <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Note type</em>. This feature can also be used to edit the <a href=\"#root/_help_4FahAwuGTAwC\">source of a note</a>.</p><aside class=\"admonition note\"><p>Note that it's generally a good idea to change the note type only if the note is empty</p></aside><h2>Supported note types</h2><p>The following note types are supported by Trilium:</p><figure class=\"table\"><table><thead><tr><th>Note Type</th><th>Description</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a></td><td>The default note type, which allows for rich text formatting, images, admonitions and right-to-left support.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a></td><td>Uses a mono-space font and can be used to store larger chunks of code or plain text than a text note, and has better syntax highlighting.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a></td><td>Stores the information about a search (the search text, criteria, etc.) for later use. Can be used for quick filtering of a large amount of notes, for example. The search can easily be triggered.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a></td><td>Allows easy creation of notes and relations between them. Can be used for mainly relational data such as a family tree.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a></td><td>Displays the relationships between the notes, whether via relations or their hierarchical structure.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a></td><td>Used in <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>, it displays the HTML content of another note. This allows displaying any kind of content, provided there is a script behind it to generate it.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a></td><td>Displays the children of the note either as a grid, a list, or for a more specialized case: a calendar. <br> <br>Generally useful for easy reading of short notes.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></td><td>Displays diagrams such as bar charts, flow charts, state diagrams, etc. Requires a bit of technical knowledge since the diagrams are written in a specialized format.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></td><td>Allows easy drawing of sketches, diagrams, handwritten content. Uses the same technology behind <a href=\"https://excalidraw.com\">excalidraw.com</a>.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a></td><td>Displays the content of an external web page, similar to a browser.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></td><td>Easy for brainstorming ideas, by placing them in a hierarchical layout.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a></td><td>Displays the children of the note as a geographical map, one use-case would be to plan vacations. It even has basic support for tracks. Notes can also be created from it.</td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a></td><td>Represents an uploaded file such as PDFs, images, video or audio files.</td></tr></tbody></table></figure>",
"_help_iPIMuisry3hd": "<p>The default note type in Trilium, text notes allow for rich formatting, tables, images, admonitions and a handful of other features.</p><h2>Formatting bars</h2><p>Most of the interaction with text notes is done via the built-in toolbars. Depending on preference, there are two different layouts:</p><ul><li>The <em>Floating toolbar</em> is hidden by default and only appears when needed. In this mode there are actually two different toolbars:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/1_Text_image.png\" width=\"496\" height=\"91\"><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/2_Text_image.png\" width=\"812\" height=\"114\"></li><li>A toolbar that appears when text is selected. This provides text-level formatting such as bold, italic, text colors, inline code, etc.<br><em><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text_image.png\" width=\"1109\" height=\"124\"></em></li></ul><p>Fore more information see <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</p><h2>Features and formatting</h2><p>Here's a list of various features supported by text notes:</p><figure class=\"table\"><table><thead><tr><th>Dedicated article</th><th>Feature</th></tr></thead><tbody><tr><td><a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a></td><td><ul><li>Headings (section titles, paragraph)</li><li>Font size</li><li>Bold, italic, underline, strike-through</li><li>Superscript, subscript</li><li>Font color & background color</li><li>Remove formatting</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a></td><td><ul><li>Bulleted lists</li><li>Numbered lists</li><li>To-do lists</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_NwBbFdNZ9h7O\">Block quotes & admonitions</a></td><td><ul><li>Block quotes</li><li>Admonitions</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a></td><td><ul><li>Basic tables</li><li>Merging cells</li><li>Styling tables and cells.</li><li>Table captions</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_UYuUB1ZekNQU\">Developer-specific formatting</a></td><td><ul><li>Inline code</li><li>Code blocks</li><li>Keyboard shortcuts</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a></td><td><ul><li>Footnotes</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a></td><td><ul><li>Images</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_QEAPj01N5f7w\">Links</a></td><td><ul><li>External links</li><li>Internal Trilium links</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a></td><td><ul><li>Include note</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a></td><td><ul><li>Links to blocks of a note</li><li>Including blocks of a note</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a></td><td><ul><li>Symbols</li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></li><li>Mermaid diagrams</li><li>Horizontal ruler</li><li>Page break</li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_dEHYtoWWi8ct\">Other features</a></td><td><ul><li>Indentation<ul><li>Markdown import</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_2x0ZAX9ePtzV\">Cut to subnote</a></li><li><a class=\"reference-link\" href=\"#root/_help_0vgWgxQAWj4a\">Sorting</a></li></ul></td></tr><tr><td><a class=\"reference-link\" href=\"#root/_help_gLt3vA97tMcp\">Premium features</a></td><td><ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a></li><li><a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a></li></ul></td></tr></tbody></table></figure><h2>Read-Only vs. Editing Mode</h2><p>Text notes are usually opened in edit mode. However, they may open in read-only mode if the note is too big or the note is explicitly marked as read-only. For more information, see <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>.</p><h2>Keyboard shortcuts</h2><p>There are numerous keyboard shortcuts to format the text without having to use the mouse. For a reference of all the key combinations, see <a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>. In addition, see <a class=\"reference-link\" href=\"#root/_help_QrtTYPmdd1qq\">Markdown-like formatting</a> as an alternative to the keyboard shortcuts.</p><h2>Content width</h2><p>For readability purposes on wider screens, the width of text notes is limited via a configurable option. See <a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a> for more information.</p><h2>Converting to a Markdown note</h2><p>Text notes can be converted to <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes. See <a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p><h2>Technical details</h2><p>For the text editing functionality, Trilium uses a commercial product (with an open-source base) called <a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>. This brings the benefit of having a powerful WYSIWYG (What You See Is What You Get) editor.</p>",
"_help_oSuaNgyyKnhu": "<aside class=\"admonition note\"><p>This feature used to be called <em>Bookmarks</em> (as it is the official name in the editor we are using), but in order not to collide with the concept of <a class=\"reference-link\" href=\"#root/_help_u3YFHC9tQlpm\">Bookmarks</a>, we have renamed it to <em>Anchors.</em></p></aside><p>Anchors allows creating <a href=\"#root/_help_QEAPj01N5f7w\">links</a> to a certain part of a note, such as referencing a particular heading or section within a note.</p><p>This feature was introduced in TriliumNext v0.94.0 and augmented in v0.103.0 to support linking across notes.</p><h2>Interaction</h2><ul><li>To create an anchor:<ul><li>Place the cursor at the desired position where to place the anchor.</li><li>Look for the <span class=\"tn-icon bx bx-plus\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, and then press the <span class=\"tn-icon cke cke-bookmark\"></span> button.</li><li>Alternatively, use <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a> and look for <em>anchor</em>.</li></ul></li><li>To place a link to an anchor in the same note:<ul><li>Place the cursor at the desired position of the link, or select the text to turn into a link.</li><li>Press <kbd>Ctrl</kbd>+<kbd>K</kbd> or the <span class=\"tn-icon cke cke-link\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, then select <em>Headings & anchors</em> at the top of the <a href=\"#root/_help_QEAPj01N5f7w\"><em>Add link</em> dialog</a>.</li><li>Under <em>Anchors</em>, click the desired anchor to check it. Optionally, type a <em>Link title</em>; without one, the link shows the anchor's name.</li><li>Press <kbd>Enter</kbd> or <em>Insert link</em> to confirm.</li></ul></li><li>Clicking a link to an anchor of the same note scrolls to the anchor and briefly highlights the block that holds it, while editing as well as in read-only notes and on shared pages.</li><li>To change a link to an anchor, place the cursor inside it and press <kbd>Ctrl</kbd>+<kbd>K</kbd>. Since v0.107.0, the <em>Edit link</em> dialog opens on <em>Headings & anchors</em>, with the linked anchor checked.</li></ul><aside class=\"admonition tip\"><p>To link to a heading of the same note, no anchor is needed: pick the heading under <em>Headings</em> in the same dialog. See <a href=\"#root/_help_klC3ilXa9kUE\">Linking to a heading</a> for details.</p></aside><h2>Linking across notes</h2><p>Trilium v0.103.0 introduces cross-note Anchors, which makes it possible to create <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> which point to a specific anchor in that document.</p><h3>Compatibility with documents from previous versions</h3><p>For notes created prior to Trilium v0.103.0, you might notice that the Anchors might not be identified. This limitation is intentional in order not to have to re-process all the notes, looking for anchors.</p><p>To fix this, simply go that note and make any change (e.g. inserting a space), this will trigger the recalculation of the links.</p><h3>Linking to anchors through the <em>Add link</em> dialog</h3><ol><li>Create an anchor in the target note using the same process as described above.</li><li>In another note, press <kbd>Ctrl</kbd>+<kbd>L</kbd> to insert an internal link. Select the target note containing Anchors.</li><li>If the target note contains Anchors, a section will appear underneath the note selector with the list of Anchors.</li><li>Add the link normally.</li></ol><p>Clicking on a reference link pointing to an anchor will automatically scroll to the desired section.</p><h3>Linking to anchors through the bookmark toolbar</h3><ol><li>Create an anchor in the target note using the same process as described above.</li><li>Click on the anchor to reveal the anchor's floating toolbar.</li><li>Click on the <span class=\"tn-icon cke cke-trilium-copy\"></span> <em>Copy anchor reference link</em> button.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><aside class=\"admonition note\"><p>Use this method only to insert <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> between two documents. To link to an anchor on the same note, use the <em>Add link</em> dialog (<kbd>Ctrl</kbd>+<kbd>K</kbd>) and select <em>Headings & anchors</em> at its top instead.</p></aside>",
"_help_oI7GoyilXXAr": "<h2>Automatic replacements</h2><p>As you type in a text note, certain character sequences are replaced with the typographic symbol they represent. Typing <code>(c)</code> gives you <code>©</code>, <code>...</code> gives you <code>…</code>, and <code>\"quote\"</code> gives you <code>“quote”</code>.</p><p>These replacements are not applied inside code blocks or inline code, and pasted text is never affected, only text you type. If you have pasted a code snippet, or written one inside a code block, its characters are left exactly as they are.</p><h3>Undoing a replacement</h3><p>Once an automatic replacement takes place, it can be undone by:</p><ul><li>Pressing <kbd>Backspace</kbd> immediately after a replacement undoes it and restores what you typed.<ul><li>Note that this consumes the undo, so a further <kbd>Ctrl</kbd>+<kbd>Z</kbd> might delete your typed text.</li><li>Pressing <kbd>Space</kbd> or changing the cursor position disables this functionality.</li></ul></li><li>Pressing <kbd>Ctrl</kbd>+<kbd>Z</kbd>, which works even after pressing space.</li></ul><h3>Replacement groups & configuration</h3><p>Each group can be turned off in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text notes</em> → <em>Automatic replacements</em>.</p><figure class=\"table\"><table><thead><tr><th>Group</th><th>What it replaces</th></tr></thead><tbody><tr><td>Punctuation</td><td><code>...</code> with an ellipsis (<code>…</code>), and <code>--</code> and <code>---</code> <em>surrounded by spaces</em> with an en dash (<code>–</code>) and an em dash (<code>—</code>)</td></tr><tr><td>Mathematical symbols</td><td>fractions such as <code>1/2</code> with <code>½</code>, and the operators <code><=</code>, <code>>=</code>, <code>!=</code>, <code><-</code> and <code>-></code> with <code>≤</code>, <code>≥</code>, <code>≠</code>, <code>←</code> and <code>→</code></td></tr><tr><td>Copyright and trademark</td><td><code>(c)</code>, <code>(r)</code> and <code>(tm)</code> with <code>©</code>, <code>®</code> and <code>™</code></td></tr><tr><td>Quotation marks</td><td>straight quotes with typographic ones — see below</td></tr></tbody></table></figure><h2>Quotation marks</h2><p>Quotation marks are configured separately from the rest, with one setting for the <strong>double</strong> quote key and one for the <strong>single</strong> quote key, because which pair belongs on which key differs between conventions: British typography traditionally sets a quotation in <code>‘…’</code> where American sets it in <code>“…”</code>.</p><p>Each offers:</p><ul><li><em>Based on the note's content language</em> (the default) — English gives <code>“quote”</code>, German <code>„quote“</code>, French <code>« quote »</code>, Japanese <code>「quote」</code>. See <a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language & Right-to-left support</a> for how a note's language is decided.</li><li><em>Disabled,</em> straight quotes stay straight.</li><li>A specific pair_:_ <code>“…”</code>, <code>‘…’</code>, <code>„…“</code>, <code>„…”</code>, <code>«…»</code>, <code>« … »</code>, <code>‹…›</code>, <code>「…」</code>, <code>『…』</code>. Choosing one applies it to every note, regardless of its content language.</li></ul><h2>Custom replacements</h2><p>You can add your own under <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text notes</em> → <em>Automatic replacements</em> → <em>Custom replacements</em>. Type the text to replace and the replacement, then press Enter. Existing ones are shown as chips and removed with the × on each.</p><p>A custom replacement is applied when the text is typed as a whole word and followed by a space, so longer words that begin with it are left alone — a <code>TN</code> replacement does not rewrite the end of <code>BTN</code>, and <code>TNT</code> can still be typed.</p><p>Capitalization follows what you type, unless the replacement has capitals of its own:</p><figure class=\"table\"><table><thead><tr><th><strong>Replacement you defined</strong></th><th><strong>You type</strong></th><th><strong>You get</strong></th></tr></thead><tbody><tr><td><code>teh</code> → <code>the</code></td><td><code>teh</code> / <code>Teh</code> / <code>TEH</code></td><td><code>the</code> / <code>The</code> / <code>THE</code></td></tr><tr><td><code>TN</code> → <code>Trilium Notes</code></td><td><code>TN</code> or <code>tn</code></td><td><code>Trilium Notes</code> (unchanged, it has capitals)</td></tr></tbody></table></figure><p>Of note:</p><ul><li>The text to replace is matched literally; it is not a pattern.</li><li>Typing a \"text to replace\" that already exists in the list of replacements will update the existing one instead. It's not possible to have multiple replacements for the same text.</li><li>The same “text to replace” with different capitalization (e.g. <code>TN</code> and <code>tn</code> co-existing) doesn't work because it would interfere with the capitalization rules above.</li></ul><h2>Characters that only look replaced (ligatures)</h2><p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-></code> as <code>→</code> inside a code block, that is not a replacement since replacements never run there (unless a code block is applied to an existing text). It is a <em>font ligature</em>: the default monospace font draws certain character pairs as a single symbol. The underlying text is unchanged, and copying it out gives you back <code>!=</code> and <code>-></code>.</p><p>This can be turned off with <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em></p>",
"_help_NwBbFdNZ9h7O": "<h2>Block quotes</h2><p>As the name suggests, block quotes can be useful to cite one or more paragraphs.</p><p>To create a block quote, press <span class=\"tn-icon cke cke-quote\"></span> from the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. It's also possible to type <kbd>></kbd>, followed by a space to create one (but only if the cursor is at the beginning of a line).</p><p>Inside the quote block, other block items can be inserted such as tables, images, or even other block quotes or admonitions.</p><h2>Admonitions</h2><p>Admonitions are a way to highlight information to the reader. Other names for it include <em>call-outs</em> and <em>info/warning/alert boxes</em>.</p><figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:959/547;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Block%20quotes%20%26%20admonitions_image.png\" width=\"959\" height=\"547\"></figure><p>From a functional point of view, admonitions act very similarly to a block quote, just with different styling. This includes the ability to insert other elements in it such as headings, tables, images, etc.</p><h3>Inserting a new admonition</h3><p>In the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Block%20quotes%20%26%20admonitions_image.png\"></p><p>It's possible to insert an admonition simply by typing:</p><ul><li><code>!!! note</code></li><li><code>!!! tip</code></li><li><code>!!! important</code></li><li><code>!!! caution</code></li><li><code>!!! warning</code></li></ul><p>In addition to that, it's also possible to type <code>!!!</code> followed by any text, case in which a default admonition type will appear (note) with the entered text inside it.</p><h3>Interaction</h3><p>By design, admonitions act very similar to block quotes.</p><ul><li>Selecting a text and pressing the admonition button will turn that text into an admonition.</li><li>If selecting multiple admonitions, pressing the admonition button will automatically merge them into one.</li></ul><p>Inside an admonition:</p><ul><li>Pressing <kbd>Backspace</kbd> while the admonition is empty will remove it.</li><li>Pressing <kbd>Enter</kbd> will start a new paragraph. Pressing it twice will exit out of the admonition.</li><li>Headings and other block content including tables can be inserted inside the admonition.</li></ul><h3>Types of admonitions</h3><p>There are currently five types of admonitions: <em>Note</em>, <em>Tip</em>, <em>Important</em>, <em>Caution</em>, <em>Warning</em>.</p><p>These types were inspired by GitHub's support for this feature and there are currently no plans for adjusting it or allowing the user to customize them.</p><h3>Markdown support</h3><p>See <a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>.</p>",
"_help_klC3ilXa9kUE": "<p>Block references are <a href=\"#root/_help_QEAPj01N5f7w\">links</a> to a block of a text note, such as a paragraph, a heading, a list item or a table, or to a range of consecutive blocks. A block reference can be pasted in another note as a link, or turned into an <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> that shows only the referenced blocks.</p><h2>Copying a reference</h2><ol><li>Place the cursor in the block to reference. To reference several consecutive blocks, select them.</li><li>Right-click the block handle, the sequence of dots to the left of the block (see <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>). Alternatively, right-click the text and open the <em>Copy</em> submenu.</li><li>Select <em>Copy reference to this block</em>, or <em>Copy reference to these blocks</em> for a selection. The referenced blocks flash briefly.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><p>Inside a <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a> block, the reference points to the whole block. To link to a single tab, use <em>Copy link to tab</em> instead. Inside a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a>, the reference points to the blocks in the column, and an include shows them without the layout around them.</p><p>The link shows the title of the note, followed by the beginning of the referenced text. A link to blocks of the same note shows only the beginning of the referenced text, and a link to a heading of the same note shows the whole heading.</p><p>If the note is <a href=\"#root/_help_R9pX4DGra2Vt\">shared</a>, the menu of the block handle also offers <em>Copy public link to this block</em>. It copies the web address of the shared page with the reference added, to send to people who read the note outside Trilium. Opening the address scrolls the shared page to the referenced blocks and flashes them. On a shared page, a link to blocks of another shared note does the same.</p><p>The <em>Paste</em> submenu of the context menu offers two more ways to insert a copied reference:</p><ul><li><em>Paste reference as a link</em> inserts only the link, even when the reference was copied as plain text or along with other content.</li><li><em>Paste reference as an excerpt</em> inserts an include of the referenced blocks, as described below.</li></ul><p>In a browser, the context menu of the text editor opens only when right-clicking selected text. Elsewhere the browser shows its own menu.</p><h2>Linking to a heading</h2><p>Since v0.107.0, a link to a heading of the same note can be created from the <em>Add link</em> dialog:</p><ul><li>Place the cursor at the desired position of the link, or select the text to turn into a link.</li><li>Press <kbd>Ctrl</kbd>+<kbd>K</kbd> or the <span class=\"tn-icon cke cke-link\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, then select <em>Headings & anchors</em> at the top of the dialog.</li><li>Under <em>Headings</em>, click the desired heading to check it. Sub-headings are listed under their heading and start collapsed; expand or collapse a heading with the arrow in front of it, or with <kbd>→</kbd> and <kbd>←</kbd> while it is focused. Optionally, type a <em>Link title</em>.</li><li>Press <kbd>Enter</kbd> or <em>Insert link</em> to confirm.</li></ul><p>When the link title is not set, the link displays the text of the heading. If the heading gets changed, the link is renamed automatically to the new text, shortly after you stop typing. A link with a title of its own keeps that title.</p><p>The link is a block reference to the heading, so it keeps working when the heading is moved. To change the link, click it and press the <span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> button in its popup. For a link with a title of its own, placing the cursor inside it and pressing <kbd>Ctrl</kbd>+<kbd>K</kbd> works too. The dialog opens on <em>Headings & anchors</em>, with the heading checked. Emptying the <em>Link title</em> there makes the link display the text of the heading again.</p><h2>Following a reference</h2><p>Clicking a block reference opens the note, scrolls to the referenced blocks and flashes them. If a referenced block was deleted, an error message is shown instead, along with the blocks of the range that still exist.</p><p>A link to blocks of the note it is in, such as a link to a heading, scrolls to them and flashes them without leaving the note, as a link within a web page does. This works in read-only notes and on shared pages too. While editing, clicking the link shows its popup: press <em>Jump to heading</em> there, or <em>Jump to block</em> for other blocks.</p><h2>Including the referenced blocks</h2><p>To show the referenced blocks inside another note, right-click the link in a note being edited and select <em>Convert link to note excerpt</em>, or paste the copied reference with <em>Paste</em> → <em>Paste reference as an excerpt</em>. The include shows only the referenced blocks, not the rest of the note, and marks them with an <em>Excerpt</em> badge in its title. It starts at the <em>Full</em> box size, so all the referenced blocks are visible. To see the whole note, press the <span class=\"tn-icon bx bx-link-external\"></span> button in the same title, which opens the note in a new tab. Converting the include back to a link keeps the reference.</p><p>To edit the referenced blocks without leaving the note, press the <span class=\"tn-icon bx bx-pencil\"></span> <em>Edit excerpt</em> button in the title of the include, or turn on <em>Editable</em> (<span class=\"tn-icon bx bx-edit-alt\"></span>) in its toolbar, as for any <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>. Press the button again to stop editing. The changes are saved to the referenced blocks, and the rest of the note stays as it is. The button is grayed out where the blocks cannot be edited, such as in a read-only note. An excerpt has no <em>Fullscreen</em> button.</p><p>If a referenced block was deleted, the include shows <em>Broken reference</em>.</p><h2>Limitations</h2><ul><li>References can be copied only from a note being edited, and not in the mobile layout.</li><li>An include of a range that covers only part of a list or a quote, such as from its second item to a paragraph after it, cannot be edited in place.</li><li>Deleting a block breaks the references to it.</li><li>Block references are not kept when exporting to Markdown. On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a block reference opens the whole note.</li></ul>",
"_help_4n4oQUVbnOxa": "<p>Collapsible blocks are sections of content that can be expanded and collapsed, letting you hide detail until it's needed.</p><p>A collapsible block consists of:</p><ul><li><strong>An always-visible header</strong>, containing:<ul><li><strong>An arrow</strong> that expands or collapses the block when clicked.</li><li><strong>A summary line</strong> that acts as the block's title. With the cursor in the summary line, press <kbd>Ctrl</kbd>+<kbd>Enter</kbd> to expand or collapse the block.</li><li><strong>A drag handle</strong> for repositioning the block within the note.</li></ul></li><li><strong>The body</strong>, which is hidden while the block is collapsed. It can hold any kind of content, including nested collapsible blocks. To break out of a collapsible block and continue typing outside it, press <kbd>Enter</kbd> twice at the end of the block.</li></ul><p>You can use the arrow keys to move freely with the cursor between the summary line, the block's body, and the text around the block.</p><h2>Inserting a collapsible block</h2><p>In the formatting bar, go to <em>Insert</em> → <em>Collapsible Block</em>.</p><aside class=\"admonition tip\"><p>Place multiple collapsible blocks one after another to create an accordion, where each block can be expanded or collapsed independently.</p></aside>",
"_help_veGu4faJErEM": "<p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Content%20language%20%26%20Right-to-left%20support_image.jpg\"></p><p>The content language determines:</p><ul><li>The spell-checking of the note, when in a browser. The desktop installation has a dedicated spellchecking section.</li><li>Whether the text is displayed from right-to-left, for languages such as Arabic, Hebrew, etc.</li><li>How typed quotes are <a href=\"#root/_help_oI7GoyilXXAr\">automatically replaced</a> (e.g. English uses <code>“text”</code>, whereas some languages use <code>«text»</code>). This applies only if <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text</em> → <em>Single/Double quotation marks</em> is set to <em>Based on note's content language</em>.</li><li>Which languages are offered by the <a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a> for translation.</li><li>The language and the text direction the content is marked with on a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, which screen readers and browsers follow.</li></ul><h2>Setting the language of a single note</h2><p>To set the language of the content of a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note, there is a language selector in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a> indicated by a <span class=\"tn-icon bx bx-globe\"></span> icon.</p><h2>Adjusting the list of languages</h2><p>By default, no language is configured. To configure them, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Language & Region</em> → <em>Content languages</em>, or select the <em>Configure languages...</em> item when setting the language. The enabled languages are listed by their native names, sorted alphabetically, which is also the order the language selector shows them in. Here you can:</p><ul><li>Add a language by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Add a language</em> button (<em>Add another language</em> once one is enabled), which also shows how many languages are left, and then selecting it.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button beside a language to remove it from the list.</li></ul><h2>Default content language</h2><p>Notes that do not have a language of their own follow <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Language & Region</em> → <em>Default content language</em>. It is set to English initially, and can be set to any content language, or to <em>Based on the application's language</em>.</p><p>If a note has a language set, it always takes precedence over the default.</p>",
"_help_EK2ckIZ74tbT": "<p>Content tabs group several titled panels of content into one block that shows a single panel at a time. They suit content that comes in variants (such as installation steps for each operating system or the same snippet in several programming languages).</p><p>A tabs block consists of:</p><ul><li><strong>A single row of tab titles</strong>, above the panel or, when the tabs are aligned at the bottom, below it. The title of the panel that is showing is highlighted.</li><li><strong>The panel of the active tab.</strong> A panel can hold any kind of content (including nested tabs blocks).</li></ul><h2>Inserting a tabs block</h2><ul><li>In the formatting bar, go to <em>Insert</em> → <em>Tabs</em>.</li><li>Alternatively, type <code>/tabs</code> and press <kbd>Enter</kbd>, as described in <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li></ul><p>A new block contains two tabs, named “Tab 1” and “Tab 2”. Any content that was selected prior to inserting the tabs will be moved into the first tab. The title of the first tab is selected, so typing replaces it.</p><h2>Scrolling through the titles</h2><p>When the titles of a block do not fit on their row, a <span class=\"tn-icon bx bx-chevron-left\"></span> button and a <span class=\"tn-icon bx bx-chevron-right\"></span> button appear at its ends:</p><ul><li>To scroll the titles, click one of the buttons. Holding a button down scrolls the titles continuously until it is released.</li><li>On a touch screen, the titles can also be swiped sideways.</li></ul><p>Whenever another tab is shown (for example by clicking its title, by moving the cursor into it or by following a link to it), the row scrolls so that its whole title is visible. This works the same while editing, in read-only notes and on shared pages.</p><h2>Editing tabs</h2><ul><li>To show a tab, click its title or move the cursor into it.</li><li>To move from a title into its panel, press <kbd>Enter</kbd>.</li><li>The label of a tab can be formatted just like normal text, including support for <a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a>.</li></ul><p>While the cursor is inside a tabs block, a toolbar appears above it with the following buttons:</p><ul><li><span class=\"tn-icon cke cke-plus\"></span> <em>(Add tab)</em> inserts a tab after the current one and selects its title.</li><li><span class=\"tn-icon cke cke-remove\"></span> <em>(Remove tab)</em> removes the current tab. Removing the last tab removes the whole block.</li><li><span class=\"tn-icon cke cke-chevron-right bx-flip-horizontal\"></span> <em>(Move tab left)</em> and <span class=\"tn-icon cke cke-chevron-right\"></span> (<em>Move tab right)</em> change the order of the tabs.</li><li><span class=\"tn-icon cke cke-link\"></span> <em>(Copy link to tab)</em> copies a link to the current tab, as described below.</li><li><span class=\"tn-icon cke cke-trilium-tabs\"></span> <em>(Tab alignment)</em> places the tab titles above the panel (<em>Align tabs at top</em>, the default) or below it (<em>Align tabs at bottom</em>).</li></ul><p>The tab that is showing is not saved with the note: every tabs block opens on its first tab.</p><h3>Adding tabs</h3><p>While the cursor is in a tab, either in its title or in its panel, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a tab after the current one.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a tab before the current one.</li></ul><p>The new tab is shown and its title is selected, so typing replaces it.</p><p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in a to-do item.</p><h3>Reordering tabs</h3><p>While the cursor is in a tab, either in its title or in its panel, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the tab to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the tab to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first tab.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last tab.</li></ul><h2>Moving content between tabs</h2><p>To move content to another tab, select it in the panel, and then use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the tab on the right.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the tab on the left.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last tab.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first tab.</li></ul><p>The tab that receives the content is shown, with the content still selected, so pressing the key again moves it on to the next tab. Paragraphs, list items, tables and other blocks move whole, even when only part of them is selected. Content moved to a tab on the left goes to the end of that tab, and content moved to a tab on the right goes to its start, so it keeps its place in the reading order.</p><p>Without a selection, or with a selection in a tab title, these keys keep their usual function: moving the cursor by word, or selecting up to the start or end of the tab.</p><p>When a tabs block and a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a> are nested in one another, the key combinations act on the one closest to the cursor.</p><h2>Reading tabs</h2><p>In <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a> and on <a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a>, tabs blocks work as tabs as well:</p><ul><li>To show a tab, click its title, or focus it and press <kbd>Enter</kbd> or <kbd>Space</kbd>.</li><li>To move between the titles of a block, use the arrow keys, <kbd>Home</kbd> and <kbd>End</kbd>.</li></ul><p>A tab without a title shows “Tab title” in place of one.</p><p>In read-only notes, a title too long for its tab fades out where it is cut off. To read the rest of it, swipe it sideways or drag it with the mouse.</p><h2>Linking to a tab</h2><p>A link can point to a single tab, much like a link to a block (see <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>):</p><ol><li>Place the cursor in the tab, either in its title or in its panel.</li><li>Press <em>Copy link to tab</em> (<span class=\"tn-icon cke cke-link\"></span>) in the toolbar of the tabs block. Alternatively, right-click the text and select <em>Copy</em> → <em>Copy link to this tab</em>. The tab flashes briefly.</li><li>Go to the note where to insert the link and press <kbd>Ctrl</kbd>+<kbd>V</kbd>.</li></ol><p>The link shows the title of the note, followed by the title of the tab. Clicking it opens the note, shows the tab and flashes it. As with any block reference, the link can be turned into an <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> that shows only that tab.</p><p>Links to a tab can be copied only from a note being edited. On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, such a link opens the whole note.</p><h2>Content in hidden tabs</h2><p>Content inside a tab that is not showing is still reachable (both while editing and while reading). The tab that holds it is shown when:</p><ul><li>searching the note with <kbd>Ctrl</kbd>+<kbd>F</kbd> highlights a match inside it;</li><li>a link points to an anchor or a block inside it (see <a class=\"reference-link\" href=\"#root/_help_oSuaNgyyKnhu\">Anchors</a> and <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>);</li><li>an entry of the <a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a> or the <a class=\"reference-link\" href=\"#root/_help_AxshuNRegLAv\">Highlights list</a> points inside it;</li><li>on a shared page, the address of the page points to a heading or an anchor inside it.</li></ul><p>Tab titles are not headings, so they do not appear in the table of contents; headings inside a panel do.</p><h2>Printing and exporting</h2><ul><li>When printing or <a href=\"#root/_help_NRnIZmSMc5sj\">exporting to PDF</a>, every tab is printed, one after another, each with its title above its panel, whatever the tab alignment.</li><li>Markdown export and import write tabs blocks in the content tabs syntax of Material for MkDocs, described in <a class=\"reference-link\" href=\"#root/_help_rJ9grSgoExl9\">Supported syntax</a>. <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes use the same syntax, show the blocks as tabs in their preview and insert them with <code>/tabs</code>. That syntax has no tab alignment, so tabs aligned at the bottom are exported as regular tabs.</li><li>Anywhere the tabs cannot work as tabs (such as an HTML export opened elsewhere), a tabs block reads as a sequence of titled sections.</li></ul>",
"_help_2x0ZAX9ePtzV": "<figure class=\"image image_resized image-style-align-right\" style=\"width:64.63%;\"><img style=\"aspect-ratio:812/585;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Cut%20to%20subnote_cut-to-subnote.gif\" width=\"812\" height=\"585\"></figure><p>When editing a document that becomes too large, you can split it into sub-notes:</p><ol><li>Select the desired text and cut it to the clipboard.</li><li>Create a new sub-note and name it.</li><li>Paste the content from the clipboard into the sub-note.</li></ol><p>Trilium can automate this process. Select some text within the note, and in the selection toolbar, click the scissors icon for the \"cut & pasted selection to sub-note\" action. The heading is automatically detected and the new sub-note is named accordingly. You can also assign a keyboard shortcut for this action. This functionality is available through the block toolbar icon. On a phone, the scissors are at the end of the text formatting row, which shows as you select text.</p>",
"_help_UYuUB1ZekNQU": "<h3>Inline code</h3><p>Inline code formats text using a monospace font to indicate technical content in a sentence such as code, paths, etc.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting_image.png\"></p><p>Example of inline code being used to illustrate file system paths as well as shell commands (<code>git</code> in this case).</p><p>To insert an inline code:</p><ul><li>Via the <a href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the <span class=\"tn-icon cke cke-code\"></span> button.</li><li>Type `code` where <code>code</code> is the desired text to be automatically formatted as inline code.</li><li>Paste a single line copied from Visual Studio Code. See <a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a> for pasting several lines.</li></ul><h3>Code blocks</h3><p>Code blocks display a snippet of code as a dedicated block:</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Developer-specific%20formatting_image.jpg\"></p><p>A code block with JavaScript syntax highlight enabled.</p><p>Note that these are not meant for very large portions of code. Use the dedicated <a href=\"#root/_help_6f9hih2hXXZk\">Code</a> note type instead.</p><p>See the dedicated documentation for more information: <a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a></p><h3>Keyboard shortcuts</h3><p>This allows marking a portion of text as a shortcut key.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting_image.jpg\"></p><p>To apply this style, press the <span class=\"tn-icon cke cke-trilium-kbd\"></span> button in <span class=\"tn-icon bx bx-text\"></span> group from the <a href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. On the floating toolbar, the buttons appear when selecting a text.</p><p>Alternatively, press the <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>K</kbd> combination to apply keyboard shortcut formatting to the current text selection.</p><p>The formatting can be removed by pressing again the button (from the UI or from the keyboard), or by using the <span class=\"tn-icon cke cke-remove-format\"></span> <em>Remove formatting</em> button.</p>",
"_help_QxEyIjRBizuC": "<p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting/Code%20blocks_image.jpg\"></p><p>The code blocks feature allows entering pieces of code in text notes.</p><p>Note that this feature is meant for generally small snippets of code. For larger files such as an entire log, see the <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note type instead.</p><h2>Inserting a code block</h2><ul><li>Via the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the <span class=\"tn-icon cke cke-code-block\"></span> button.<ul><li>Pressing directly on the icon will insert a code block with the language that was selected most recently. If this is the first time a code block is inserted, the language will be “Auto-detected” by default.</li><li>Pressing the arrow next to the icon, which will show a popup with the available languages.</li></ul></li><li>Type <code>```</code> (as in Markdown).<ul><li>Note that it's not possible to specify the language, as it will default to the last selected language.</li></ul></li><li>Paste several lines of code copied from Visual Studio Code.<ul><li>The code block uses the language of the file in Visual Studio Code.</li><li>If that language is not in the list of languages, the code block uses <em>Auto-detected</em>.</li><li>The colors of the Visual Studio Code theme are removed.</li><li>A single line becomes inline code instead of a code block.</li><li>In Firefox, the code block always uses <em>Auto-detected</em>. Firefox can't read the language from Visual Studio Code.</li></ul></li></ul><h2>Exiting out of the code block</h2><ul><li>To exit out of a code block and enter a normal paragraph, move the cursor at the end of the code block and press Enter twice.</li><li>Similarly, to insert a paragraph above the note block, move the cursor at the beginning of the code block and press Enter twice.</li></ul><aside class=\"admonition note\"><p>If you've pasted a code block with a more complex HTML structure, exiting out of the code block by pressing Enter multiple times might not work. In that case the best approach is to delete the code block entirely and use Ctrl+Shift+V (paste as plain text).</p></aside><h2>Syntax highlighting & color schemes</h2><p>Since TriliumNext v0.90.12, Trilium will try to offer syntax highlighting to the code block. Note that the syntax highlighting mechanism is slightly different than the one in <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes as different technologies are involved.</p><p>Interaction:</p><ul><li>When the language is set to <em>Auto-detected</em> (by default), Trilium will try to identify the programming language (or similar) that corresponds to the given snippet of text and highlight it. Only the languages enabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Available MIME types in the dropdown</em> are considered. If this is problematic, consider changing the language of the code block manually.</li><li>When the language is set to <em>Plain text</em>, there will be no syntax highlighting.</li></ul><p>Note that when editing a text note, syntax highlighting is automatically disabled if the code block is too big (somewhere around 500 lines). In <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>, in print and on a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, a code block of more than 500 lines or 50,000 characters is shown without syntax highlighting. These limits are not configurable.</p><p>In order to configure this new feature, a section has been added in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> to control the syntax highlighting. There the color scheme can be chosen, from a builtin selection of themes from Highlight.js. <em>VS Code (Light)</em> and <em>VS Code (Dark)</em> use the same colors as the default themes of <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes, so a code block and a code note color the same code alike.</p><ul><li>It is possible to disable the syntax highlighting for all the notes by selecting “No syntax highlighting” in the “Color scheme” option.</li><li>Word wrapping is disabled by default, but can be configured from the same section.</li><li>The tab width can also be adjusted from Options.</li></ul><aside class=\"admonition note\"><p><strong>Context regarding syntax highlighting</strong></p><p>In order to achieve the syntax highlight, the Highlight.js library is being used. Do note that support for syntax highlighting in code blocks is not a supported feature of the text editor we are using CKEditor), but rather a hack which makes use of the highlights API (used for highlighting search results for example). Nevertheless, we haven't noticed any major issues during the development of the feature, but feel free to report any issues you might have.</p><p>Most of the work to achieve the syntax highlight itself was already done by <a href=\"https://github.com/antoniotejada\">antoniotejada</a> in <a href=\"https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget\">https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget</a>. On our side we added customization but also additional functionality.</p></aside><h3>Migrating from existing syntax highlight plugins</h3><p>If you are already using a syntax highlighting plugin such as the <a href=\"https://github.com/antoniotejada/Trilium-SyntaxHighlightWidget\">Trilium-SyntaxHighlightWidget</a> we are basing off of, it is important to disable that plugin before upgrading in order for it not to conflict with our implementation.</p><p>Should you encounter any issues after the migration, try running Trilium in safe mode.</p><h2>Changing the language of a code block</h2><p>Simply click anywhere inside the code block and press again the code block button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Developer-specific%20formatting/Code%20blocks_image.png\"></p><h2>Adjusting the list of languages</h2><p>The code blocks feature shares the list of languages with the <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note type.</p><p>The supported languages, and the order in which they are listed, can be adjusted by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Available MIME types in the dropdown</em>. See <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> for how to add, remove and reorder them.</p><p>Note that the list of languages is not immediately refreshed, you'd have to manually <a href=\"#root/_help_s8alTXmpFR61\">refresh the application</a>.</p><h2>Text replacements and ligatures</h2><p><a class=\"reference-link\" href=\"#root/_help_oI7GoyilXXAr\">Automatic replacements</a> are a feature of text notes which converts some character sequences into another and some of them interfere with programming text, such as the conversion of quotes. While in a code block, the automatic replacements <strong>are not effect</strong>. The only way the automatic replacements can interfere is if the text is typed/pasted before being put in a code block.</p><p>A different feature is <em>programming ligatures</em>, which is simply a display affordance which turns <code>!=</code> into <code>≠</code> or <code>-></code> as <code>→</code> . These come from the <a href=\"#root/_help_w4rMEhJsALlA\">font</a>. The underlying text is not actually changed, and copying it out gives you back <code>!=</code> and <code>-></code>.</p><p>Ligatures can be disabled in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures.</em></p><h2>Extended code blocks</h2><aside class=\"admonition important\"><p>Extended code blocks are experimental, and they change as they mature. To use them, turn on <em>Extended code blocks</em> in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Advanced</em> → <em>Experimental Options</em>.</p></aside><p>An extended code block is a code block that is edited with the code editor of a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note, inside the text. It has the same syntax highlighting and code folding as a code note, and it suits longer pieces of code.</p><ul><li>To insert one, open the <span class=\"tn-icon cke cke-plus\"></span> <em>Insert</em> menu of the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> and choose <span class=\"tn-icon bx bx-code-block\"></span> <em>Extended code block</em>, after <em>Columns</em>. It is also available as <em>Extended code block</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li><li>A new block is empty and editable, in a <em>Full</em> box, and takes the focus. Its language is the one set last on an extended code block, or <em>Plain text</em>.</li><li>A click places the cursor in the code, as in a code block. Over a <em>Small</em> or <em>Medium</em> box, the mouse wheel scrolls the code.</li><li>The block shows in a box like the one of an included code note, with the corners and the shadow of a code block. While the block is editable, its language shows in its top corner, as for a code block. While it is read-only, because <em>Editable</em> is unchecked or the note is one of the <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>, that corner has a <span class=\"tn-icon bx bx-copy\"></span> <em>Copy to clipboard</em> button instead, as a code block of a read-only note does.</li><li>Its toolbar has the <em>Change language mode</em> and <em>Change tab width</em> menus of an embedded code file, described in <em>Editing an include in place</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>, and the <span class=\"tn-icon cke cke-trilium-copy\"></span> <em>Copy to clipboard</em> button, which copies the code as the one of a code block does. Its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu has <em>Editable</em>, which shows the code read-only once unchecked, the <em>Word wrap</em> and <em>Line numbers</em> submenus, the <em>Size</em> submenu, with <em>Small</em>, <em>Medium</em> and <em>Full</em>, the <em>Position</em> submenu, and <span class=\"tn-icon bx bx-trash\"></span> <em>Delete</em>, which removes the block from the note.</li><li>The <em>Position</em> submenu places the block as it places an include, described in <em>Positioning</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>: on lines of its own at the left, the center or the right, or at the left or the right with the text running beside it. A <em>Full</em> box takes the full width of the note, so a position shows once a <em>Small</em> or <em>Medium</em> box is resized narrower. In the mobile layout, a block with a position other than <em>Align center</em> takes the full width.</li><li>The changes made in the block are part of the undo history of the text note.</li></ul><p>The code stays in the note as a code block of its language. The Markdown export, <a href=\"#root/_help_R9pX4DGra2Vt\">shared pages</a> and printing show it as a code block, and copying it into another application pastes a code block. Pasted into a text note, it becomes an extended code block again, with its settings.</p><p>Turning <em>Extended code blocks</em> off again removes them from the <em>Insert</em> menu and the slash commands only: the extended code blocks already in notes keep working. A version of Trilium without this feature shows them as code blocks, and saves them back as code blocks, without their box size and other settings.</p>",
"_help_AgjCISero73a": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:199/187;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Footnotes_image.png\" width=\"199\" height=\"187\"></figure><p>Footnotes are a good place to insert references to a paragraph or details that are displayed at the bottom of the note.</p><h2>Interaction</h2><ul><li>To insert a new footnote, press <span class=\"tn-icon cke cke-trilium-insert-footnote\"></span> (or press the right arrow and select <em>New footnote</em>).</li><li>To insert a reference to an existing footnote, press the right arrow and select <em>Insert footnote</em>, followed by the number of the footnote to insert.</li><li>Hovering over a reference (e.g. <code>[1]</code>) will display the content of the footnote in a tooltip for easy reference.</li><li>Clicking on a reference in the text (e.g. <code>[1]</code>) will navigate to the corresponding footnote.</li><li>Similarly, clicking on the <code>^</code> button of a footnote will navigate to the corresponding reference in the text.</li></ul>",
"_help_5wZallV2Qo1t": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:220/76;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Format%20Painter_image.png\" width=\"220\" height=\"76\"></figure><p>The Format Painter is a feature in text notes that allows users to copy the formatting of text (such as <strong>bold</strong>, <em>italic</em>, <del>Strikethrough</del>, etc.) and apply it to other parts of the document. It helps maintain consistent formatting and accelerates the creation of rich content.</p><h2>Usage Instructions</h2><p>Click the text that you want to copy the formatting from and use the <em>Copy formatting</em> toolbar button (<span class=\"tn-icon cke cke-paint-roller\"></span>) to copy the style. Then select the target text with your mouse, or click a word, to apply the formatting.</p><ul><li><strong>To copy the formatting</strong>: Place the cursor inside text with some formatting and click the <em>Copy formatting</em> toolbar button. The mouse cursor changes to indicate the painter is armed.</li><li><strong>To paint with the copied formatting</strong>: Select the target text with your mouse. The formatting is applied when you release the button, and the painter disarms — the cursor returns to normal. Clicking or tapping a word applies it to the whole word.</li><li><strong>To paint a selection made otherwise</strong>, such as with the keyboard or the selection handles of a touch screen: select the target text, then use the toolbar button again, which reads <em>Apply formatting</em> once the selection has moved. On a phone, the formatting row stays open while the painter is armed, so the button stays in reach.</li><li><strong>To cancel without painting</strong>: Click the toolbar button again before selecting other text, or press <kbd>Escape</kbd>.</li></ul><h2>Limitations</h2><ol><li>Painting with block-level formatting (like headings or image styles) is not supported yet. This is because, in <a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>, they are considered a part of the content rather than text formatting.</li><li>A click outside a word, such as between two spaces or at the end of a line, only primes the caret, so text you type there takes the copied formatting.</li><li>The painter is one-shot; each paint requires copying the formatting again.</li></ol>",
"_help_nRhnJkTT8cPs": "<p>Trilium allows two different editing experiences for text notes, based on your preference.</p><p>The type of formatting toolbar can be changed by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> and then looking for the <a class=\"reference-link\" href=\"#root/_hidden/_options/_optionsTextNotes\">Text Notes</a> section. In it, look for the <em>Formatting toolbar</em> category.</p><h2>Floating</h2><p>The floating bar is a more minimalist option, in which the formatting is hidden behind two different popups.</p><h3>Block-level popup</h3><p>The first popup is the block-level popup. This will appear to the left of the current paragraph you are currently editing, as a sequence of dots:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Formatting%20toolbar_image.jpg\"></p><p>Clicking this popup will reveal the formatting options that are specific to the entire paragraph, such as setting a heading, lists, tables, etc.</p><p>The dots are also a drag handle: drag them to move the paragraph, all the selected paragraphs, or a selected element such as an image, a table or an included note to another place in the note. Right-clicking them opens a menu that copies a reference to the paragraph or to the selected paragraphs, see <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>. The last item of that menu, <em>Delete block</em>, deletes the paragraph or the selected paragraphs at once, without asking for confirmation; <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings them back.</p><figure class=\"image\"><img style=\"aspect-ratio:1404/156;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Formatting%20toolbar_image.png\" width=\"1404\" height=\"156\"></figure><h3>Inline popup</h3><p>The inline popup appears automatically when selecting a text:</p><figure class=\"image\"><img style=\"aspect-ratio:1008/154;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Formatting%20toolbar_image.png\" width=\"1008\" height=\"154\"></figure><p>All the options here apply only to the selected portion of text, such as changing the font size, or making the text bold.</p><h2>Fixed</h2><p>The fixed formatting offers a more traditional editing paradigm, usually useful if a lot of formatting is needed.</p><p>All the options are combined into a single toolbar that will appear at the above the note. When using <a class=\"reference-link\" href=\"#root/_help_luNhaphA37EO\">Split View</a>, a single toolbar will be available to save space and it acts on the active note.</p><p>The sequence of dots to the left of the current paragraph is still shown, but only as a drag handle: drag it to move the paragraph, all the selected paragraphs, or a selected element such as an image, a table or an included note to another place in the note. Releasing it above the first paragraph or below the last one moves it to the start or the end of the note. Clicking it does not open a popup, and right-clicking it opens a menu that copies a reference to the block, see <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>. The last item of that menu, <em>Delete block</em>, deletes the blocks that a drag would move, without asking for confirmation; <kbd>Ctrl</kbd>+<kbd>Z</kbd> brings them back. Hovering the drag handle shades the blocks that it moves, and they stay shaded while its menu is open: inside a table, this is the paragraph in the current cell, and with several cells selected, the whole table. The drag handle is not shown in the mobile layout.</p><figure class=\"image\"><img style=\"aspect-ratio:1440/60;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Formatting%20toolbar_image.png\" width=\"1440\" height=\"60\"></figure><p>By default, if the toolbar does not fit on the screen, the rest of the options will be grouped into a single option at the end. It is possible to display items on multiple lines by checking the corresponding option in the <em>Formatting toolbar</em> section.</p>",
"_help_Gr6xFaF6ioJ5": "<h2>Headings</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:255/284;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_General%20formatting_image.png\" width=\"255\" height=\"284\"></figure><p>Trilium provides headings to define sections within text. Headings are numbered from 2 to 6.</p><p>The reason why Heading 1 is missing from the list is that it is being reserved for the title of note.</p><p>To turn a heading back into a normal text, select <em>Paragraph</em> from the list.</p><p>Apart from using the UI, it is also possible to quickly insert headings using the Markdown-like shortcuts:</p><ul><li><code>##</code> for Heading 2</li><li><code>###</code> for Heading 3</li><li><code>####</code> for Heading 4</li><li><code>#####</code> for Heading 5</li><li><code>######</code> for Heading 6</li></ul><h2>Font size</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:363/249;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/General%20formatting_image.png\" width=\"363\" height=\"249\"></figure><p>One way to highlight a portion of text is to increase the size of the font.</p><p>To do so, select some text and choose an option from the <em>Font size</em> (<span class=\"tn-icon cke cke-font-size\"></span>) selector (as pictured to the right).</p><p>Unlike other text editors such as Microsoft Word, the font size is relative (i.e. “Tiny”, “Small” instead of a number like 12).</p><p>Avoid using this feature just to simply make all text bigger. In that case it's generally better to adjust the font size for all notes in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> or by zooming.</p><h2>Bold, italic, underline, strike-through</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:215/71;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_General%20formatting_image.png\" width=\"215\" height=\"71\"></figure><p>Text can be formatted as <strong>Bold,</strong> <em>Italic,</em> Underline or <del>Strike-through</del> via the dedicated buttons (<span class=\"tn-icon cke cke-bold\"></span>, <span class=\"tn-icon cke cke-italic\"></span>, <span class=\"tn-icon cke cke-underline\"></span>, <span class=\"tn-icon cke cke-strikethrough\"></span>) in the formatting toolbar.</p><p>This formatting can be easily removed using the <em>Remove formatting</em> (<span class=\"tn-icon cke cke-remove-format\"></span>) item.</p><p>The following keyboard shortcuts can be used here:</p><ul><li><kbd>Ctrl</kbd>+<kbd>B</kbd> for bold</li><li><kbd>Ctrl</kbd>+<kbd>I</kbd> for italic</li><li><kbd>Ctrl</kbd>+<kbd>U</kbd> for underline</li></ul><p>Alternatively, Markdown-like formatting can be used:</p><ul><li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code></li><li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code></li><li><del>Strikethrough</del>: Type <code>~~text~~</code></li></ul><h2>Superscript, subscript</h2><p>This allows writing superscript or subscript text.</p><p>This is mostly useful for units of measure (e.g. cm3 for cubic centimeters) and chemical notations (e.g. NaHCO3)</p><p>For mathematical formulas, prefer the <a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> feature instead.</p><h2>Font color and background color</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:167/204;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_General%20formatting_image.png\" width=\"167\" height=\"204\"></figure><p>Selected text can be colored with one of the predefined colors from a palette or any color can be selected using the color picker (<span class=\"tn-icon cke cke-color-palette\"></span>).</p><p>Once there is at least one color defined in the document, it will appear in the list for easy reuse.</p><p>Colors adapt to the <a href=\"#root/_help_Wy267RK4M69c\">theme</a>. Trilium shows each color in a lighter or darker shade that suits the current theme, so the text stays readable after switching between light and dark themes. The hue stays the same: red text is red in both themes, only lighter or darker. This applies to the palette, the color picker and the document colors alike, and to shared notes too. Printed notes and PDF exports always use the shades of light themes, which suit white paper. The note itself keeps the color as it was picked, so an exported note shows it unchanged.</p><p>Colors applied with older versions of Trilium are shown exactly as they were picked, until the note is next edited.</p><p>Older browsers that can't adapt colors show them exactly as they were picked.</p><p>When you paste text copied from a web page in Chrome, Edge or a Chromium-based app (such as Visual Studio Code), Trilium removes the page's styling:</p><ul><li>Text and background colors.</li><li>Fonts and font sizes.</li><li>Table borders, backgrounds and spacing.</li></ul><p>The following formatting is preserved:</p><ul><li>Bold, italic, underline and strikethrough.</li><li>Subscript and superscript.</li><li>Links, code and tables.</li></ul><p>Colors are preserved when pasting from Word, Google Docs or another note.</p><p>To remove either the background or foreground color of a text, select the corresponding formatting button (<span class=\"tn-icon cke cke-font-color\"></span> or <span class=\"tn-icon cke cke-font-background\"></span>) and press <em>Remove color</em> (<span class=\"tn-icon cke cke-eraser\"></span>) or use the <em>Remove formatting</em> (<span class=\"tn-icon cke cke-remove-format\"></span>) toolbar item.</p><h2>Remove formatting</h2><p>The <span class=\"tn-icon cke cke-remove-format\"></span> <em>Remove formatting</em> button is a quick way to eliminate the general formatting styling of a particular text.</p><p>Simply select the text and press the button to remove the formatting (bold, italic, colors, sizes, etc.). If the text does not have any removable formatting, the button will appear disabled.</p><p>Note that heading styles are not taken into consideration, these must be manually changed back to a paragraph according to the <em>Headings</em> section.</p><p>When pasting content that comes with undesired formatting, an alternative to pasting and then removing formatting is pasting as plain text via <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>V</kbd>.</p><h2>Format painter</h2><p>The <a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a> allows users to copy the formatting of text (such as bold, italic, Strikethrough, etc.) and apply it to other parts of the document. It helps maintain consistent formatting and accelerates the creation of rich content.</p><h2>Support for Markdown</h2><p>When exported to <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>, most of the general formatting is maintained such as headings, bold, italic, underline, etc.</p>",
"_help_AxshuNRegLAv": "<aside class=\"admonition note\"><p>This page has been relocated to <a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p></aside>",
"_help_mT0HEkOsz6i1": "<p>Trilium supports storing and displaying images. Supported formats are PNG, JPEG, GIF, BMP, WebP, AVIF and SVG.</p><p>An image can be uploaded in the form of note's <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> or as a standalone <a href=\"#root/_help_kBrnXNG3Hplm\">note</a> placed into the <a href=\"#root/_help_kBrnXNG3Hplm\">note tree</a>. Its reference can be copied into a text note, in order to display it in the text itself.</p><h2>Uploading images</h2><p>To add an image to the note:</p><ul><li>Simply drag it from file explorer onto the note editor inside Trilium and the image will be uploaded.</li><li>Alternatively, in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, press the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button and select <em>Image</em>.</li><li>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the same menu also offers <em>Camera</em>, which takes a photo and inserts it.</li><li>You can also copy and paste an image from web (see section below).</li></ul><p>Where the image goes depends on the cursor. In an empty paragraph, the image is displayed on a line of its own. In a list item, or after some text in a paragraph, the image is inserted <em>In line</em>, inside the text. To change it afterwards, use the <em>Image position</em> button described in the alignment section below.</p><aside class=\"admonition tip\"><p>To link a picture instead of displaying it, attach it with <em>Attach file as a link</em>, from the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button. See <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</p></aside><h2>Clipboard & automatic download of images</h2><p>Trilium has a special handling for images copied to and pasted from the clipboard.</p><ul><li>For a mix of text and images, the images are downloaded automatically by the server (or desktop app, depending on what is being used).<ul><li>This means that the image must be publicly accessible and reachable from wherever Trilium is running. Inaccessible images will end up as broken images.</li></ul></li><li>If a single image is pasted into Trilium, it will prefer the image that comes in the clipboard. This makes it possible to copy images that Trilium would not otherwise be able to reach, such as Google Chat, Slack, etc.</li><li>When a text with images is copied from Trilium and pasted in another app (such as Microsoft Word or LibreOffice Writer), the images will be preserved.</li></ul><p>The automatic download of images is enabled by default and can be toggled from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em> → <em>Download images automatically.</em></p><h2>Configuring the images</h2><p>Clicking on an image will reveal a popup with multiple options:<br><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images_image.png\"></p><h3>Alignment</h3><p>The first button of the popup, <em>Image position</em>, shows the icon of the image's current position. It opens a menu that groups the positions by how text runs around the image:</p><figure class=\"table\"><table><thead><tr><th>Icon</th><th>Option</th><th>Preview</th><th>Description</th></tr></thead><tbody><tr><td><span class=\"tn-icon cke cke-object-inline\"></span></td><td><em>In line</em></td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images_image.jpg\"></td><td>The image sits inside a paragraph, like a large character, and moves with the text around it. Use drag & drop or cut-paste to move it around.</td></tr><tr><td><span class=\"tn-icon cke cke-object-center\"></span></td><td><em>Break text</em> → <em>Align left</em>, <em>Align center</em> or <em>Align right</em></td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Images_image.jpg\"> <img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Images_image.jpg\"></td><td>The image is displayed on a line of its own, at the left, in the center or at the right; text continues above and below it but not beside it.</td></tr><tr><td><span class=\"tn-icon cke cke-object-inline-right\"></span></td><td><em>Wrap text</em> → <em>Align left</em> or <em>Align right</em></td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Images_image.jpg\"></td><td>The image is displayed at the left or the right, and the text flows beside it.</td></tr></tbody></table></figure><h3>Drawing over an image</h3><p>To draw or write over an image, press the <span class=\"tn-icon bx bxs-pen\"></span> <em>Convert image to a drawing canvas</em> button of its toolbar. The image becomes a drawing canvas that shows all of it, locked in place. See the drawing canvases section of <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h2>Compression</h2><p>Since Trilium isn't really meant to be primary storage for image data, it attempts to compress and resize (with pretty aggressive settings) uploaded images before storing them to the database. You may then notice some quality degradation. Basic quality settings is available in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>.</p><p>If you want to save images in their original resolution, it is recommended to save them as attachment to note (look for the contextual menu in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Import files</em>).</p><h2>Aligning images side-by-side</h2><p>There are generally two ways to display images side by side:</p><ul><li>If they are roughly the same size, simply make the two images in-line, according to the alignment section above. The images can be dragged & dropped onto the same line.</li><li>If they are on different size, create a <a href=\"#root/_help_NdowYOC1GFKS\">table</a> with invisible borders.</li></ul>",
"_help_0Ofbk1aSuVRu": "<figure class=\"image image-style-align-right image_resized\" style=\"width:50.47%;\"><img style=\"aspect-ratio:880/553;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Images/Image%20references_image.png\" width=\"880\" height=\"553\"></figure><p>Image references are an easy way to embed the preview of another note type into a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note.</p><h2>Supported note types</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a></li><li><a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a></li></ul><h2>Steps</h2><ol><li>Go to one of the supported notes (listed above) and look for the <span class=\"tn-icon bx bx-copy\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area.</li><li>Go to a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note and use the Paste function to insert the reference to that note.</li></ol><h2>Interaction</h2><ul><li>Double-clicking an image reference from a text note will automatically open the target note.</li><li>Clicking an image reference while <kbd>Ctrl</kbd> is pressed will open the target note in a new tab.</li><li>Modifying the target note should also update the image reference. If that doesn't happen, consider <a class=\"reference-link\" href=\"#root/_help_s8alTXmpFR61\">Refreshing the application</a>.</li></ul>",
"_help_VRoP0g1uHHc2": "<figure class=\"image image-style-align-center image_resized\" style=\"width:76.29%;\"><img style=\"aspect-ratio:1479/865;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/In-editor%20AI%20assistant_image.png\" width=\"1479\" height=\"865\"></figure><p>The AI assistant works on the text you are already writing: select a passage and have it rewritten, translated or turned into a table, or ask for new content at the cursor. Unlike the <a href=\"#root/_help_LrKznOtw9cQD\">AI chat</a>, it does not open a conversation window, the result is previewed in place and only enters the note when you accept it.</p><h2>Requirements</h2><p>The assistant is only available once at least one provider is configured in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>AI / LLM</em>, with at least one model selected for it. Until then the toolbar entry is not shown at all.</p><h2>Accessing the AI assistant</h2><p>To access the AI assistant:</p><ul><li>Look for the <span class=\"tn-icon cke cke-trilium-ai\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. Press the button itself to enter the <em>Ask AI</em> mode or press the arrow key next to it to access the quick commands and the model selection. On a phone, the button has no arrow: tapping it opens the same menu at the bottom of the screen, with <em>Ask AI…</em> at its top, and a group such as <em>Translate</em> opens as a page of its own.</li><li>Look for <em>AI assistant</em> or any of the <em>AI</em>-prefixed quick commands in <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>K</kbd>.</li><li>Select a text and choose the <em>AI assistant</em> option in the <a class=\"reference-link\" href=\"#root/_help_jcQVxzYybYgz\">Note contextual menu</a>.</li></ul><h2>What the assistant works on</h2><figure class=\"table\"><table><thead><tr><th>Situation</th><th>What is sent</th></tr></thead><tbody><tr><td>Text is selected</td><td>The selection.</td></tr><tr><td>Nothing is selected, and you pick a quick action</td><td>The paragraph the cursor is in.</td></tr><tr><td>Nothing is selected, and you type your own prompt</td><td>Nothing, the response is new content written at the cursor.</td></tr></tbody></table></figure><p>In all cases the assistant also sends the text before and after the target, so that the model can tell what it is writing into: asked to <em>Continue writing</em> or to summarize, a model that can only see the selected words is guessing at the document around them. This surrounding text is context only, it is never rewritten.</p><aside class=\"admonition important\"><p>That means a single run sends more than the passage you highlighted. See <a class=\"reference-link\" href=\"#root/_help_cRRrdZjgyhNc\">Privacy</a> for exactly what leaves your machine.</p></aside><h2>Quick actions</h2><p>The arrow beside the toolbar button opens a menu of ready-made instructions, grouped by what they do.</p><ul><li>The <em>Reformat</em> actions produce real Trilium content rather than plain text: <em>Diagram</em> inserts a Mermaid diagram, <em>Callout</em> an admonition, and <em>Collapsible</em> a collapsible block.</li><li>The <em>Translate</em> group lists the <a href=\"#root/_help_veGu4faJErEM\">content languages</a> you have enabled, or a predefined list if no content languages are set. It can be filled from within the editor, the last entry of the submenu opens the language configuration directly.</li></ul><p>Actions that need something to work on are greyed out when there is nothing to work on (for example an empty paragraph with no selection).</p><h2>Asking for something specific</h2><p>Choosing <em>Ask AI…</em> (<span class=\"tn-icon bx bx-message-square-dots\"></span>) opens a prompt where you can describe the change in your own words, for example: \"make this less formal\", \"add a row for 2024\", \"write an intro paragraph for this section\". Press <kbd>Enter</kbd> or the <span class=\"tn-icon cke cke-arrow-up\"></span> send button to run it.</p><p>Once a response arrives you can keep going in the same prompt, and the assistant treats it as a conversation rather than as a fresh request: after <em>Translate this to German</em>, asking for <em>make it shorter</em> shortens the German, not the original.</p><h2>Reviewing the result</h2><p>The response streams in as it is generated, and can be interrupted at any point by pressing the <em>Stop</em> (<span class=\"tn-icon cke cke-stop\"></span>) button; whatever arrived before that stays usable.</p><p>Nothing is written into the note until you say so. The review offers:</p><ul><li><em>Result</em>, which displays the response as it will be inserted.</li><li><em>Changes</em>, which displays an inline diff against the original, with insertions and deletions marked. When the model rewrote the passage rather than editing it, the review opens on <em>Result</em> instead: a diff of two texts with little in common is harder to read than the answer itself.</li><li><em>Try again</em> (<span class=\"tn-icon cke cke-refresh\"></span>), to re-run the same instruction.</li><li><em>Replace</em>, which substitutes the original passage</li><li><em>Insert below</em>, which keeps the original and adds the response after it.</li></ul><p>Trilium also reports the model that produced it, the tokens consumed and, for providers that report it, the price.</p><p>If you ask for a correction and there is nothing to correct, the assistant will indicate it instead of showing a blank diff.</p><h2>Choosing the model</h2><p>The bottom of the quick actions menu shows which model the assistant runs on, and lets you pick another from the models you selected in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>AI / LLM</em>, grouped by provider.</p><p>The model can also be changed while asking for something specific, or after the assistant has generated its response (i.e. if the response needs a better model).</p><p>This choice is separate from the model used by the chat, and is remembered across notes and devices. Left unset, the assistant follows the first configured provider.</p>",
"_help_mVEYwt20exhO": "<p><em>Quick actions</em> are a feature of the <a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a> for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes which automatically triggers an LLM suggestion based on a defined prompt. The built-in quick actions come with a predefined prompt, but it is also possible to define your own quick actions.</p><h2>Creating a custom quick action</h2><p>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right-click the note where you want to place the quick action.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>AI Quick Action</em>. The entry appears only when AI is enabled.</li></ol><p>Afterwards, simply type in the content of the note the desired prompt. The text can be formatted in the same manner as a normal text note and it will be passed to the LLM as Markdown.</p><p>The title of the note will become the title of the quick action.</p><p>Of note:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes work too.</li><li>An empty note is ignored.</li><li><a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a> are also excluded.</li></ul><h2>Using a quick action</h2><p>Once a quick action is defined, the action will appear under the <em>Quick Actions</em> dropdown in a group called <em>Custom</em>.</p>",
"_help_nBAXQFj20hS1": "<p>Text notes can \"include\" another note as a read-only widget or an interactive widget, depending on the type of note.</p><p>This can be useful for e.g. including a dynamically generated chart (from scripts & \"render HTML\" note) or other more advanced use cases.</p><h2>Including a note</h2><p>In the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, look for the <span class=\"tn-icon cke cke-trilium-note\"></span> button. There is also a keyboard shortcut defined for it but it is not allocated by default.</p><p>The <em>Include note</em> dialog opens with two rows: <em>Note</em>, where you search for the note to include, and <em>Box size</em> (see <em>Box sizes</em> below), a row of buttons each with a small drawing of the size, with a sentence under it describing the size chosen. Once a note is picked, press <em>Include note</em> or <kbd>Enter</kbd> to include it. Typing the title of a note that does not exist offers to create it.</p><p>An image note, a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> or a <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> note picked in the dialog is inserted as an image rather than included, so instead of the size buttons, the <em>Box size</em> row says so. In a text note, the image can be resized once it is in the text, and the dialog reminds you of that, as it reminds you that the size of an include can be changed later.</p><p>To include a note that is already linked, right-click a reference link to it in a text note being edited and select <em>Convert link to an included note</em>, at the end of the menu. The include gets the box size that suits the note, as one added from the button does.</p><p>An <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> can be included the same way, from the context menu of a link to it (see <em>Embedding an attachment</em> there).</p><p>A link to blocks of a text note is converted the same way, with <em>Convert link to note excerpt</em>, and the include then shows only those blocks. See <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>.</p><h2>Box sizes</h2><p>The box size sets how much of the included note is shown.</p><ul><li><em>Tiny</em> shows a single row instead of the content: the note's icon, its title with the path to the note above it, and buttons to act on the note. The included note is never rendered, so wherever the note is shown outside the editor, such as in print, in a tooltip or on a shared page, a <em>Tiny</em> include appears as a link to the included note.</li><li><em>Small</em> and <em>Medium</em> show the content in a box of limited height. Text scrolls inside the box, while a picture, a diagram or a video is scaled down to fit it.</li><li><em>Full</em> shows the whole content.</li><li><em>Expandable</em> shows only the title until its <span class=\"tn-icon bx bx-chevron-right\"></span> arrow is pressed. In a read-only note, a click anywhere on the title row other than its buttons and link expands or collapses it as well.</li></ul><p>A new include gets the size that suits what it shows:</p><ul><li><em>Tiny</em> for a note or an attachment that has no preview, such as a relation map or an archive.</li><li><em>Small</em> for audio.</li><li><em>Full</em> for a code note or a code file, such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment, and for an excerpt of the blocks of a text note.</li><li><em>Medium</em> for anything else.</li></ul><p>The <em>Include note</em> dialog selects that size among its <em>Box size</em> buttons once the note is picked, and you can choose another one there. To change the size later, select the include and use the <em>Box size</em> menu in its toolbar, or the <em>Size</em> submenu of its <em>More actions</em> menu. For an included code or Markdown note and an embedded code or Markdown file, the <em>Box size</em> menu is the <span class=\"tn-icon bx bx-move-vertical\"></span> button, whose tooltip names the current size.</p><h2>Resizing</h2><p>A <em>Small</em>, <em>Medium</em> or <em>Expandable</em> include can be resized to any width and height. A <em>Tiny</em> or <em>Full</em> include always fits its content.</p><ul><li>To resize an include, select it and drag the handle in its bottom-right corner. To change only the width or only the height, drag the middle of its right or bottom edge instead, where a touch screen shows a handle too. In right-to-left text, the handle is in the bottom-left corner and the width changes from the left edge.</li><li>Resizing works with a mouse, a pen or a finger.</li><li>While the height changes, moving the handle near the top or the bottom of the note scrolls the note.</li><li>An include narrower than the note is centered, so changing its width moves both of its sides. An include aligned to the left or the right keeps that side in place and has its handles on the other side (see <em>Positioning</em> below). Making an include as wide as the note returns it to the full width.</li><li>To cancel a resize, press <kbd>Esc</kbd> before releasing the handle.</li><li>To reset the size, double-click the corner handle, or double-tap it on a touch screen. Double-clicking the right or bottom edge resets only the width or the height.</li><li>Choosing a box size resets the height. Choosing <em>Tiny</em> or <em>Full</em> resets the width too.</li><li>While an <em>Expandable</em> include is collapsed, only its width can be changed.</li></ul><h2>Positioning</h2><p>An include can sit on lines of its own or have the text wrap around it, as an <a href=\"#root/_help_mT0HEkOsz6i1\">image</a> can.</p><ul><li>To change the position, open the <em>More actions</em> menu of the include in a note being edited (see <em>Opening an included note</em> below) and choose an entry of its <em>Position</em> submenu:<ul><li>Under <em>Break text</em>, <span class=\"tn-icon cke cke-object-left\"></span> <em>Align left</em>, <span class=\"tn-icon cke cke-object-center\"></span> <em>Align center</em> and <span class=\"tn-icon cke cke-object-right\"></span> <em>Align right</em> place the include on lines of its own, at that side of the note. <em>Align center</em> is the default.</li><li>Under <em>Wrap text</em>, <span class=\"tn-icon cke cke-object-inline-left\"></span> <em>Align left</em> and <span class=\"tn-icon cke cke-object-inline-right\"></span> <em>Align right</em> place the include at that side and let the text run beside it.</li></ul></li><li>An include takes the full width of the note until it is resized, so a new position shows once a <em>Small</em>, <em>Medium</em> or <em>Expandable</em> include is resized narrower (see <em>Resizing</em> above). The position is kept whatever the box size, and shows again when such an include is resized.</li><li>In the mobile layout, an include with a position other than <em>Align center</em> takes the full width, and only its height can be resized.</li></ul><h2>Caption</h2><p>An include can have a caption, shown centered at the bottom of its box. The caption is part of the text note, so it can be formatted like the rest of the text, for example in bold or with a link.</p><ul><li>To add a caption, select the include, press the <span class=\"tn-icon cke cke-caption\"></span> <em>Toggle caption on</em> button in its toolbar and type the caption. While the cursor is in the caption, the include stays selected and keeps its toolbar.</li><li>To remove the caption, press the same button again. Pressing it once more brings back the text it had, as long as the note stays open.</li><li>A <em>Tiny</em> include has no caption. Switching an include to <em>Tiny</em> removes its caption, and switching it back to a larger size restores the caption, as long as the note stays open.</li><li>An <em>Expandable</em> include shows its caption under the title while the content is collapsed, and under the content once it is expanded.</li></ul><h2>Title</h2><p>The title row of an include links to the included note and holds its buttons. To show only the content, select the include and press the <span class=\"tn-icon bx bx-window-alt\"></span> <em>Show title</em> button in its toolbar. Pressing it again shows the title.</p><ul><li>While the title is hidden, the <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> button in the toolbar of the include opens the menu of the included note.</li><li>A <em>Tiny</em> or <em>Expandable</em> include always shows its title, and its toolbar has no <em>Show title</em> button.</li></ul><h2>Opening an included note</h2><p>To open an included note in a new tab, press the <span class=\"tn-icon bx bx-link-external\"></span> <em>Open in new tab</em> button at the end of its title. An embedded attachment has the same button.</p><p>The <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> <em>More actions</em> button at the end of the title row opens the same menu as right-clicking anywhere on the title row: the other places to open the note in and, for an embedded attachment, the actions on the attachment.</p><p>In a note being edited, the menu also has the commands of the include's toolbar: the <em>Size</em> submenu, <em>Show title</em> and <em>Show caption</em>, each checked while it is in effect, and <em>Convert to link</em>. It also has the <em>Position</em> submenu after <em>Size</em> (see <em>Positioning</em> above), and <span class=\"tn-icon bx bx-trash\"></span> <em>Delete</em> at the end, which removes the include from the note. A drawing canvas, a Mermaid diagram, an included text, code or Markdown note and an embedded code or Markdown file also have <em>Editable</em>, above <em>Size</em>. An included code or Markdown note, an embedded code or Markdown file and a Mermaid diagram also have the <em>Word wrap</em> and <em>Line numbers</em> submenus after <em>Editable</em> (see <em>Editing an include in place</em> below). A Mermaid diagram, an included Markdown note and an embedded Markdown file also have <em>Source view</em>, <em>Split view</em> and <em>Preview</em> after these submenus. For an embedded attachment they follow its first group of actions; for an included note, the places to open it in.</p><p>To show an include of size <em>Medium</em> or <em>Full</em> on the whole screen, press the <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Fullscreen</em> button at the end of its title. An excerpt of the blocks of a note has an <span class=\"tn-icon bx bx-pencil\"></span> <em>Edit excerpt</em> button there instead; see <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a>. To return, press <span class=\"tn-icon bx bx-exit\"></span> <em>Exit fullscreen</em> in the top-right corner, or <kbd>Esc</kbd>.</p><p>A <em>Tiny</em> include has these buttons instead, followed by the same <em>More actions</em> button:</p><ul><li>For a note, <span class=\"tn-icon bx bx-edit\"></span> <em>Quick edit</em> opens the note in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, and <span class=\"tn-icon bx bx-link-external\"></span> <em>Open in new tab</em> opens it in a new tab.</li><li>For an embedded attachment, <span class=\"tn-icon bx bx-file-find\"></span> <em>Open externally</em> opens the file in another application, and <span class=\"tn-icon bx bx-download\"></span> <em>Download</em> downloads it. The size of the file is shown under its title.</li></ul><h2>Converting an include to a link</h2><p>To replace an include with a link to the included note, select it and press the <span class=\"tn-icon cke cke-link\"></span> <em>Convert to link</em> button in its toolbar, or choose <em>Convert to link</em> in its <em>More actions</em> menu, above <em>Delete</em>. An embedded attachment turns into a link to the attachment the same way.</p><h2>Missing notes and attachments</h2><p>An include whose note or attachment no longer exists, for example because it was deleted, keeps its size and shows the <span class=\"tn-icon bx bx-error-alt\"></span> icon in place of the content, with the ID of the missing note or attachment. To remove the include, select it and press <kbd>Delete</kbd>.</p><p>Content added by a newer version of Trilium, which this version cannot show, appears the same way with the <span class=\"tn-icon bx bx-error\"></span> icon. Editing the note keeps that content unchanged, so it shows again once Trilium is updated.</p><h2>Included notes in the share functionality</h2><p>If a <a href=\"#root/_help_R9pX4DGra2Vt\">shared note</a> contains one or more included notes, they will be displayed in the content of the note as if they were part of the note itself. An include resized narrower than the note keeps its width and its position. On a narrow screen, an include with a position other than <em>Align center</em> takes the full width. The caption of an include is shown under the included content. A <em>Tiny</em> include is shown as a link to the included note instead, and so is an include that would show a note already shown around it, such as a note that includes itself. The same goes for a printed or exported note.</p><p>For this to work, the included notes must also be shared. However, they can still be hidden from the note tree via <code>#shareHiddenFromTree</code>.</p><p>An include whose note or attachment is missing or not shared shows <em>This content is not available</em> in its place, and so does content added by a newer version of Trilium.</p><h2>Interactive notes</h2><p>Since v0.104.0, included notes might become interactive depending on their note type:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> (e.g. <a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>) will render fully interactive, including creating new notes.</li><li><a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> will also display the results.</li><li><a class=\"reference-link\" href=\"#root/_help_1vHRoWCEjj0L\">Web View</a> provides an interactive preview of the website.</li></ul><h2>Included images</h2><p>An included image, whether an image note or an image attachment, is shown in the image viewer, which zooms and pans it:</p><ul><li>To zoom, press the <span class=\"tn-icon bx bx-plus-circle\"></span> <em>Zoom in</em> and <span class=\"tn-icon bx bx-minus-circle\"></span> <em>Zoom out</em> buttons in the bottom-right corner of the image, or pinch on a touch screen. The percentage between them resets the zoom.</li><li>To zoom with the mouse wheel, click the image first. Until then, the mouse wheel scrolls the note.</li><li>To pan an image that is zoomed in, drag it. At its fitted size, dragging the image on a touch screen scrolls the note.</li><li>To return to the fitted size, double-click the image.</li></ul><p>In a <em>Small</em> or <em>Medium</em> box, the image is scaled down to fit the height of the box. In fullscreen, it fits the screen.</p><h2>Editing an include in place</h2><p>An included text note, an included code note and an embedded code file such as a <code>.js</code>, <code>.py</code> or <code>.txt</code> attachment can be edited without leaving the note that includes them. Until then, a code note or file is shown read-only in the code editor, where its code can be selected and copied, and its blocks folded and unfolded with the arrows in its gutter. Included Markdown can be edited too, see <em>Included Markdown</em> below.</p><ul><li>To edit, select the include and turn on the <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> button at the start of its toolbar, or check <em>Editable</em> in its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu. Turn <em>Editable</em> off to stop editing.</li><li>While <em>Editable</em> is on, the arrow keys move the caret into the include and back out, as through the rest of the text. Entering from above or from the left puts the caret at the start of the include, and entering from below or from the right puts it at the end. A collapsed <em>Expandable</em> include is skipped.</li><li>While an included text note has the focus, the formatting toolbar applies to it. The notes it includes in turn stay read-only.</li><li>Code is edited in the same code editor as a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note, with its theme, indentation and line wrapping settings.</li><li>Typing <code>/</code> in the code lists the <a class=\"reference-link\" href=\"#root/_help_IEgsWp5hHH35\">Code Snippets</a> of its language, as in a code note.</li><li>The toolbar of an included code note or an embedded code file also has the language and indentation menus of the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, between <em>Editable</em> and the <span class=\"tn-icon bx bx-move-vertical\"></span> <em>Box size</em> menu: <em>Change language mode</em>, which shows the current language, and <em>Change tab width</em>, which shows the current indentation. <em>Re-indent content to</em> converts the indentation of the code itself and saves it to the included note or file, whether <em>Editable</em> is on or off.<ul><li>For an included note, the menus change the note, as they do in its own tab.</li><li>For an embedded code file, the language and indentation settings change only how this include shows the file, and are saved with the note that includes it. The language replaces the one that the file name gives, and the <em>Use default</em> entries return to the indentation set in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em>. These settings leave the file itself unchanged, and other includes of it keep their own settings.</li></ul></li><li>The <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu of an included code or Markdown note, an embedded code or Markdown file and a <a href=\"#root/_help_CohkqWQC1iBv\">Mermaid diagram</a> has two more submenus after <em>Editable</em>, each with <em>Auto</em>, <em>On</em> and <em>Off</em>. They change how the code editor shows the source.<ul><li><em>Word wrap</em> wraps long lines instead of scrolling them. <em>Auto</em> follows the setting in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em>. For an included note, it sets the <code>#wrapLines</code> label of the note, as the <em>Word wrap</em> submenu of its <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> does for a code note. For an embedded file or a Mermaid diagram, it changes only this include.</li><li><em>Line numbers</em> shows or hides the numbers at the start of each line. <em>Auto</em> follows the setting in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em>. It changes only this include, for an included note as well.</li></ul></li><li>The changes are saved as you type, to the included note or to the attachment, as they would be in its own tab.</li><li>The changes made in the code editor of an include are part of the undo history of the note that includes it, together with the changes to its text, in the order they were made. This includes the source of included Markdown and of a <a href=\"#root/_help_CohkqWQC1iBv\">Mermaid diagram</a>, and the changes to a drawing canvas (see below).<ul><li><kbd>Ctrl</kbd>+<kbd>Z</kbd> undoes the last change of the note, and <kbd>Ctrl</kbd>+<kbd>Y</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd> redoes it, whether the caret is in the text or in an include, and also while <em>Editable</em> is off. The <span class=\"tn-icon cke cke-undo\"></span> <em>Undo</em> and <span class=\"tn-icon cke cke-redo\"></span> <em>Redo</em> buttons of the formatting toolbar do the same. With the Vim key bindings, <code>u</code> and <kbd>Ctrl</kbd>+<kbd>R</kbd> in an include do the same too.</li><li>The focus moves to the change that was undone or redone: into the code editor or the drawing canvas of the include, or back to the text.</li><li>Undoing a change of an included note saves the included note again. Once the included note has been changed elsewhere, for example in another tab, its earlier changes can no longer be undone from here, and undo skips them.</li><li>An included text note keeps an undo history of its own.</li></ul></li><li>An include of <a class=\"reference-link\" href=\"#root/_help_klC3ilXa9kUE\">Block references</a> edits only the referenced blocks.</li><li>Editing is not available in a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only note</a>, for an included note marked <code>#readOnly</code>, or for an attachment of another note.</li><li><a class=\"reference-link\" href=\"#root/_help_McngOG2jbUWX\">Search in note</a> finds the text of included text and code notes among the results of the note around them, and replaces it while <em>Editable</em> is on.</li></ul><h2>Included Markdown</h2><p>An included <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> note and an embedded Markdown file, such as a <code>.md</code> attachment, are shown with the same three views as a Markdown note in its own tab (see <a class=\"reference-link\" href=\"#root/_help_SL5f1Auq7sVN\">Note types with split view</a>): <span class=\"tn-icon bx bx-code\"></span> <em>Source view</em>, <span class=\"tn-icon bx bxs-dock-left\"></span> <em>Split view</em> and <span class=\"tn-icon bx bx-show\"></span> <em>Preview</em>.</p><ul><li>To switch the view, press one of the three buttons in the title row of the include. In a note being edited, the toolbar of the include has the same buttons after <em>Editable</em>, and its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu has them as <em>Source view</em>, <em>Split view</em> and <em>Preview</em>.</li><li>Until a view is chosen, the include shows the <em>Preview</em>, and the <em>Split view</em> while <em>Editable</em> is on.</li><li>To edit the Markdown, turn on <em>Editable</em> (see <em>Editing an include in place</em> above). The source is edited in the code editor of a Markdown note, and the preview follows the changes as you type. While <em>Editable</em> is off, the source can be read and copied but not changed.</li><li>The source has the slash commands and the <code>@</code> and <code>[[</code> note links of a <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> note. A note created from the <code>@</code> or <code>[[</code> list goes under the included note, or for an embedded file under the note that includes it, and <code>/image</code> uploads the image to that same note.</li><li>The <em>Word wrap</em> and <em>Line numbers</em> submenus of the <em>More actions</em> menu change how the source shows, as for code (see <em>Editing an include in place</em> above).</li><li>As in a Markdown note, the preview scrolls along with the source and highlights the block where the cursor is, and <kbd>Ctrl</kbd>+<kbd>B</kbd>, <kbd>Ctrl</kbd>+<kbd>I</kbd>, <kbd>Ctrl</kbd>+<kbd>M</kbd> and <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>X</kbd> format the selection.</li><li>In a note being edited, the view is saved with the include, so two includes of the same note can show different views. In a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only note</a>, the view can be changed too, until the note is opened again.</li><li>While the source shows, and wherever the Markdown can be edited, the include has the height of its box size, or the height it was resized to, so turning <em>Editable</em> on or off keeps its size. Otherwise, as in a read-only note, the preview fits its text up to that height. A <em>Full</em> include fits its content instead.</li><li><a class=\"reference-link\" href=\"#root/_help_McngOG2jbUWX\">Search in note</a> searches the source while it shows, and the preview otherwise.</li></ul><h2>Drawing canvases</h2><p>A drawing canvas is an Excalidraw canvas, like the one of a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> note, drawn directly in the text note. It is not a note of its own: the drawing is kept in a <code>Canvas.excalidraw</code> <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> of the text note and is saved together with the text.</p><ul><li>To insert a drawing canvas, open the <span class=\"tn-icon cke cke-plus\"></span> <em>Insert</em> menu of the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> and choose <span class=\"tn-icon bx bx-pen\"></span> <em>Drawing canvas</em>, above <em>Mermaid diagram</em>. It is also available as <em>Drawing canvas</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>. The canvas is added empty and editable, in a <em>Medium</em> box with its title hidden, and takes the focus, ready for drawing.</li><li>To draw or write over an image, select the image and press the <span class=\"tn-icon bx bxs-pen\"></span> <em>Convert image to a drawing canvas</em> button of its toolbar. The image is replaced by an editable drawing canvas in a <em>Medium</em> box, with its title hidden and the focus in it. The image sits at its original size in the middle of the canvas, zoomed so that all of it shows, and is locked so that it cannot be selected or moved by accident. While it is locked, the canvas can be zoomed in on the image but not zoomed out past it or scrolled beyond its edges. To move or resize the image anyway, right-click it and choose <em>Unlock</em>. The caption of the image is kept, but not its alignment or link. Only an image on its own line can be converted, not one inside a paragraph. Undo brings the image back.</li><li>An Excalidraw file (<code>.excalidraw</code>) attached with <em>Attach and embed file</em>, under the <span class=\"tn-icon cke cke-paper-clip\"></span><em>Attach file</em> button, becomes a drawing canvas too, in a <em>Medium</em> box titled with the file name. It starts with <em>Editable</em> off, so the drawing shows but cannot be changed until <em>Editable</em> is turned on (see below).</li><li>To draw on a canvas that does not have the focus, click it first. Until then, touch gestures scroll the note. The canvas then has the tools, menus and keyboard shortcuts of a Canvas note. The toolbars, the menus and the properties of the selected shapes show only while the canvas has the focus, so elsewhere the drawing reads like a picture in the text.</li><li>The mouse wheel and the touchpad scroll the note over a canvas too, as over the text. To zoom, use the zoom buttons of the canvas toolbar; to move around the drawing, use the <span class=\"tn-icon bx bxs-hand\"></span> <em>Hand</em> tool. In fullscreen, the mouse wheel moves and zooms the drawing instead.</li><li>The canvas toolbar replaces the Excalidraw menu: <em>Export image</em>, <em>Find on canvas</em>, <em>Library</em> and <em>Help</em> are at the end of its <span class=\"tn-icon bx bx-category\"></span> <em>More tools</em> menu. In fullscreen, the Excalidraw menu shows again.</li><li>The changes to the drawing are part of the undo history of the text note (see <em>Editing an include in place</em> above). <kbd>Ctrl</kbd>+<kbd>Z</kbd>, <kbd>Ctrl</kbd>+<kbd>Y</kbd> and the <span class=\"tn-icon bx bx-undo\"></span> <em>Undo</em> and <span class=\"tn-icon bx bx-redo\"></span> <em>Redo</em> buttons of the canvas toolbar undo and redo the last change of the note, in the drawing or in the text.</li><li>A new drawing has the background color of the note. A background chosen from the Excalidraw menu replaces it.</li><li>To protect a finished drawing from accidental changes, select it and turn off the <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> button at the start of its toolbar, or uncheck <em>Editable</em> in its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu. The drawing then shows as a still picture, at the zoom and position it had, and can no longer be changed, zoomed or moved. To draw again, turn <em>Editable</em> back on.</li><li>The box sizes, resizing, the caption and the title work as for an included note, but the toolbar of a drawing leaves the box size, <em>Show title</em> and <em>Convert to link</em> to its <em>More actions</em> menu, which also sets its position (see <em>Positioning</em> above).</li><li>In the desktop layout, Excalidraw keeps its desktop interface however small the box is. In the mobile layout, a narrow or short box switches it to a compact interface. For more room, choose <em>Full</em>, or show the title and press <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Fullscreen</em>.</li><li>Pictures added to the drawing are stored in the same attachment. A converted image is kept as an image attachment of the note instead, named with a generated code.</li><li>In a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only note</a>, the drawing shows as a still picture too.</li><li>On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, the drawing is shown as a picture at its own size, up to the width its box was resized to, in light or dark colors to match the page. Each change to the drawing saves this picture as an SVG image attachment of the note, also named with a generated code, which the list of attachments shows under <em>Generated by Trilium</em>.</li></ul><h3>Limitations</h3><ul><li>The Excalidraw shape library is not saved for a drawing canvas.</li><li>Outside the editor, for example in a tooltip, when printing or in the list of attachments, the drawing is shown as a picture.</li><li>A drawing has no picture for shared pages until its first change, except one converted from an image. Until then, for example for an attached <code>.excalidraw</code> file, a shared page shows a link to download the drawing instead.</li><li>In Safari, the picture of a drawing on a shared page follows the light or dark appearance of the system rather than the theme chosen on the page.</li><li>A copy of a drawing canvas pasted in the same note shares the drawing with the original, so a change to one shows in the other only after the note is opened again. A copy pasted in another note gets a drawing of its own.</li></ul>",
"_help_CohkqWQC1iBv": "<p>Press the <span class=\"tn-icon cke cke-plus\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> to reveal special inserable items and blocks such as symbols, Math expressions and separators.</p><h2>Bookmarks</h2><p>See the dedicated <a class=\"reference-link\" href=\"#root/_help_oSuaNgyyKnhu\">Anchors</a> section.</p><h2>New child note</h2><p>Choose <span class=\"tn-icon bx bx-subdirectory-right\"></span> <em>New child note</em> to create an empty child note of the current note and insert a link to it at the cursor. The new note opens in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> with its title selected, so typing names it, and the link shows the new title. While the note is still empty, Quick edit offers the note types to turn it into.</p><p>The same action is available as <em>Create a new child note</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>. A child note of a protected note is protected too.</p><h2>Emoji</h2><figure class=\"image image-style-align-right image_resized\" style=\"width:42.4%;\"><img style=\"aspect-ratio:366/410;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Insert%20buttons_plus.png\" width=\"366\" height=\"410\"></figure><p>This feature allows inserting Unicode emoji characters. Simply select a category and a desired emoji to insert it.</p><p>Emojis can also be searched by their English name and the skin tone can be selected via a combo box to the right.</p><p>There is also the possibility of inserting emojis directly by typing <code>:</code> followed by a name of an emoji, triggering the display of a list of emojis. Simply use the arrow keys to select one and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to insert it.</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Insert%20buttons_plus.png\" width=\"272\" height=\"187\"><h2>Symbols</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:346/322;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Insert%20buttons_image.png\" width=\"346\" height=\"322\"></figure><p>Pressing the <span class=\"tn-icon cke cke-special-characters\"></span> button will reveal a popup window displaying a list of characters that are generally more difficult to insert directly from the keyboard, such as a subset of emojis, quotation characters, etc.</p><p>Interaction:</p><ul><li>Click on a character to insert it at the current cursor position.</li><li>The window can be dragged around by the top bar where the title is, to avoid it getting in the way of the text.</li><li>Click on the <em>Category</em> selector to filter the characters.</li></ul><h2>Multicolumn layout</h2><p>See the dedicated <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a> page.</p><h2>Extended code block</h2><p>Choose <span class=\"tn-icon bx bx-code-block\"></span> <em>Extended code block</em> to insert a code block that is edited as a code note. This entry is experimental and is shown only once it is turned on. See <em>Extended code blocks</em> in <a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.</p><h2>Math equations</h2><p>See the dedicated <a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> page.</p><h2>Drawing canvas</h2><p>Choose <span class=\"tn-icon bx bx-pen\"></span> <em>Drawing canvas</em> to draw on an Excalidraw canvas inside the text. See <em>Drawing canvases</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h2>Mermaid diagram</h2><p>Press the <span class=\"tn-icon cke cke-trilium-mermaid-insert\"></span> button to create an inline Mermaid diagram. The arrow next to it lists a template for each kind of diagram. The diagram is also available as <em>Mermaid diagram</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</p><p>This feature is quite similar to the <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> note types and is meant as an alternative to it for simple diagrams. For more complex diagrams, use the <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> feature for a dedicated Mermaid note.</p><figure class=\"image\"><img style=\"aspect-ratio:1174/358;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Insert%20buttons_image.png\" width=\"1174\" height=\"358\"></figure><p>A diagram shows in a box like the one of an included note, so it can be resized, given another box size (<em>Small</em>, <em>Medium</em> or <em>Full</em>) from its <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu or shown in fullscreen, as described in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><ul><li>The <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Editable</em> button at the start of the diagram's toolbar decides whether its source can be changed. While it is off, the source still shows, but read-only.</li><li>The buttons next to it choose what the diagram shows, as for a Mermaid note: <span class=\"tn-icon bx bx-code\"></span> <em>Source view</em> for the Mermaid source alone, <span class=\"tn-icon bx bxs-dock-left\"></span> <em>Split view</em> for the source with the diagram next to it, and <span class=\"tn-icon bx bx-show\"></span> <em>Preview</em> for the diagram alone. Its <em>More actions</em> menu offers the same choice.</li><li>The <em>Word wrap</em> and <em>Line numbers</em> submenus of its <em>More actions</em> menu change how the source shows, each with <em>Auto</em>, <em>On</em> and <em>Off</em>, as for an included code note (see <em>Editing an include in place</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>).</li><li>A new diagram starts editable, in <em>Split view</em>. The diagram updates a moment after you stop typing. If the source has an error, the error shows over the last diagram that worked, which stays dimmed, as in a Mermaid note. On desktop, drag the divider between the source and the diagram to resize them.</li><li>A diagram without a chosen view shows the source next to the diagram while it is editable, and the diagram alone otherwise. In a read-only note, the source can never be changed. A read-only note and the AI chat show a diagram in the same box, in the view it was saved with, and with the zoom buttons over the diagram instead of in a toolbar. A <em>Medium</em> or <em>Full</em> diagram also has a <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Fullscreen</em> button there, or over the source in the <em>Source</em> view.</li><li>To zoom, use the <span class=\"tn-icon bx bx-zoom-out\"></span> and <span class=\"tn-icon bx bx-zoom-in\"></span> buttons of the diagram's toolbar; the zoom level between them resets the zoom. In fullscreen, where the toolbar is hidden, the same buttons show over the diagram. Drag the diagram to move around it, and double-click it to reset the view. The mouse wheel scrolls the note until you click the diagram, and then zooms it.</li><li>While the source shows, the <span class=\"tn-icon bx bx-help-circle\"></span> <em>Mermaid syntax help</em> button at the end of the toolbar opens the help on <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a>, which links to the Mermaid syntax.</li><li>The changes made to the source of a diagram are part of the undo history of the text note, in the order they were made. <kbd>Ctrl</kbd>+<kbd>Z</kbd> and <kbd>Ctrl</kbd>+<kbd>Y</kbd> undo and redo them from the source as well as from the text, as described in <em>Editing an include in place</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</li></ul><p>The source of the diagram stays in the note as a Mermaid code block, so the diagram is exported to Markdown as a <code>mermaid</code> code block that other applications can show.</p><p>Diagrams created in earlier versions keep the view they were saved with, and open editable.</p><h2>YouTube video</h2><p>Choose <span class=\"tn-icon bx bxl-youtube\"></span> <em>YouTube video</em> to insert a YouTube video that can be watched inside the note. Paste the address of the video, then press <em>Insert video</em> or <kbd>Enter</kbd>. The video is inserted as a link preview in the <em>Embed</em> display mode, described in <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>. The same action is available as <em>Insert YouTube video</em> in the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</p><h2>Horizontal ruler</h2><p>This feature will display a horizontal line, generally useful to separate different sections of the text. To do so, press the <span class=\"tn-icon cke cke-horizontal-line\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>.</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Insert%20buttons_image.png\" width=\"502\" height=\"95\"><p>Alternatively, it's possible to insert a horizontal ruler by typing <code>---</code>.</p><h2>Page break</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:371/79;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Insert%20buttons_image.png\" width=\"371\" height=\"79\"></figure><p>Page breaks provide a way to force the next paragraph or block (table, image, etc.) to be displayed onto the next page when printing (either to a real printer to <a href=\"#root/_help_NRnIZmSMc5sj\">when exporting to PDF</a>).</p><p>Page breaks are marked in the editor with the words <em>Page break</em>, but they will not actually be shown when printed.</p><ul><li>To insert a page break, press the <span class=\"tn-icon cke cke-page-break\"></span> in the formatting toolbar.</li><li>To insert many page breaks at once, insert a page break first, click on it and press <kbd>Ctrl</kbd>+<kbd>C</kbd>. Then use <kbd>Ctrl</kbd>+<kbd>V</kbd>, to paste as many times as needed.</li></ul><h2>Date and time</h2><p>The <span class=\"tn-icon cke cke-trilium-date-time\"></span> button inserts the current date and time at the cursor, replacing the selected text if there is any. The inserted text takes the formatting of the text around it, so a date inserted inside bold text is bold too.</p><ul><li>To insert the date in the default format, press the button itself or press <kbd>Alt</kbd>+<kbd>T</kbd>.</li><li>To insert it in another format, press the arrow next to the button and pick a format from the list. Each entry shows the current date and time in that format: the default one, the date or the time alone, the date written out, and ISO 8601.</li><li>The same formats are offered by the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>: type <code>/date</code>, <code>/time</code>, <code>/now</code> or <code>/today</code>. The <em>Insert date/time</em> entry uses the default format, and shows what it inserts underneath; the other entries show their output in the title.</li></ul><p>The default format can be changed in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em>, using <a href=\"https://day.js.org/docs/en/display/format\">Day.js format tokens</a> (for example <code>DD.MM.YYYY HH:mm</code>).</p><h2>Icons</h2><p>Icons just like the ones for the <a href=\"#root/_help_p9kXRFAkwN4o\">note icon</a> can be inserted in text. For more information see <a class=\"reference-link\" href=\"#root/_help_hD8GawVuazff\">Icons</a>.</p>",
"_help_hD8GawVuazff": "<p>Icons just like the <a href=\"#root/_help_hD8GawVuazff\">note icons</a> can be inserted in the content of a note, including from any other <a href=\"#root/_help_gOKqSJgXLcIj\">custom icon packs</a>.</p><h2>Features</h2><ul><li>The icon can be formatted through the<a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a> tools of the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:<ul><li>Foreground/icon color</li><li>Background color/highlight</li><li>Font size</li></ul></li><li>Custom <a class=\"reference-link\" href=\"#root/_help_gOKqSJgXLcIj\">Icon Packs</a> are also supported.<ul><li>For emojis, prefer the Emoji functionality from <a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>.</li></ul></li><li>When an icon is clicked a floating toolbar appears with the following functions:<ul><li><span class=\"tn-icon bx bx-sticker\"></span> which changes the icon.</li><li><span class=\"tn-icon bx bx-reflect-horizontal\"></span> which applies transforms: rotate (90 / 180 / 270) and flip horizontal/vertical. Only one transform can be used per icon.</li></ul></li></ul><h2>Usage</h2><ul><li>The in-app help/user guide makes use of these icons in order to illustrate buttons in the UI.</li><li>The <a class=\"reference-link\" href=\"#root/_help_GnhlmrATVqcH\">Microsoft OneNote</a> importer also makes use of them for the <a class=\"reference-link\" href=\"#root/_help_LpvyEIBIAAj7\">Tags</a>.</li></ul><h2>Inserting an icon</h2><p>There are two ways to insert an icon:</p><ul><li>Via the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> look for the <span class=\"tn-icon bx bx-plus\"></span> icon and then the <span class=\"tn-icon bx bx-sticker\"></span> icon.</li><li>Via <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>, type <code>/icon</code>.</li></ul><p>An icon picker will appear, search for an icon and click it to insert it in the document.</p><h2>Finding notes by their icons</h2><p>An icon can be <a href=\"#root/_help_eIg8jdvaoNNd\">searched</a>. A note containing a <span class=\"tn-icon bx bx-star\"></span> icon can be found by searching for <code>star</code>, or its <code>iconClass</code> (<code>bx-star</code>).</p><p>To find the name of the icon, hover the mouse over an icon while in the icon picker.</p><h2>Markdown rendering</h2><p>When exporting to <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a>, the item will render as raw HTML representation of the icon as is used by Trilium:</p><pre><code class=\"language-text-html\"><span class=\"tn-icon bx bx-star\"></span></code></pre>",
"_help_oiVPnW8QfnvS": "<h2>Trilium-specific shortcuts</h2><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Bring up inline formatting toolbar (arrow keys ←,→ to navigate, Enter to apply)</td><td>Alt+F10</td><td>⌥+F10</td></tr><tr><td>Bring up block formatting toolbar</td><td>Alt+F10</td><td>⌥+F10</td></tr><tr><td>Create <a href=\"#root/_help_QEAPj01N5f7w\">external link</a></td><td>Ctrl+K</td><td>⌘+K</td></tr><tr><td>Create <a href=\"#root/_help_QEAPj01N5f7w\">internal (note) link</a></td><td>Ctrl+L</td><td>⌘+L</td></tr><tr><td>Inserts current date and time at caret position</td><td>Alt+T</td><td>⌥+T</td></tr><tr><td>Increase paragraph indentation</td><td>Tab</td><td>⇥</td></tr><tr><td>Decrease paragraph indentation</td><td>Shift + Tab</td><td>⇧ + ⇥</td></tr><tr><td>Mark selected text as <a href=\"#root/_help_UYuUB1ZekNQU\">keyboard shortcut</a></td><td>Ctrl + Alt + K</td><td>⌘+ ⌥+ K</td></tr><tr><td>Insert <a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a></td><td>Ctrl + M</td><td>⌘+ M</td></tr><tr><td>Move blocks (lists, paragraphs, etc.) up, or in a <a href=\"#root/_help_NdowYOC1GFKS\">table</a> the rows</td><td>Alt+↑</td><td>⌥+↑</td></tr><tr><td>Move blocks (lists, paragraphs, etc.) down, or in a <a href=\"#root/_help_NdowYOC1GFKS\">table</a> the rows</td><td>Alt+↓</td><td>⌥+↓</td></tr><tr><td>Move the selected content to another column of a <a class=\"reference-link\" href=\"#root/_help_wYDzQ1fBFgfT\">Multicolumn layout</a></td><td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td><td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td></tr><tr><td>Move the current column of a multicolumn layout</td><td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td><td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td></tr><tr><td>Add a column after or before the current one in a multicolumn layout</td><td>Ctrl+Enter, Ctrl+Shift+Enter</td><td>⌘+Enter, ⌘+⇧+Enter</td></tr><tr><td>Move the selected content to another tab in <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a></td><td>Ctrl+←, Ctrl+→, Ctrl+Shift+Home, Ctrl+Shift+End</td><td>⌘+←, ⌘+→, ⌘+⇧+Home, ⌘+⇧+End</td></tr><tr><td>Move the current tab of a tabs block</td><td>Ctrl+Alt+←, Ctrl+Alt+→, Ctrl+Alt+Home, Ctrl+Alt+End</td><td>⌘+⌥+←, ⌘+⌥+→, ⌘+⌥+Home, ⌘+⌥+End</td></tr><tr><td>Add a tab after or before the current one in a tabs block</td><td>Ctrl+Enter, Ctrl+Shift+Enter</td><td>⌘+Enter, ⌘+⇧+Enter</td></tr></tbody></table></figure><h2>Common shortcuts</h2><aside class=\"admonition tip\"><p>This section of keyboard shortcuts presents a subset of the keyboard shortcuts as supported by the editor technology we are using, <a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a>. The shortcuts were taken from the <a href=\"https://ckeditor.com/docs/ckeditor5/latest/features/accessibility.html#keyboard-shortcuts\">official documentation</a>. Note that not all the shortcuts in the original documentation are applicable (due to using a different configuration).</p></aside><h3>Content editing</h3><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Insert a hard break (a new paragraph)</td><td>Enter</td><td></td></tr><tr><td>Insert a soft break (a <code><br></code> element)</td><td>Shift+Enter</td><td>⇧Enter</td></tr><tr><td>Copy selected content</td><td>Ctrl+C</td><td>⌘C</td></tr><tr><td>Paste content</td><td>Ctrl+V</td><td>⌘V</td></tr><tr><td>Paste content as plain text</td><td>Ctrl+Shift+V</td><td>⌘⇧V</td></tr><tr><td>Undo</td><td>Ctrl+Z</td><td>⌘Z</td></tr><tr><td>Redo</td><td>Ctrl+Y, Ctrl+Shift+Z</td><td>⌘Y, ⌘⇧Z</td></tr><tr><td>Bold text</td><td>Ctrl+B</td><td>⌘B</td></tr><tr><td>Change text case</td><td>Shift+F3</td><td>⇧F3 (may require Fn)</td></tr><tr><td>Create link</td><td>Ctrl+K</td><td>⌘K</td></tr><tr><td>Move out of a link</td><td>←←, →→</td><td></td></tr><tr><td>Move out of an inline code style</td><td>←←, →→</td><td></td></tr><tr><td>Select all</td><td>Ctrl+A</td><td>⌘A</td></tr><tr><td>Find in the document</td><td>Ctrl+F</td><td>⌘F</td></tr><tr><td>Copy text formatting</td><td>Ctrl+Shift+C</td><td>⌘⇧C</td></tr><tr><td>Paste text formatting</td><td>Ctrl+Shift+V</td><td>⌘⇧V</td></tr><tr><td>Italic text</td><td>Ctrl+I</td><td>⌘I</td></tr><tr><td>Strikethrough text</td><td>Ctrl+Shift+X</td><td>⌘⇧X</td></tr><tr><td>Underline text</td><td>Ctrl+U</td><td>⌘U</td></tr><tr><td>Revert autoformatting action</td><td>Backspace</td><td></td></tr></tbody></table></figure><h3>Interacting with blocks</h3><p>Blocks are images, tables, blockquotes, annotations.</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Insert a new paragraph directly after a widget</td><td>Enter</td><td></td></tr><tr><td>Insert a new paragraph directly before a widget</td><td>Shift+Enter</td><td>⇧Enter</td></tr><tr><td>Move the caret to allow typing directly before a widget</td><td>↑, ←</td><td></td></tr><tr><td>Move the caret to allow typing directly after a widget</td><td>↓, →</td><td></td></tr><tr><td>After entering a nested editable, move the selection to the closest ancestor widget. For example: move from an image caption to the whole image widget.</td><td>Tab then Esc</td><td></td></tr></tbody></table></figure><p>Specifically for lists:</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Increase list item indent</td><td>⇥</td><td></td></tr><tr><td>Decrease list item indent</td><td>Shift+⇥</td><td>⇧⇥</td></tr></tbody></table></figure><p>In tables:</p><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Move the selection to the next cell</td><td>⇥</td><td></td></tr><tr><td>Move the selection to the previous cell</td><td>Shift+⇥</td><td>⇧⇥</td></tr><tr><td>Insert a new table row (when in the last cell of a table)</td><td>⇥</td><td></td></tr><tr><td>Navigate through the table</td><td>↑, →, ↓, ←</td><td></td></tr></tbody></table></figure><h3>General UI shortcuts</h3><figure class=\"table\"><table><thead><tr><th>Action</th><th>PC</th><th>Mac</th></tr></thead><tbody><tr><td>Close contextual balloons, dropdowns, and dialogs</td><td>Esc</td><td></td></tr><tr><td>Open the accessibility help dialog</td><td>Alt+0</td><td>⌥0</td></tr><tr><td>Move focus between form fields (inputs, buttons, etc.)</td><td>⇥, Shift+⇥</td><td>⇥, ⇧⇥</td></tr><tr><td>Move focus to the toolbar, navigate between toolbars</td><td>Alt+F10</td><td>⌥F10 (may require Fn)</td></tr><tr><td>Navigate through the toolbar or menu bar</td><td>↑, →, ↓, ←</td><td></td></tr><tr><td>Navigate to the next focusable field or an element outside the editor</td><td>Tab, Shift+Tab</td><td></td></tr><tr><td>Execute the currently focused button. Executing buttons that interact with the editor content moves the focus back to the content.</td><td>Enter, Space</td><td></td></tr><tr><td>Move focus in and out of an active dialog window</td><td>Ctrl+F6</td><td>⌘F6 (may require Fn)</td></tr></tbody></table></figure>",
"_help_UmgZAfcltxkS": "<p>Link previews turn a pasted URL into a rich, metadata-aware widget that can be displayed in three visual modes:</p><h2>Display modes</h2><p>A link preview can be displayed in one of three modes:</p><ul><li><strong>Inline</strong> — a link showing the site's favicon and page title (quite similar to <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>). Use this when you want the link to flow with the surrounding paragraph.</li><li><strong>Card</strong> — a block-level preview with thumbnail, title, description, and site name. Use this when the link is the focus of a paragraph.</li><li><strong>Embed</strong> — a block-level interactive embed.<ul><li>Currently supported for YouTube videos, which render interactively (via an <code>iframe</code>).</li><li>To prevent unwanted remote requests, the video is shown only after clicking on it first. Until then, the video's thumbnail is shown with a play button.</li><li>The video can be resized and aligned (see <em>Videos</em> below).</li></ul></li></ul><div class=\"trilium-multicolumn-layout\" data-trilium-column-ratios=\"1-1-1\"><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:251/42;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Link%20Previews_image.png\" width=\"251\" height=\"42\"><figcaption><em>Inline</em> link preview</figcaption></figure></div><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:1217/196;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Link%20Previews_image.png\" width=\"1217\" height=\"196\"><figcaption><em>Card</em> link preview</figcaption></figure></div><div class=\"trilium-multicolumn-column\"><figure class=\"image image_resized\" style=\"width:100%;\"><img style=\"aspect-ratio:994/563;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Link%20Previews_image.png\" width=\"994\" height=\"563\"><figcaption><em>Embed</em> link preview</figcaption></figure></div></div><h2>Inserting a link preview</h2><p>There are four ways to create one:</p><h3>1. By pasting a URL</h3><p>A link preview is automatically created:</p><ul><li>By pasting the URL and pressing <kbd>Space</kbd>. This will create an <em>inline</em> link preview.</li><li>When at the start of a new paragraph, pressing <kbd>Enter</kbd> will create a <em>card</em> or an <em>embed</em> for YouTube URLs.</li></ul><p>To undo an automatic link preview, press <kbd>Ctrl</kbd>+<kbd>Z</kbd> immediately afterwards which keeps it as a plain link instead. Alternatively, once a link preview was created, click on the link and select <em>Plain link</em> from the link preview toolbar.</p><p>This automatic conversion can be disabled by going to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> and unchecking <em>Autogenerate link previews</em> from the <em>Features</em> section.</p><p>If the link is not accessible to the Trilium server (or the network request fails for any other reason), it will not be converted to a link preview.</p><aside class=\"admonition note\"><p>A URL is only auto-converted when the pasted text <em>is</em> the URL. Links with a display name (e.g. <a href=\"https://triliumnotes.org\">Trilium Notes website</a>) are left as plain links.</p></aside><h3>2. From the link dialog</h3><p>Since v0.107.0, a link preview is created from the same <em>Add link</em> dialog as any other link (see <a class=\"reference-link\" href=\"#root/_help_3IDVtesTQ8ds\">External links</a>):</p><ul><li>Press <span class=\"tn-icon cke cke-link\"></span> in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, or press <kbd>Ctrl</kbd>+<kbd>K</kbd>, to open the dialog on <em>Web link</em>.</li><li>Type or paste the address, then pick the preview in <em>Display as</em>: <em>Inline</em>, <em>Card</em> or, for a YouTube video, <em>YouTube embed</em>. <em>Plain link</em> inserts an ordinary link. <em>Display as</em> is not shown when text is selected, since the link then keeps the selected text.</li><li>Optionally, type a <em>Link title</em> to show instead of the page's own title. A <em>Card</em> also offers a <em>Description</em> to show instead of the page's own description.</li><li>Press <kbd>Enter</kbd> or <em>Insert link</em> to confirm. The link appears right away and turns into the preview once Trilium has read the page.</li></ul><p>Alternatively, use <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a> and look for <em>link preview</em> (it is also found by <em>embed</em>, <em>url</em> or <em>video</em>). It opens the same dialog with a preview already picked: a <em>YouTube embed</em> for a YouTube video, a <em>Card</em> for any other page.</p><p>To turn an existing link into a preview, open its <em>Edit link</em> dialog and change <em>Display as</em>. A link whose text differs from its address keeps that text as the title of the preview.</p><h3>3. From the Insert menu, for a YouTube video</h3><p>Choose <span class=\"tn-icon bx bxl-youtube\"></span> <em>YouTube video</em> from the <a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a> menu, or <em>Insert YouTube video</em> from the <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>. Paste the address of the video and press <em>Insert video</em> or <kbd>Enter</kbd> to insert it as an <em>Embed</em>. The <span class=\"tn-icon bx bx-paste\"></span> <em>Paste</em> button at the end of the field replaces its text with the text on the clipboard. This button is shown only where Trilium can read the clipboard: in the desktop app, and in a browser over HTTPS unless access to the clipboard was blocked. The video is inserted once its title and thumbnail have loaded, which can take a few seconds. When they cannot be loaded, an error is shown and the prompt stays open. Opening another note in the meantime cancels the insertion.</p><h3>4. By saving browser tabs from the Web Clipper</h3><p>When the <a class=\"reference-link\" href=\"#root/_help_MtPxeAWVAzMg\">Web Clipper</a> saves the tabs of a window, each tab becomes an <em>inline</em> link preview showing the title and favicon the browser displays for it. Because this data comes from the browser, pages behind a login keep their real title, and the Trilium server does not contact the saved pages.</p><p>When <em>Autogenerate link previews</em> is turned off, the tabs are saved as a list of plain links instead.</p><h2>Altering an existing link preview</h2><p>Click on an inserted <em>Inline</em> or <em>Card</em> link preview to select it, and a small toolbar will appear with the following options:</p><ul><li>The normal link operations (opening in a new tab, copying the link, unlinking).</li><li>The <span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> button, which opens the <em>Edit link</em> dialog on the link preview, as does pressing <kbd>Ctrl</kbd>+<kbd>K</kbd> while it is selected. The dialog changes its address, its <em>Link title</em> (especially useful if the title is hidden behind a login screen), the <em>Description</em> of a card and how it is displayed. A new address shows the title and description of the new page, unless you type your own.</li><li>A way to switch between the link preview modes (Inline, Card or Embed) as well as to convert it to a normal link instead.<ul><li>The Embed option is only enabled when the URL points to a supported service (YouTube today).</li></ul></li></ul><h3>Videos</h3><p>A YouTube video shown as an <em>Embed</em> has a size, a position, a title and a caption, like an <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>. It keeps the shape of the video, so a YouTube Short stands upright and an older video can be 4:3. A video inserted in an earlier version is 16:9 until it is inserted again. In the editor, a click on the video both plays it and selects it, and so does a later click on the player. The toolbar of a selected video offers:</p><ul><li><span class=\"tn-icon cke cke-trilium-copy\"></span> <em>Copy URL</em>.</li><li>The <em>Display</em> menu, which turns the video into an <em>Inline</em> or <em>Card</em> link preview, or a <em>Plain link</em>. The text of its caption stays, as a paragraph after it.</li><li>The <span class=\"tn-icon cke cke-three-vertical-dots\"></span> <em>More actions</em> menu:<ul><li><span class=\"tn-icon bx bx-link-external\"></span> <em>Open externally</em> opens the video outside Trilium: in the browser, or in the app that handles the link, such as the YouTube app on Android.</li><li><em>Size</em>: a <em>Medium</em> video can be resized, a <em>Full</em> video takes the width of the note, or less when it would be taller than most of the window. A new video is <em>Medium</em>. A video inserted in an earlier version is <em>Full</em>.</li><li><em>Position</em>: under <em>Break text</em>, <span class=\"tn-icon cke cke-object-left\"></span> <em>Align left</em>, <span class=\"tn-icon cke cke-object-center\"></span> <em>Align center</em> and <span class=\"tn-icon cke cke-object-right\"></span> <em>Align right</em> place the video on lines of its own, at that side of the note. Under <em>Wrap text</em>, <span class=\"tn-icon cke cke-object-inline-left\"></span> <em>Align left</em> and <span class=\"tn-icon cke cke-object-inline-right\"></span> <em>Align right</em> place it at that side and let the text run beside it. <em>Align center</em> is the default.</li><li><em>Show title</em> shows the title of the video above it, as a link to the video. The <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button of the title opens this same menu.</li><li><em>Show caption</em> adds a caption under the video, centered, and puts the cursor in it. The caption is part of the text note, so it can be formatted like the rest of the text. While the cursor is in the caption, the video stays selected and keeps its toolbar. Choosing <em>Show caption</em> again removes the caption.</li><li><span class=\"tn-icon bx bx-trash\"></span> <em>Delete</em> removes the video from the note.</li></ul></li></ul><p>To resize a <em>Medium</em> video, select it and drag the handle in its bottom-right corner, or its bottom-left corner for a video aligned to the right. The height follows the width. Choosing <em>Medium</em> again returns the video to its first size.</p><p>On a <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a>, the video keeps its width, position and caption, but not its title. In the mobile layout, a video with a position other than <em>Align center</em> takes the full width.</p><h2>Where the preview data comes from</h2><p>When you insert a link preview, Trilium fetches metadata once and stores it with the note:</p><ul><li><strong>YouTube URLs</strong>: the title, the channel name and the shape of the video are fetched via YouTube's public oEmbed endpoint, and the video's thumbnail is downloaded at up to 1280×720.</li><li><strong>All other URLs</strong>: Trilium fetches the page and reads OpenGraph tags (<code>og:title</code>, <code>og:description</code>, <code>og:image</code>, <code>og:site_name</code>), falling back to the page's <code><title></code> and <code><meta name=\"description\"></code>. The site's favicon and the page's image are downloaded as well.</li></ul><p>The text is kept in the note's HTML. The images are kept as system <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> of the note, listed under <em>Generated by Trilium</em>.</p><p>Because the data is stored in the note itself, link previews continue to render correctly when you reopen the note, share/publish it, or export to HTML — without any further network requests.</p><p>The metadata is captured <strong>at insertion time</strong> and is not automatically refreshed. If the linked page later changes its title or thumbnail, you'll need to re-insert the link to pick up the new values. To refresh a link, simply create it again.</p><p>A YouTube embed inserted before v0.107.0 keeps its smaller thumbnail, shown blurred, until the link is inserted again.</p><p>When accessing a <a class=\"reference-link\" href=\"#root/_help_WOcw2SLH6tbX\">Server Installation</a>, the data is fetched from the remote URL by the server and not the client.</p><h2>Known limitations</h2><ul><li>The Embed display mode currently only supports YouTube. Other video and media platforms fall back to a Card preview.</li><li>Pages that block automated fetches may produce a minimal preview (hostname only).</li><li>Link previews require the Trilium server to reach the target URL, so they won't generate previews for pages on networks the server can't see.</li></ul>",
"_help_QEAPj01N5f7w": "<p>There are two types of links:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_3IDVtesTQ8ds\">External links</a>, for standard hyperlinks to websites or other resources.</li><li><a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> for links to other notes within Trilium.<ul><li>The list of notes that refer to a particular note is called <a class=\"reference-link\" href=\"#root/_help_wfGXLmm7x27z\">Backlinks</a>.</li></ul></li></ul><h2>Note map</h2><p>Trilium provides a visualization of incoming and outgoing links for a particular note. See <a href=\"#root/_help_BCkXAVs63Ttv\">note map</a> for details.</p>",
"_help_3IDVtesTQ8ds": "<p>An external link is a standard web link targeting for example a website. For example, <a href=\"https://en.wikipedia.org/wiki/South_China_Sea\">https://en.wikipedia.org/wiki/South_China_Sea</a> is an external link to a Wikipedia page.</p><p>To create a link without a custom text:</p><ul><li>Press <span class=\"tn-icon cke cke-link\"></span> in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, or press <kbd>Ctrl</kbd>+<kbd>K</kbd>:<ul><li>Since v0.107.0, the <em>Add link</em> dialog opens on <em>Web link</em>, in a popup next to the cursor on desktop. Type or paste the address, and optionally a <em>Link title</em>; without one, the link shows its address. The <span class=\"tn-icon bx bx-paste\"></span> <em>Paste</em> button at the end of the address field replaces its text with the text on the clipboard. This button is shown only where Trilium can read the clipboard: in the desktop app, and in a browser over HTTPS unless access to the clipboard was blocked.</li><li><em>Display as</em> inserts the address as a <em>Plain link</em>, or as one of the <a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a>: <em>Inline</em>, <em>Card</em> or, for a YouTube video, <em>YouTube embed</em>.</li><li>Press <kbd>Enter</kbd> or <em>Insert link</em> to confirm.</li></ul></li><li>A simpler way is to paste the raw link and press space to turn it automatically into a link.</li><li>The <span class=\"tn-icon cke cke-trilium\"></span> button and <kbd>Ctrl</kbd>+<kbd>L</kbd> of <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> open the same dialog on <em>Note</em>. Select <em>Web link</em> at the top of the dialog to create an external link from there.</li></ul><p>An address without a scheme, such as <code>example.com</code>, gets <code>https://</code>. A URL pasted into the <em>Note</em> field, or picked from its search, switches the dialog to <em>Web link</em>. The dialog also opens on <em>Web link</em> when the selected text is a URL.</p><p>To create a link with a custom text:</p><ul><li>First, type and select the text which will be turned into a link.</li><li>Open the <em>Add link</em> dialog as above (via the formatting toolbar, or <kbd>Ctrl</kbd>+<kbd>K</kbd>). The selected text becomes the text of the link, so the dialog does not offer <em>Display as</em>.</li><li>Alternatively, simply paste (<kbd>Ctrl</kbd>+<kbd>V</kbd>) over the selected text to turn it into a link.</li></ul><p>Once a link is inserted:</p><ul><li>The text inside the link can be changed if needed but the link itself will remain.</li><li>To modify the link, click on the link to display the popup and press the <span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> button. It opens the <em>Edit link</em> dialog, filled with the link's address and text, as do placing the cursor inside the link and pressing <kbd>Ctrl</kbd>+<kbd>K</kbd>, <kbd>Ctrl</kbd>+<kbd>L</kbd> or one of the link buttons. <em>Save link</em> changes the whole link, its text included, and the dialog can also turn it into a link to a note.</li><li>To remove a link, click on it and press the <span class=\"tn-icon cke cke-unlink\"></span> <em>Unlink</em> button.</li></ul><p>You can follow external link by either double clicking (will open new tab/window) it or right clicking on them and choosing \"Open in new tab\".</p>",
"_help_hrZ1D00cLbal": "<p>Internal links are links to other notes within Trilium.</p><p>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.</p><p>Since v0.107.0, clicking an internal link while editing a text note shows its popup instead, as clicking an external link does:</p><ul><li><em>Open note</em> opens the linked note, or <em>Open attachment</em> for a link to an attachment. A link into the same note reads <em>Jump to heading</em>, <em>Jump to block</em> or <em>Jump to anchor</em> instead, and scrolls to it without leaving the note.</li><li><span class=\"tn-icon cke cke-trilium-copy\"></span> <em>Copy URL</em> copies the address of the link.</li><li><span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> changes the link, as described below.</li><li><span class=\"tn-icon cke cke-unlink\"></span> <em>Unlink</em> turns the link into plain text.</li></ul><p>To open the note in a new tab without the popup, <kbd>Ctrl</kbd>+click or double-click the link. The preview does not show while the popup is open.</p><h2>Inserting internal links</h2><p>Internal links can be created at the current position in a text note by:</p><ol><li>Pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the <span class=\"tn-icon cke cke-trilium\"></span> button underneath the <span class=\"tn-icon cke cke-plus\"></span> menu in the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>. On desktop, the <em>Add link</em> dialog opens in a popup next to the cursor.</li><li>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 either <em>Create note</em>, which places it in the <a class=\"reference-link\" href=\"#root/_help_S0Fos78ZfcY7\">Note Inbox</a> (today's day note, or the top level, when no inbox is set), or <em>Create child note</em>, which places it under the note being edited.</li></ol><p>There are two link types, depending on the <em>Link title</em> field of the dialog:</p><ol><li>When the link title is not set, the link will display the title of the note. If the title of the note gets changed, the link will be renamed automatically to the new name.<ol><li>This is sometimes also called \"reference link\".</li><li>The icon of the linked note will also be displayed.</li><li>If the linked note is deleted, the link keeps the last title it showed, in red and with a <span class=\"tn-icon bx bx-x\"></span> icon instead of the note icon. Clicking it while editing opens the <em>Fix link</em> dialog, which searches for that title; picking a note, or creating a new one, replaces the link with one to that note.</li></ol></li><li>When a link title is typed, the link shows that text instead.<ol><li>This will create a traditional hyperlink, where the text of the link can be different from the note title.</li></ol></li></ol><p>Since v0.107.0, to change a link, click it and press the <span class=\"tn-icon cke cke-pencil\"></span> <em>Edit link</em> button in its popup. For a link with a title of its own, placing the cursor inside it and pressing <kbd>Ctrl</kbd> + <kbd>L</kbd> or the <span class=\"tn-icon cke cke-trilium\"></span> button works too. The <em>Edit link</em> dialog opens on the linked note, with its anchor and, for a link with a title of its own, the link's text; <em>Save link</em> changes the whole link. Emptying the <em>Link title</em> there turns the link into one that displays the title of the note, and typing one gives it a title of its own.</p><h2>In-place linking</h2><p>You can also insert internal links “inline” by using the <code>@</code> symbol:</p><ol><li>Type <code>@</code> in a text note, which will open the note search menu.</li><li>Search for the desired note's title by typing a few characters. Use <kbd>Up</kbd> and <kbd>Down</kbd> to select the correct note, and press <kbd>Enter</kbd> or <kbd>Tab</kbd> to create the link. It's also possible to create new notes with this method by typing a non-existing note title and selecting <em>Create note</em>, as described above, or <em>Create child note</em>. <em>Create child note</em> creates the note under the note being edited without asking for its type, inserts the link and opens the new note in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, which offers the note types to turn it into while it is still empty.</li></ol><p>To create an empty child note and link to it before naming it, use <em>New child note</em>, described in <a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>.</p><h2>Pasting internal links</h2><p>You can also insert internal links by copying a note from the note tree.</p><ol><li>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, select a note and press <kbd>Ctrl</kbd> + <kbd>C</kbd>.</li><li>In a text note, paste the link by pressing <kbd>Ctrl</kbd> + <kbd>V</kbd>.</li></ol>",
"_help_wfGXLmm7x27z": "<p>A link points from one note to another; a <em>backlink</em> is that same connection seen from the other end: the list of notes that refer to the current one.</p><p>Backlinks are maintained automatically and are read-only from this side. A backlink disappears when the note that created it removes the link; it cannot be deleted from the note being pointed at.</p><h2>What counts as a backlink</h2><p>Any <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> pointing at the current note, which covers two rather different cases:</p><ul><li>Relations that Trilium maintains on your behalf.<ul><li>The most common is <code>internalLink</code>, created whenever a note refers to another one through <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> in its text.</li><li>Embedded images (<code>imageLink</code>), relation map connections (<code>relationMapLink</code>) and note inclusions (<code>includeNoteLink</code>) work the same way.</li></ul></li><li>Relations you define yourself.<ul><li>If another note has <code>~author</code> pointing at the current note, that note is listed here as well.</li></ul></li></ul><p>Relations coming from a <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> are excluded, since a search stores an <code>ancestor</code> relation that would otherwise list every one of its results as a backlink.</p><aside class=\"admonition note\"><p>Only some note types have their content scanned for links: <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a>, <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a>, <a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a> and <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> chats. A link written inside a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note is not registered and will not appear as a backlink on the target note. A relation set manually on a code note does still count.</p></aside><h2>How entries are displayed</h2><p>Each entry names the note the reference comes from, followed by one of:</p><ul><li><strong>An excerpt</strong> of the surrounding content, with the link itself highlighted. This is available for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes and for <a class=\"reference-link\" href=\"#root/_help_GBBMSlVSOIGP\">AI</a> chat notes. Roughly 200 characters of context are quoted around the link, trimmed with an ellipsis where the surrounding text is longer, and images are left out.</li><li><strong>The name of the relation</strong>, for every other note type where the source cannot be quoted. This is the case for <a class=\"reference-link\" href=\"#root/_help_iRwzGnHPzonm\">Relation Map</a> notes and for any note carrying a relation you defined yourself.</li></ul><p>A note is listed once per reference it makes, so a note that links to the current one three times occupies three rows.</p><p>Of note:</p><ul><li>For AI chat notes, only the assistant's own prose is quoted. A chat that reached the note purely through tool calls has nothing to quote and is listed by relation name instead.</li><li>Excerpts are only generated for roughly the first 50 sources. On a heavily referenced note, the remaining entries fall back to showing the relation name.</li></ul><h2>Where backlinks are shown</h2><ul><li>In the <a class=\"reference-link\" href=\"#root/_help_KRlZFoIH0j6p\">Connections tab</a> of the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a>, as a dedicated section.</li><li>As a badge in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a> showing the number of backlinks. The badge only appears when the note is being read normally (not in a revision or attachment view) and when there is at least one backlink; pressing it opens the section above.</li><li>In <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, as a button with a link icon in the header of the popup, under the same conditions; its tooltip gives the number of backlinks. Pressing a backlink opens that note in the popup.</li><li>Incoming links are also drawn on the link map, see <a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>.</li></ul>",
"_help_S6Xx8QIWTV66": "<p>There are three types of lists supported by text notes:</p><ul><li><span class=\"tn-icon cke cke-bulleted-list\"></span> Bulleted lists (also known as unordered lists).</li><li><span class=\"tn-icon cke cke-numbered-list\"></span> Numbered lists (or ordered lists).</li><li><span class=\"tn-icon cke cke-todo-list\"></span> To-do lists</li></ul><p>For bulleted and numbered lists, it's possible to configure an alternative marker such as squares or Roman numbering by pressing the <span class=\"tn-icon cke cke-dropdown-arrow\"></span> icon. For numbered lists, it's also possible to specify the number to start at or whether to count in reverse order. On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, these are in the row of the <em>List ›</em> button, which shows while the cursor is in a list; its <em>List type</em> button also turns the list into another kind, to-do lists included.</p><h2>Keyboard interaction</h2><ul><li>To create a new list:<ul><li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed by a space;</li><li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed by a space;</li><li>To-do list: Start a line with <code>- [ ]</code> for an unchecked item or <code>[x]</code> for a checked item.</li></ul></li><li>To create a new item in the list, press <kbd>Enter</kbd>.</li><li>To create a blank line within a list item, press <kbd>Shift</kbd>+<kbd>Enter</kbd>.</li><li>To exit out of the list, press <kbd>Enter</kbd> twice.</li><li>To merge two lists, simply delete the gap between them.</li><li>To create nested lists, simply use the <span class=\"tn-icon cke cke-indent\"></span> button (see <em>Indentation</em> in <a class=\"reference-link\" href=\"#root/_help_dEHYtoWWi8ct\">Other features</a>) or the <kbd>Tab</kbd> key. To decrease the nesting level for the current element, press <kbd>Shift</kbd>+<kbd>Tab</kbd>.</li></ul><h2>Headings, code blocks within lists</h2><p>It possible to add content-level blocks such as headings, code blocks, tables within lists, as follows:</p><figure class=\"table\"><table><tbody><tr><td>1</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Lists_image.jpg\"></td><td>First, create a list.</td></tr><tr><td>2</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/4_Lists_image.jpg\"></td><td>Press Enter to create a new list item.</td></tr><tr><td>3</td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Lists_image.jpg\"></td><td>Press Backspace to get rid of the bullet point. Notice the cursor position.</td></tr><tr><td>4</td><td><img class=\"image_resized\" style=\"aspect-ratio:676/112;width:98.29%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/5_Lists_image.jpg\" width=\"676\" height=\"112\"></td><td>At this point, insert any desired block-level item such as a code block.</td></tr><tr><td>5</td><td><img class=\"image_resized\" style=\"aspect-ratio:675/129;width:94.22%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Lists_image.jpg\" width=\"675\" height=\"129\"></td><td>To continue with a new bullet point, press Enter until the cursor moves to a new blank position.</td></tr><tr><td>6</td><td><img class=\"image_resized\" style=\"aspect-ratio:675/129;width:100%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Lists_image.jpg\" width=\"675\" height=\"129\"></td><td>Press Enter once more to create the new bullet.</td></tr></tbody></table></figure><p>The same principle applies to all three list types (bullet, numbered and to-do).</p><h2>Sorting</h2><p>The items of a list can be sorted, nested items moving with the item they belong to. This is experimental, see <a class=\"reference-link\" href=\"#root/_help_0vgWgxQAWj4a\">Sorting</a>.</p><h2>Alignment</h2><p>A list item can be centered or aligned to the right, either with the text alignment button in the formatting toolbar or by aligning the <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a> cell that contains the list. The bullet, number or checkbox then moves together with the text of the item.</p><h2>To-do lists</h2><p>See <a class=\"reference-link\" href=\"#root/_help_fASfBrYnquKU\">To-do Lists</a>.</p><h2>Collapsible lists</h2><p>Starting with Trilium v0.104.0, it is possible to collapse nested list items. This applies to bullet lists, numbered lists as well as to-do lists.</p><p>To collapse or expand a list item that has nested sub-items:</p><ul><li>Using the mouse, move the cursor over the list item and an arrow will appear to its left. Clicking it will toggle between collapsed and expanded.</li><li>For bullet lists and numbered lists, it's also possible to click directly on the marker (e.g. the bullet or the number) instead of on the arrow to collapse or expand it. This won't work for to-do lists since this would toggle the to-do instead.</li><li>Press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Enter</kbd> which will toggle the collapse/expand state for the item at the cursor position.</li></ul><p>Of note:</p><ul><li>Collapsed items always show the arrow to indicate its state.</li><li>The collapsed state is saved at note level and synced across instances, which means that it will restore after a refresh or reopening of the application.</li><li>The collapsed state is also persisted in <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a>, but only for the HTML format. Markdown exports will not preserve the collapse state.</li><li>Collapsible bullets only exist in the context of editable text notes. Read-only lists will always be fully expanded.</li><li>The list items will auto-expand on edit to avoid typing in a hidden area.</li></ul>",
"_help_QrtTYPmdd1qq": "<p>Markdown-like formatting allows inserting some basic formatting by typing the Markdown equivalent. Note that this does not mean that <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes supports Markdown, these are just some convenience shortcuts.</p><p>To import more complex formatting into text notes, consider using the <a href=\"#root/_help_dEHYtoWWi8ct\"><em>Import from Markdown</em></a> function. For fully-fleged Markdown notes imports, consider using the dedicated <a href=\"#root/_help_Oau6X9rCuegd\">import</a> function.</p><ul><li>For <a href=\"#root/_help_Gr6xFaF6ioJ5\">headings:</a><ul><li><code>##</code> for Heading 2 (the first-level heading is reserved for the note title).</li><li><code>###</code> for Heading 3</li><li><code>####</code> for Heading 4</li><li><code>#####</code> for Heading 5</li><li><code>######</code> for Heading 6</li></ul></li><li>For <a class=\"reference-link\" href=\"#root/_help_Gr6xFaF6ioJ5\">General formatting</a>:<ul><li><strong>Bold</strong>: Type <code>**text**</code> or <code>__text__</code></li><li><em>Italic</em>: Type <code>*text*</code> or <code>_text_</code></li><li><del>Strikethrough</del>: Type <code>~~text~~</code></li></ul></li><li>For <a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a>:<ul><li>Bulleted list: Start a line with <code>*</code> or <code>-</code> followed by a space;</li><li>Numbered list: Start a line with <code>1.</code> or <code>1)</code> followed by a space;</li><li>To-do list: Start a line with <code>[ ]</code> for an unchecked item or <code>[x]</code> for a checked item.</li></ul></li><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">block quotes</a>, press <code>></code>, followed by a space.</li><li>For <a class=\"reference-link\" href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>, type <code>```</code>.</li><li>For a <a href=\"#root/_help_dEHYtoWWi8ct\">horizontal line</a>, type <code>---</code>.</li><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">admonitions</a>:<ul><li><code>!!! note</code></li><li><code>!!! tip</code></li><li><code>!!! important</code></li><li><code>!!! caution</code></li><li><code>!!! warning</code></li><li>Starting any other text with <code>!!!</code> will insert a note admonition with the text inside of it.</li></ul></li><li>For <a href=\"#root/_help_CohkqWQC1iBv\">emojis</a>, type <code>:</code> followed by an emoji name to trigger an auto-completion.</li></ul><p>If auto-formatting is not desirable, press <kbd>Ctrl</kbd> + <kbd>Z</kbd> to revert the text to its original form.</p>",
"_help_YfYAtQBcfo5V": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:350/193;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Math%20Equations_image.png\" width=\"350\" height=\"193\"></figure><p>Within text notes, it's possible to enter mathematical equations using the <span class=\"tn-icon cke cke-trilium-math\"></span> button from the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> (generally found under the <a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>).</p><p>By default, the math dialog includes a MathLive visual editor and a TeX field. Disable <em>MathLive visual editor</em> under Options → Text Notes → Features to use only the TeX field and preview.</p><p>Enabling <em>Display mode</em> will render the equation slightly bigger (especially if using big operators such as summation, or fractions) and center it. Display mode equations will act as blocks (i.e. like paragraphs, or tables) and can be inserted for example in lists. Non-display equations can be part of the text.</p><h2>Keyboard shortcuts</h2><p>If inserting equations frequently, using the <kbd>Ctrl</kbd>+<kbd>M</kbd> keyboard shortcut can be more comfortable. Alternatively, type <code>$$</code> or <code>\\[</code> to trigger the popup directly.</p><p>There is currently no quick way to turn an already typed-out equation, such as surrounding it with <code>$</code> or pressing <kbd>Ctrl</kbd>+<kbd>M</kbd>.</p><h2>Supported math features</h2><p>Technically we are using the KaTeX library which allows for a subset of the TeX format. To see the full list of supported features, consult the <a href=\"https://katex.org/docs/supported\">Supported Functions</a> and the <a href=\"https://katex.org/docs/support_table\">Support Table</a> from the official documentation.</p><h2>Markdown support</h2><p>Math equations will be preserved when exporting to or importing from Markdown, surrounded by <code>$</code> characters for inline math expressions, and <code>$$</code> for display mode.</p><p>If you notice any issue with the Markdown import/export for equations, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report</a> it while providing the equation that causes issues.</p><h2>Formatting the equation</h2><p>It is possible to customize the font size and foreground color for both inline and display-mode equations, just like any other text. For inline equations, the background color/highlight can also be adjusted.</p>",
"_help_wYDzQ1fBFgfT": "<p>A multicolumn layout arranges content in two to four columns, side by side. A column can hold any kind of content, including tables, images and another multicolumn layout.</p><h2>Inserting a layout</h2><ul><li>In the formatting bar, go to <em>Insert</em> → <span class=\"tn-icon cke cke-trilium-multicolumn\"></span> <em>Columns</em> to insert a layout with two columns. Its submenu offers <em>2 columns</em>, <em>3 columns</em> and <em>4 columns</em>.</li><li>Alternatively, type <code>/columns</code> and choose <em>2 columns layout</em>, <em>3 columns layout</em> or <em>4 columns layout</em>, as described in <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>.</li></ul><p>The columns of a new layout have equal widths. If text is selected when the layout is inserted, the selection moves into the first column.</p><h2>Changing the columns</h2><h3>Changing the layout</h3><p>While the cursor is inside a layout, a toolbar appears above it with a button that shows the current layout. Clicking it opens a row of figures, one for each available layout; hovering over a figure shows its number of columns and their widths:</p><figure class=\"table\"><table><thead><tr><th>Columns</th><th>Widths</th></tr></thead><tbody><tr><td>2</td><td>50%-50%, 25%-75%, 75%-25%</td></tr><tr><td>3</td><td>33%-33%-33%, 25%-50%-25%</td></tr><tr><td>4</td><td>25%-25%-25%-25%</td></tr></tbody></table></figure><ul><li>Choosing a layout with more columns adds empty columns at the end.</li><li>Choosing a layout with fewer columns removes the last columns and moves their content to the end of the last remaining column.</li></ul><h3>Adding columns</h3><p>While the cursor is in a column, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Enter</kbd>: Add a column after the current one.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd>: Add a column before the current one.</li></ul><p>The new column is empty and the cursor moves into it. All the columns then have equal widths. A layout has at most four columns, so the keys do nothing in a layout that already has four.</p><p><kbd>Ctrl</kbd> + <kbd>Enter</kbd> keeps its usual function on a link, in a to-do item and in the title of a collapsible block, and <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Enter</kbd> in a to-do item.</p><h3>Reordering columns</h3><p>While the cursor is anywhere inside a column, you can use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul><p>In a layout with two columns of different widths, the column keeps its width.</p><h2>Moving content between columns</h2><p>To move content to another column, select it, and then use these key combinations:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the column on the right.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the column on the left.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>End</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Home</kbd>: Move to the first column.</li></ul><p>Paragraphs, list items, tables and other blocks move whole, even when only part of them is selected. Content moved to a column on the left goes to the end of that column, and content moved to a column on the right goes to its start, so it keeps its place in the reading order.</p><p>Without a selection, these keys keep their usual function: moving the cursor by word, or selecting up to the start or end of the column.</p><p>When a layout and <a class=\"reference-link\" href=\"#root/_help_EK2ckIZ74tbT\">Content tabs</a> are nested in one another, the key combinations act on the one closest to the cursor.</p><h2>Removing a layout</h2><ul><li>To remove the layout but keep its content, click the <span class=\"tn-icon cke cke-remove\"></span> <em>Remove layout</em> button in the layout's toolbar. The content of the columns is placed one after another where the layout was, and empty columns are left out.</li><li>To delete the layout together with its content, click the handle at its top-left corner to select it, then press <kbd>Delete</kbd>.</li></ul><h2>Narrow screens</h2><p>When a layout has too little room for its columns (narrower than about 500 pixels, such as on a phone), the columns are stacked one below the other. While editing, alternating background colors tell the columns apart. This applies to each layout on its own, so a layout inside a narrow column is stacked while the outer one stays side by side.</p><h2>Printing and exporting</h2><ul><li>When printing or <a href=\"#root/_help_NRnIZmSMc5sj\">exporting to PDF</a>, the columns are printed side by side.</li><li>Markdown has no columns, so Markdown export keeps the layout and each column as HTML <code><div></code> tags, with the content of each column written as Markdown between them. Importing the file back restores the layout. Markdown viewers that don't support HTML show the content of the columns one after another.</li></ul>",
"_help_dEHYtoWWi8ct": "<h2>Indentation</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:201/124;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Other%20features_image.png\" width=\"201\" height=\"124\"></figure><p>Paragraphs can be indented using the following buttons from the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>:</p><ul><li>Press <span class=\"tn-icon cke cke-indent\"></span> to increase the indentation of the current paragraph by one. Can be pressed multiple times if needed.</li><li>Press <span class=\"tn-icon cke cke-outdent\"></span> to decrease the indentation of a current paragraph. The button will be disabled if it is already at the minimum indentation level.</li><li>For convenience, keyboard shortcuts are also available. Press <kbd>Tab</kbd> to indent or <kbd>Shift</kbd>+<kbd>Tab</kbd> to decrease the indentation. These shortcuts work even if the cursor is not at the beginning of a paragraph or a list.</li><li>Apart from paragraphs, the indent button is also enabled in <a class=\"reference-link\" href=\"#root/_help_S6Xx8QIWTV66\">Lists</a> (for nesting) and <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>.</li></ul><p>When indented paragraphs or headings are copied and pasted as plain text, for example into a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note or another application, each indentation level becomes a tab at the start of the line. A copy that stays within a single paragraph contains only its text, without the indentation.</p><p>The reverse also works: when plain text is pasted into a text note, each paragraph whose lines all start with tabs is indented by one level per tab. Pasting into a code block keeps the tabs as they are.</p><h2>Markdown import</h2><p>If the clipboard contains Markdown text, it can be easily imported into text notes. Simply copy a Markdown-formatted text and press the <span class=\"tn-icon cke cke-trilium-markdown-mark\"></span> to insert its visual representation.</p><p>Note that this only works with raw Markdown (e.g. <code># Heading 1</code> to generate a heading) and not the visual representation of the Markdown (e.g. as in the preview pane of an application). In that case, simply use the paste function which already accepts HTML-formatted content.</p><p>This is mostly useful for snippets of text, for entire Markdown documents use the dedicated <a class=\"reference-link\" href=\"#root/_help_Oau6X9rCuegd\">Markdown</a> import/export function.</p><p>If accessing Trilium with a web browser, the Markdown import action will ask for the content to be inserted into a dedicated screen since it does not have access to the clipboard.</p><h2>Cut to subnote</h2><p>The <span class=\"tn-icon cke cke-trilium-scissors\"></span> button will create a child note with the selected text. For more information, see <a class=\"reference-link\" href=\"#root/_help_2x0ZAX9ePtzV\">Cut to subnote</a>.</p><h2>Find and replace</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:394/203;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Other%20features_image.png\" width=\"394\" height=\"203\"></figure><p>The <span class=\"tn-icon cke cke-find-replace\"></span> button will open the editor's dedicated search and replace functionality.</p><p>Alternatively, the <kbd>Ctrl</kbd>+<kbd>F</kbd> combination can be pressed to show the dialog.</p>",
"_help_gLt3vA97tMcp": "<p>The text editor we are using is called <a class=\"reference-link\" href=\"#root/_help_MI26XDLSAlCD\">CKEditor</a> which has an open-source core, but it's also a commercial product which offers <a href=\"https://ckeditor.com/docs/trial/latest/index.html\">premium features</a>.</p><p>Prior to v0.105.0, Trilium used the following premium features as part of a signed agreement between the CKEditor and the Trilium team:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a></li><li><a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a></li><li><a class=\"reference-link\" href=\"#root/_help_5wZallV2Qo1t\">Format Painter</a></li></ul><p>Starting with v0.105.0, those features have been completely rewritten as custom CKEditor plugins, licensed under AGPL-3.0.</p><h2>Lookalikes</h2><p>There are some premium CK features that look like Trilium's built-in functionality but they are completely different:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a></li><li><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> which uses a third-party plugin that has been adapted for Trilium.</li></ul>",
"_help_ZlN4nump6EbW": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:419/571;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Slash%20Commands_image.png\" width=\"419\" height=\"571\"></figure><p>Slash commands is a feature of <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes which allows easily accessing commonly used commands simply by using the keyboard, without having to remember dedicated <a class=\"reference-link\" href=\"#root/_help_A9Oc6YKKc65v\">Keyboard Shortcuts</a>.</p><h2>Interaction</h2><ul><li>As the name suggests, to trigger the slash commands simply press the / key to trigger it. Note that this can be anywhere in a paragraph as long as it's not part of the word, if it doesn't show up simply press a space and press the / key again.</li><li>Use ↑ and ↓ keys to navigate between options.</li><li>By default, the full list of commands is displayed.</li><li>To search, simply start typing: commands are found by their title or by other names they go by (for example <code>h2</code> for <em>Heading 2</em>).</li><li>To trigger the highlighted action, press Enter or Tab.</li></ul><h2>Integration with other features</h2><p>Apart from the common set of commands, some features are specially integrated with the slash commands:</p><ul><li>For <a href=\"#root/_help_NwBbFdNZ9h7O\">admonitions</a>, each admonition type (e.g. note, tip) will be individually displayed.</li><li>Every <a class=\"reference-link\" href=\"#root/_help_pwc194wlRzcH\">Text Snippets</a> will also appear individually, making it easy to insert them.</li><li><a class=\"reference-link\" href=\"#root/_help_VRoP0g1uHHc2\">In-editor AI assistant</a>: dedicated <em>Ask AI</em> item as well as all the predefined and <a href=\"#root/_help_mVEYwt20exhO\">custom quick actions</a>.</li></ul>",
"_help_0vgWgxQAWj4a": "<aside class=\"admonition important\"><p>Sorting the selection is experimental, and it changes as it matures. To use it, turn on <em>Sort selection in text editor</em> in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Advanced</em> → <em>Experimental Options</em>.</p></aside><p>Trilium can sort the items of a list, a group of paragraphs or the rows of a table in a text note, comparing numbers, dates and times by their value.</p><h2>Sorting</h2><ul><li>To sort, place the cursor in a list or a table, or select the paragraphs to sort, then press the <span class=\"tn-icon bx bx-sort-alt-2\"></span> <em>Sort</em> button of the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a> to sort in ascending order. The arrow beside it offers <em>Ascending</em> and <em>Descending</em>. With the floating toolbar, the button is in the block-level popup.</li><li>When the selection covers several paragraphs, list items or table cells, the same choices are also in a submenu of the menu of the block handle (the sequence of dots to the left of the block), just above <em>Delete block</em>, and in the right-click menu of the selection. The submenu is named after what it sorts: <em>Sort blocks</em>, <em>Sort list items</em> or <em>Sort rows</em>.</li><li>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the button is in the main row of the toolbar and in the row of the <em>List ›</em> button.</li></ul><p>A sort can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p><h2>What is sorted</h2><ul><li><strong>List items</strong>: with the cursor in a list, the items at its level are sorted. Nested items move with the item they belong to and keep their own order. To sort only some of the items, select them.</li><li><strong>Paragraphs and other blocks</strong>: select two or more paragraphs, headings, quotes, collapsible blocks or images. Each block is sorted by its first text: a collapsible block by its title, a quote by its first paragraph and an image by its caption. A selection that mixes a list with other blocks cannot be sorted.</li><li><strong>Table rows</strong>: the rows are sorted by the column of the cursor, as described in <em>Sorting rows</em> in <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>. Inside a table cell, a list or several selected paragraphs are sorted instead of the rows.</li></ul><p>Values are compared the same way as table rows, see <em>How values are compared</em> in <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>.</p><h2>Limitations</h2><ul><li>The lines of a code block, or of a paragraph split with <kbd>Shift</kbd>+<kbd>Enter</kbd>, are not sorted one by one. A <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note can sort its lines, see <em>Transforming text</em> there.</li></ul>",
"_help_oBo3iHIZnbG2": "<p>Trilium supports spell checking for your notes. How it works depends on whether you're using the <strong>desktop application</strong> (Electron) or accessing Trilium through a <strong>web browser</strong>.</p><h2>Desktop</h2><p>The desktop app uses Chromium's built-in spellchecker. You can configure it from <em>Options</em> → <em>Spell Check</em>.</p><h3>Enabling spell check</h3><p>Toggle <em>Check spelling</em> to enable or disable the spellchecker. A restart is required for changes to take effect — use the restart button at the bottom of the section.</p><h3>Choosing languages</h3><p>When spell check is enabled, a <em>Spell Check Languages</em> section appears listing all languages available on your system. Select one or more languages by checking the boxes. The spellchecker will accept words that are valid in <em>any</em> of the selected languages.</p><p>The available languages depend on your operating system's installed language packs. For example, on Windows you can add languages through <em>Options</em> → <em>Time & Language</em> → <em>Language & Region</em> → <em>Add a language</em>.</p><aside class=\"admonition note\"><p>The changes take effect only after restarting the application.</p></aside><h3>Custom dictionary</h3><aside class=\"admonition tip\"><p>This function is available starting with Trilium v0.103.0.</p></aside><p>Words you add to the dictionary (e.g. via the right-click context menu → \"Add to dictionary\") are stored in a <strong>synced note</strong> inside Trilium. This means your custom dictionary automatically syncs across all your devices.</p><p>You can view and edit the dictionary directly from <em>Settings</em> → <em>Spell Check</em> → <em>Custom Dictionary</em> → <em>Edit dictionary</em>. This opens the underlying note, which contains one word per line. You can add, remove, or modify entries as you like.</p><aside class=\"admonition note\"><p>Changes to the custom dictionary (whether from the editor or the context menu) take effect after restarting the application.</p></aside><h4>How the custom dictionary works</h4><ul><li>When you right-click a misspelled word and choose \"Add to dictionary\", the word is saved both to Electron's local spellchecker and to the synced dictionary note.</li><li>On startup, Trilium loads all words from the dictionary note into the spellchecker session.</li><li>If Trilium detects words in Electron's local dictionary but the dictionary note is empty (e.g. on first use), it performs a <strong>one-time import</strong> of those words into the note.</li><li>Words that are in Electron's local dictionary but <em>not</em> in the note (e.g. you removed them manually) are cleaned up from the local dictionary on startup.</li></ul><h4>Known limitations</h4><p>On Windows and macOS, Electron delegates \"Add to dictionary\" to the operating system's user dictionary. This means:</p><ul><li>Words added via the context menu are also written to the OS-level dictionary (e.g. <code>%APPDATA%\\Microsoft\\Spelling\\<language>\\default.dic</code> on Windows).</li><li><strong>Removing a word</strong> from the Trilium dictionary note prevents it from being loaded into the spellchecker on next startup, but does <em>not</em> remove it from the OS dictionary. The word may still be accepted by the OS spellchecker until you remove it from the OS dictionary manually.</li></ul><h2>Web browser</h2><p>When accessing Trilium through a web browser, spell checking is handled entirely by the browser itself. Trilium does not control the browser's spellchecker — language selection, dictionaries, and all other settings are managed through your browser's preferences.</p><p>The <a class=\"reference-link\" href=\"#root/_help_jcQVxzYybYgz\">Note contextual menu</a> has a special behavior in which a right-clicked word (without selection) shows the browser's default contextual menu which allows the spellcheck to function.</p><p>The Spell Check settings page in Trilium will indicate that these options apply only to desktop builds.</p><h2>Frequently asked questions</h2><h3>Do I need to restart after every change?</h3><p>Yes. Spell check language selection and the custom dictionary are loaded once at startup. Any changes require a restart to take effect.</p><h3>Can I use multiple spell check languages at the same time?</h3><p>Yes. Select as many languages as you need from the checklist. The spellchecker will accept words from any of the selected languages.</p><h3>My custom words disappeared after syncing to a new device — what happened?</h3><p>On the first launch of a new device, Trilium may import existing local dictionary words into the note. If the note already has words from another device (via sync), those are preserved. Make sure sync completes before restarting the application on a new device.</p><h3>I removed a word from the dictionary note but it's still accepted</h3><p>This is likely due to the OS-level dictionary retaining the word (see <a href=\"#known-limitations\">Known limitations</a> above). You can manually remove it from your operating system's user dictionary.</p>",
"_help_BFvAtE74rbP6": "<aside class=\"admonition note\"><p>This page has been relocated to <a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p></aside>",
"_help_NdowYOC1GFKS": "<p>Tables are a powerful feature for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, since editing them is generally easy.</p><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:176/204;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/2_Tables_image.png\" width=\"176\" height=\"204\"></figure><p>To create a table, simply press the table button and select with the mouse the desired amount of columns and rows, as indicated in the adjacent figure.</p><p>Since v0.107.0, the same menu starts with an <em>Insert table…</em> item, for a table larger than the grid or to type its size instead:</p><ol><li>Click the <span class=\"tn-icon cke cke-table\"></span> button and select <em>Insert table…</em>. A small form opens at the cursor.</li><li>Enter the number of <em>Columns</em> (up to 100) and <em>Rows</em> (up to 1000). The table can have at most 5000 cells in total, for example 1000 rows of 5 columns.</li><li>Optionally, turn on <em>Use headers</em> and enter the number of <em>Header columns</em> and <em>Header rows</em>. A table cannot have more header columns or rows than it has columns or rows.</li><li>Press <em>Insert</em> or <kbd>Enter</kbd>.</li></ol><p>To close the form without inserting a table, press <kbd>Esc</kbd> or click outside it. From the keyboard, <kbd>Tab</kbd> moves between <em>Insert table…</em> and the grid while the menu is open.</p><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the table is inserted from the <span class=\"tn-icon cke cke-plus\"></span> button of the formatting toolbar: its <em>Insert table</em> tile lists common sizes, from 2 × 2 to 3 × 4 (rows × columns). Tap one to insert a table of that size; to make it larger, insert rows and columns afterwards.</p><h2>Formatting toolbar</h2><p>When a table is selected, a special formatting toolbar will appear:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/3_Tables_image.png\" width=\"384\" height=\"100\"><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the toolbar does not float over the table. Instead, press the <span class=\"tn-icon cke cke-table\"></span> button after <em>Undo</em> and <em>Redo</em> in the formatting toolbar at the bottom of the screen to show the table's toolbar there.</p><h2>Context menu</h2><p>Since v0.106.0, right-clicking anywhere inside a table opens a context menu with the most common table operations:</p><ul><li><em>Insert row above</em> and <em>Insert row below</em> insert a blank row next to the row of the current cell. When the selection spans multiple rows, the same number of rows is inserted.</li><li><em>Insert column to the left</em> and <em>Insert column to the right</em> work the same way for columns.</li><li>Since v0.107.0, <em>Set as header</em> or <em>Set header up to this row</em>, depending on the selection, turns rows into header rows, which always start at the top of the table:<ul><li><em>Set as header</em> shows when the selection starts at the first row, and makes every selected row a header row.</li><li><em>Set header up to this row</em> shows when the selection is in a single row below the first, and makes that row and every row above it header rows.</li><li>Neither shows when the selection spans several rows below the first.</li><li>A check mark shows that the rows are already header rows. Choosing the item again turns them, and every header row below them, back into regular rows. For example, in a table with five header rows, choosing <em>Set header up to this row</em> on the third row leaves only the first two as header rows.</li></ul></li><li><em>Merge cells</em> merges the selected cells into one. The selected cells must form a rectangle.</li><li><em>Split cell</em> splits each selected cell in two, either <em>Vertically</em> or <em>Horizontally</em>. <em>Unmerge cells</em>, in the same submenu, turns each merged cell in the selection back into the single cells it covers, keeping its content in the top-left one; cells that are not merged stay as they are.</li><li><em>Distribute columns evenly</em> splits the combined width of the columns the selection touches equally between them. The other columns and the width of the table stay as they are. It needs a selection spanning at least two columns; a merged cell counts for every column it covers.</li><li><em>Cut</em>, <em>Copy</em> and <em>Copy as Markdown</em> act on the selected cells. Since v0.107.0, <em>Copy</em> and <em>Paste</em> open submenus with their variants, such as <em>Copy as Markdown</em> and <em>Paste as plain text</em>; clicking <em>Copy</em> or <em>Paste</em> itself still copies or pastes:<ul><li>Cutting or copying produces a smaller table holding just the selected cells. Pasting it over a cell selection replaces those cells; pasting elsewhere inserts it as a table of its own. Cutting clears the cells without removing rows or columns.</li><li><em>Copy as Markdown</em> converts the selected cells to a Markdown table. A selected header row becomes the Markdown header; without one, an empty header row is emitted, since Markdown tables require one.</li></ul></li><li>Since v0.107.0, <em>Paste rows above</em> and <em>Paste rows below</em>, in the <em>Paste</em> submenu, paste the clipboard as new rows next to the row of the current cell, instead of over the cells from the cursor on. They show only when the selection is in a single row, and, like <em>Paste</em>, only where the clipboard can be read:<ul><li>A copied table becomes one new row for each of its rows, filled from the first column. When it has more columns than the table, the table gains columns, as with a regular paste. Other content goes in the first cell of a single new row.</li><li>The new rows are selected afterwards.</li><li>When merged cells join the row to others, the new rows go above or below that whole block of rows.</li></ul></li><li><em>Sort</em>, below the clipboard section, sorts the rows by the column of the current cell, in <em>Ascending</em> or <em>Descending</em> order. See <a href=\"#sorting-rows\">Sorting rows</a>.</li><li><em>Delete row</em> and <em>Delete column</em>, below <em>Sort</em>, remove every row or column the selection touches, even when only some of their cells are selected.</li><li><em>Delete table</em> removes the whole table and leaves an empty paragraph in its place. In a table nested inside another, only the inner table is removed.</li><li>Since v0.107.0, <em>Select</em>, below <em>Delete table</em>, selects the cells of every row (<em>Row</em>) or column (<em>Column</em>) the selection touches, or every cell of the table (<em>Table</em>). Unlike the <span class=\"tn-icon cke cke-drag-handle\"></span> button, which selects the table as a whole, <em>Table</em> selects its cells, so cell operations such as <em>Merge cells</em> apply to all of them. In a table nested inside another, <em>Table</em> selects only the cells of the inner table.</li></ul><p>Right-clicking a cell that is not part of the current selection moves the cursor there first, so the menu always applies to the cell under the pointer.</p><aside class=\"admonition note\"><p>In the browser, Trilium's menu replaces the browser's own context menu inside tables. To reach the browser's menu (for example for its spell checking suggestions), hold <kbd>Shift</kbd> while right-clicking. The desktop application is unaffected, since its menu already includes the spelling suggestions. In the browser, the menu also offers <em>Paste</em> only when the page can read the clipboard, which requires a secure (HTTPS) context and your permission; otherwise, paste with <kbd>Ctrl</kbd>+<kbd>V</kbd>.</p></aside><h2>Navigating a table</h2><ul><li>Using the mouse:<ul><li>Click on a cell to focus it.</li><li>Click the <span class=\"tn-icon cke cke-return-arrow\"></span> button at the top or the bottom of a table to insert an empty paragraph near it.</li><li>Click the <span style=\"--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);\"><span class=\"tn-icon cke cke-drag-handle\"></span></span> button at the top-left of the table to select it entirely (for easy copy-pasting or cutting) or drag and drop it to relocate the table.</li></ul></li><li>Using the keyboard:<ul><li>Use the arrow keys on the keyboard to easily navigate between cells.</li><li>It's also possible to use <kbd>Tab</kbd> to go to the next cell and Shift+Tab to go to the previous cell.</li><li>Unlike arrow keys, pressing <kbd>Tab</kbd> at the end of the table (last row, last column) will create a new row automatically.</li><li>To select multiple cells, hold <kbd>Shift</kbd> while using the arrow keys.</li></ul></li><li>Using touch:<ul><li>Since v0.107.0, touching a table outlines the cell with the cursor, or the selected cells, and shows a handle at each corner of the outline.</li><li>To select multiple cells, drag one of the handles across the table. The cell at the opposite corner stays selected, so the selection grows or shrinks as the finger moves. The note and wide tables scroll when the handle reaches the edge of the screen.</li></ul></li></ul><h2>Resizing cells</h2><ul><li>Columns can be resized by hovering the mouse over the border of two adjacent cells and dragging it.</li><li>To give several columns the same width, select cells across them and choose <em>Distribute columns evenly</em> from the <span class=\"tn-icon cke cke-table-column\"></span> button of the formatting toolbar or from the <a href=\"#context-menu\">context menu</a>.</li><li>By default, the row height is not adjustable using the mouse, but it can be configured from the cell settings (see below).</li><li>To adjust exactly the width (in pixels or percentages) of a cell, select the <span class=\"tn-icon cke cke-table-cell-properties\"></span> button.</li></ul><h3>Resizing with touch</h3><p>Since v0.107.0, touching a table shows a bar at the bottom of the note, above the formatting toolbar on mobile. The bar has a segment for each column of the table, with a divider at the end of each column. Only the divider of the column with the cursor is a handle that resizes; the other dividers only mark where the columns meet, so a swipe across them scrolls instead. When several cells are selected, each column they cover has a handle.</p><ul><li>To resize a column, place the cursor in one of its cells or tap its segment, then drag its handle. The table grows or shrinks with the column, and scrolls when the handle reaches the edge of the screen. The column snaps to its starting width and to the widths of the columns beside it.</li><li>To cancel a resize, drag the handle back to where it started, or touch the screen with a second finger.</li><li>To give a column and the next one the same width, double-tap the handle between them.</li><li>To select a column, tap its segment. To open the column menu, touch and hold the segment.</li><li>To scroll a wide table sideways, swipe along the bar.</li></ul><p>A wide table scrolls a little past its end, so the handle of its last column stays away from the edge of the screen, where a swipe navigates back.</p><h2>Wide tables</h2><p>Since v0.107.0, a table can be wider than the <a class=\"reference-link\" href=\"#root/_help_t596jLvPrqkS\">Content width</a>. Such a table scrolls sideways, while the rest of the note keeps its width.</p><ul><li>A new table is as wide as the content. To make it wider, drag the right border of its last column past the edge of the content. The border snaps to the edge and holds there briefly, so the table is easy to bring back to the width of the content.</li><li>To set an exact width, enter a percentage above <code>100%</code> or a width in pixels in the <span class=\"tn-icon cke cke-table-properties\"></span> <a href=\"#table-properties\">table properties</a>.</li><li>A table whose content needs more room than the note, such as a pasted table with many columns, also scrolls instead of stretching the note.</li><li>Wide tables scroll the same way in read-only notes and on shared pages.</li><li>When printing or exporting to PDF, a wide table is shrunk to fit the page.</li></ul><p>Tables inside other blocks, such as block quotes, admonitions, collapsible blocks, columns or tabs, are limited to the width of their block and do not scroll.</p><h3>Mobile support</h3><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, a table keeps the width it has on a desktop and scrolls sideways, instead of squeezing its columns into the width of the screen. The full width of a table is the <em>Max content width</em> set in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> → <em>Content Width</em> on the mobile device, 1200 pixels by default. For example, a table set to <code>50%</code> is 600 pixels wide.</p><p>To resize columns on mobile, use the bar described in <a href=\"#resizing-with-touch\">Resizing with touch</a>.</p><h2>Long tables</h2><p>Since v0.107.0, the header rows of a table stay visible at the top of the note while you scroll through the rest of the table, and leave with the end of the table. This also works in read-only notes, on shared pages and in wide tables.</p><p>To turn rows into header rows, use <em>Set as header</em> in the <a href=\"#context-menu\">context menu</a>, or <em>Header row</em> in the <span class=\"tn-icon cke cke-table-row\"></span> button of the formatting toolbar.</p><p>To let header rows scroll away with the rest of the table, turn off <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Features</em> → <em>Use sticky header rows for tables</em>. The setting applies to the current device only, and shared pages keep their sticky header rows.</p><h2>Inserting new rows and new columns</h2><ul><li>To insert a new column, click on a desired location, then press the <span class=\"tn-icon cke cke-table-column\"></span> button from the formatting toolbar and select <em>Insert column left or right.</em></li><li>To insert a new row, click on a desired location, then press the <span class=\"tn-icon cke cke-table-row\"></span> button and select <em>Insert row above</em> or <em>below</em>.<ul><li>A quicker alternative to creating a new row while at the end of the table is to press the <kbd>Tab</kbd> key.</li></ul></li><li>Both operations are also available in the <a href=\"#context-menu\">context menu</a>, which inserts as many rows or columns as the selection spans.</li></ul><h2>Moving rows and columns</h2><p>Since v0.106.0, rows and columns can be reordered with the keyboard:</p><ul><li><kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> move the rows touched by the selection up or down.</li><li><kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> move the columns touched by the selection left or right.</li></ul><p>Merged cells are never split by a move. The rows or columns held together by a merged cell travel as one block, and moving toward such a block jumps over it entirely.</p><p>When the table has a header row, a header row moved below the header area becomes a regular row, and a regular row moved into the header area becomes a header row. Header columns behave the same way.</p><p>Outside of tables, <kbd>Alt</kbd>+<kbd>Left</kbd> and <kbd>Alt</kbd>+<kbd>Right</kbd> keep navigating the note history, and <kbd>Alt</kbd>+<kbd>Up</kbd> and <kbd>Alt</kbd>+<kbd>Down</kbd> keep moving the current paragraph.</p><h2>Sorting rows</h2><p>Since v0.107.0, the rows of a table can be sorted by the values of one column:</p><ul><li>To sort all the rows, place the cursor in any cell of the column to sort by, then select <em>Sort</em> → <em>Ascending</em> or <em>Descending</em> from the <a href=\"#context-menu\">context menu</a>. The same items are in the <span class=\"tn-icon bx bx-sort-alt-2\"></span> button of the formatting toolbar.</li><li>To sort only some of the rows, select their cells in the column to sort by, then sort the same way. Sorting is not available while the selection spans more than one column.</li></ul><p>Header rows always stay at the top of the table and are never sorted. A sort can be undone with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p><h3>How values are compared</h3><p>Each cell is read as plain text, so formatting does not affect the order. Trilium then detects what kind of value the cell holds:</p><figure class=\"table\"><table><thead><tr><th>Kind</th><th>Examples</th><th>Compared by</th></tr></thead><tbody><tr><td>Time</td><td><code>15:02</code>, <code>15:02:38</code>, <code>3:02 PM</code></td><td>The time of day.</td></tr><tr><td>Date</td><td><code>2026-09-30</code>, <code>2026-09-30 15:02</code>, <code>30 September 2026</code>, <code>Wednesday, 30 September 2026</code>, <code>2026-09-30T15:02:38+03:00</code></td><td>The date and time.</td></tr><tr><td>Number</td><td><code>12</code>, <code>-3.5</code>, <code>1,234.56</code>, <code>$ 12.04</code>, <code>21 RON</code>, <code>24.5m</code></td><td>The numeric value.</td></tr><tr><td>Text</td><td>Anything else.</td><td>Alphabetically, ignoring case, with numbers inside the text in numeric order (<code>Item 9</code> before <code>Item 10</code>). Accents count, so <code>a</code> and <code>á</code> differ.</td></tr><tr><td>Empty</td><td>An empty cell, or one holding only spaces.</td><td>Not compared. Empty cells always go last.</td></tr></tbody></table></figure><p>Ascending order puts times first, then dates, numbers and text. Descending order reverses it. Empty cells go last in both directions.</p><p>Numbers, dates and times with the same value are ordered by their text, so <code>5 apples</code> comes before <code>5 pears</code>. Rows whose cells hold the same text, ignoring case, keep their relative order.</p><ul><li>Dates are also recognized in the formats of the note's language, such as <code>30.09.2026</code> or <code>30. September 2026</code> for German, and in the format chosen in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Text Notes</em> → <em>Editor</em> → <em>Date/time format</em> for <a href=\"#root/_help_CohkqWQC1iBv\">inserting the date and time</a>.</li><li>A number can start with a currency symbol, such as <code>$</code>, <code>€</code> or <code>£</code>. Whatever follows the number, such as a unit, is ignored, so units are not converted: <code>1 km</code> sorts before <code>500 m</code>. A cell that starts with letters, such as <code>RON 21</code>, is text.</li><li>The decimal separator follows the language of the note: <code>1.500</code> is one and a half in English, but one thousand five hundred in German. A comma or period that is not followed by exactly three digits is always read as a decimal separator, so <code>1,5</code> is one and a half in either language.</li><li>The language of the note set in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a> via the <span class=\"tn-icon bx bx-globe\"></span> icon, or else the default content language. See <a class=\"reference-link\" href=\"#root/_help_veGu4faJErEM\">Content language & Right-to-left support</a>.</li></ul><h3>Merged cells</h3><p>Rows joined by a merged cell are kept together and move as one block. The block is sorted by the value in its first row. When the block has more than one cell in the sorted column, the other cells do not affect the order, and a message says so: <em>Some rows were sorted together because merged cells tie them to each other</em>.</p><p>When the selection covers only part of such a block, the whole block is sorted.</p><h2>Merging cells</h2><p>To merge two or more cells together, simply select them via drag & drop and press the <span class=\"tn-icon cke cke-table-merge-cell\"></span> button from the formatting toolbar.</p><p>More options are available by pressing the arrow next to it:</p><ul><li>Click on a single cell and select Merge cell up/down/right/left to merge with an adjacent cell.</li><li>Select <em>Merge selected cells</em> to merge the selected cells, the same as pressing the button itself.</li><li>Select <em>Split cell vertically</em> or <em>horizontally</em>, to split a cell into multiple cells (can also be used to undo a merge).</li><li>Select <em>Unmerge cells</em> to turn each merged cell in the selection back into the single cells it covers, keeping its content in the top-left one.</li></ul><p><em>Merge selected cells</em> and <em>Unmerge cells</em> are available since v0.107.0. Merging and splitting are also available by right-clicking the selected cells, via the <a href=\"#context-menu\">context menu</a>, where <em>Unmerge cells</em> is in the <em>Split cell</em> submenu.</p><h2>Table properties</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:312/311;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Tables_image.png\" width=\"312\" height=\"311\"></figure><p>The table properties can be accessed via the <span class=\"tn-icon cke cke-table-properties\"></span> button and allows for the following adjustments:</p><ul><li>Border (not the border of the cells, but the outer rim of the table), which includes the style (single, double), color and width.</li><li>The background color, with none set by default.</li><li>The width and height of the table in percentage (must end with <code>%</code>) or pixels (must end with <code>px</code>).</li><li>The alignment of the table.<ul><li>Left or right-aligned, case in which the text will flow next to it.</li><li>Centered, case in which text will avoid the table, regardless of the table width.</li></ul></li></ul><p>The table will immediately update to reflect the changes, but the <em>Save</em> button must be pressed for the changes to persist.</p><h2>Cell properties</h2><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:320/386;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/1_Tables_image.png\" width=\"320\" height=\"386\"></figure><p>Similarly to table properties, the <span class=\"tn-icon cke cke-table-cell-properties\"></span> button opens a popup which adjusts the styling of one or more cells (based on the user's selection).</p><p>The following options can be adjusted:</p><ul><li>The border style, color and width (same as table properties), but applying to the current cell only.</li><li>The background color, with none set by default.</li><li>The width and height of the cell in percentage (must end with <code>%</code>) or pixels (must end with <code>px</code>).</li><li>The padding (the distance of the text compared to the cell's borders).</li><li>The alignment of the text, both horizontally (left, centered, right, justified) and vertically (top, middle or bottom).<ul><li>In a centered or right-aligned cell, each item of a bulleted, numbered or to-do list moves together with its bullet, number or checkbox.</li></ul></li></ul><p>The cell will immediately update to reflect the changes, but the <em>Save</em> button must be pressed for the changes to persist.</p><h2>Border and background colors</h2><p>The border and background colors of tables and cells adapt to the <a href=\"#root/_help_Wy267RK4M69c\">theme</a>, the same way as <a href=\"#root/_help_Gr6xFaF6ioJ5\">text colors</a> do. A color picked from the palette, chosen with the color picker or typed in is shown in a lighter or darker shade that suits the current theme, so borders stay visible and text stays readable on the background. The hue stays the same, and the table keeps the color as it was picked.</p><p>Colors applied with older versions of Trilium are shown exactly as they were picked, until the note is next edited.</p><p>Older browsers that can't adapt colors show them exactly as they were picked.</p><h2>Caption</h2><p>Press the <span class=\"tn-icon cke cke-caption\"></span> button to insert a caption or a text description of the table, which is going to be displayed above the table.</p><h2>Table borders</h2><p>By default, tables come with a gray border that is lighter or darker to suit the current <a href=\"#root/_help_Wy267RK4M69c\">theme</a>, so it stays discreet on a dark background.</p><p>To change the default border of every table, set the <code>--text-note-table-border-color</code> variable in a <a href=\"#root/_help_7NfNr5pZpVKV\">custom theme</a> or in <a href=\"#root/_help_AlhDUqhENtH7\">custom app-wide CSS</a>, for example <code>:root { --text-note-table-border-color: #555; }</code>. Set it to <code>transparent</code> to hide the borders of all the tables that don't have a border of their own.</p><p>To adjust the borders, follow these steps:</p><ol><li>Select the table.</li><li>In the floating panel, select the <em>Table properties</em> option (<span class=\"tn-icon cke cke-table-properties\"></span>).<ol><li>Look for the <em>Border</em> section at the top of the newly opened panel.</li><li>This will control the outer borders of the table.</li><li>Select a style for the border. Generally <em>Single</em> is the desirable option.</li><li>Select a color for the border.</li><li>Select a width for the border, expressed in pixels.</li></ol></li><li>Select all the cells of the table and then press the <em>Cell properties</em> option (<span class=\"tn-icon cke cke-table-cell-properties\"></span>).<ol><li>This will control the inner borders of the table, at cell level.</li><li>Note that it's possible to change the borders individually by selecting one or more cells, case in which it will only change the borders that intersect these cells.</li><li>Repeat the same steps as from step (2).</li></ol></li></ol><h3>Tables with invisible borders</h3><p>Tables can be set to have invisible borders in order to allow for basic layouts (columns, grids) of text or <a href=\"#root/_help_mT0HEkOsz6i1\">images</a> without the distraction of their border:</p><ol><li>First insert a table with the desired number of columns and rows.</li><li>Select the entire table.</li><li>In <em>Table properties</em>, set:<ol><li><em>Style</em> to <em>Single</em></li><li><em>Color</em> to <code>transparent</code></li><li>Width to <code>1px</code>.</li></ol></li><li>In Cell Properties, set the same as on the previous step.</li></ol><h2>Table indentation</h2><p>Since v0.104.1, tables can be indented as a block (the whole table moves, rather than just the content of a cell).</p><ol><li>Click the <span style=\"--tn-color:hsl(0,0%,60%);color:hsl(0,0%,60%);\"><span class=\"tn-icon cke cke-drag-handle\"></span></span> button to select the entire table. Otherwise, the indentation applies only to the current cell's content.</li><li>Press <kbd>Tab</kbd> to increase the indent, or <kbd>Shift</kbd>+<kbd>Tab</kbd> to decrease it. Alternatively, use the indentation buttons in the formatting toolbar.</li></ol><p>Markdown does not support indented tables, so the indentation is lost when converting to Markdown.</p><h2>Markdown import/export</h2><p>Simple tables are exported in GitHub-flavored Markdown format (e.g. a series of <code>|</code> items). If the table is found to be more complex (it contains HTML elements, has custom sizes or images), the table is converted to a HTML one instead.</p><p>Generally formatting loss should be minimal when exported to Markdown due to the fallback to HTML formatting.</p>",
"_help_pwc194wlRzcH": "<figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:265/108;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/Text%20Snippets_image.png\" width=\"265\" height=\"108\"></figure><p>Text Snippets are closely related to <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, but instead of defining the content of an entire note, text snippets are pieces of formatted text that can easily be inserted in a text note.</p><h2>Creating a text snippet</h2><p>In the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>: </p><ol><li>Right click a note where to place the text snippet.</li><li>Select <em>Insert child note</em>.</li><li>Select <em>More</em> → <em>Text snippet</em>.</li></ol><p>Afterwards, simply type in the content of the note the desired text. The text can be formatted in the same manner as a normal text note.</p><p>The title of the note will become the title of the template. Optionally, a description can be added in the <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> section.</p><h2>Inserting a snippet</h2><p>Once a snippet is created, there are two options to insert it:</p><ol><li>From the <a class=\"reference-link\" href=\"#root/_help_nRhnJkTT8cPs\">Formatting toolbar</a>, by looking for the <span class=\"tn-icon cke cke-trilium-template\"></span> button.</li><li>Using <a class=\"reference-link\" href=\"#root/_help_ZlN4nump6EbW\">Slash Commands</a>: <ol><li>To look for a specific template, start typing the name of the template (its title).</li><li>To look for all the templates, type <code>template</code>.</li></ol></li></ol><aside class=\"admonition tip\"><p>A newly created snippet doesn't appear? Generally it takes up to a few seconds to refresh the list of templates once you make a change.</p><p>If this doesn't happen, <a href=\"#root/_help_s8alTXmpFR61\">reload the application</a> and <a href=\"#root/_help_wy8So3yZZlH9\">report the issue</a>to us. </p></aside><h2>Limitations</h2><ul><li>Whenever a snippet is created, deleted or its title/description are modified, all the open text notes will need to be refreshed. This causes a slight flash for usually under a second, but it can cause some discomfort.</li><li>Unlike <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>, the snippets cannot be limited to a particular <a href=\"#root/_help_9sRHySam5fXb\">workspace</a>.</li></ul>",
"_help_fASfBrYnquKU": "<h2>Extended task states</h2><figure class=\"image image-style-align-left\"><img style=\"aspect-ratio:303/264;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Text/To-do%20Lists_image.png\" width=\"303\" height=\"264\"></figure><p>In Trilium, to-do items aren't limited to a simple \"done\" or \"not done.\" Tasks can also be marked as <em>in progress</em> (\"doing\"), <em>under consideration</em> (\"maybe\"), or <em>cancelled</em> (\"won't do\"), thus giving a more accurate picture of where things actually stand.</p><p>Right-click the checkbox and select the desired state. Alternatively, press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter </kbd> to cycle through the task states. Tapping or left-clicking the checkbox will always toggle between \"None\" and \"Done\". On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the states are buttons in the row of the <em>List ›</em> button, which shows while the cursor is in the list.</p><p>Task states are fully preserved when converting between <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> and <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes, in both directions.</p><h3>Customizing the extended task states</h3><p>Task states are customizable: you can reorder them, create new ones with different colors and symbols, or delete the ones you don't need. See <a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a> for more details.</p><h2>Keyboard shortcuts</h2><p>When at the beginning on an empty paragraph, type the following to insert a to-do list:</p><ul><li><code>[ ]</code> for an unchecked item</li><li><code>[x]</code> for a checked item</li></ul><p>Extended task states are supported as well, using its corresponding <em>Markdown symbol</em>. These are the defaults but they can be changed if needed (see <a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a>):</p><ul><li><code>[/]</code> for “Doing”.</li><li><code>[?]</code> for “Maybe”.</li><li><code>[-]</code> for “Cancelled”.</li></ul><p>To reorder the item under the cursor, press <kbd>Alt</kbd>+<kbd>Up</kbd> or <kbd>Alt</kbd>+<kbd>Down</kbd>. To reorder multiple items, select them first.</p><h2>See also</h2><ul><li>To-do lists are meant for small task lists. For more complicated, day-to-day task tracking consider using a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> collection instead.</li></ul>",
"_help_6f9hih2hXXZk": "<p>Trilium supports creating \"code\" notes, i.e. notes which contain some sort of formal code - be it programming language (C++, JavaScript), structured data (JSON, XML) or other types of codes (CSS etc.).</p><p>This can be useful for a few things:</p><ul><li>computer programmers can store code snippets as notes with syntax highlighting</li><li>JavaScript code notes can be executed inside Trilium for some extra functionality<ul><li>we call such JavaScript code notes \"scripts\" – see <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a></li></ul></li><li>JSON, XML etc. can be used as storage for structured data (typically used in conjunction with scripting)</li></ul><p>For shorter snippets of code that can be embedded in <a href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, see <a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a>.</p><p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Code_image.jpg\"></p><h2>Creating a code note</h2><p>In the <a href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, right-click a note and select <em>Insert child note</em> or <em>Insert note after</em>, then:</p><ul><li>To create a plain text code note, select <em>Code</em>.</li><li>To create a code note in a given language, hover <em>Code</em> and select the language. The list shows the languages enabled in the options (see below), and ends with <em>Configure code notes...</em>, which opens them.</li></ul><h2>Adjusting the language of a code note</h2><p>To change the language of a code note, look for the <span class=\"tn-icon bx bx-code\"></span> icon in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>. When clicked it will reveal the list of available languages (which can be customized according to the section below). The menu also features a search bar to quickly filter, and icons to visually distinguish some of the programming languages.</p><p>On the <a class=\"reference-link\" href=\"#root/_help_RDslemsQ6gCp\">Mobile Frontend</a>, the same list is available in the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Note settings</em> → <em>Change language mode</em>.</p><h2>Adjusting the list of languages</h2><p>Trilium supports syntax highlighting for many languages, but by default displays only some of them. To change which languages are offered, go to <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> and find <em>Available MIME types in the dropdown</em>. Here you can:</p><ul><li>Add a language by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Add another language</em> button, which also shows how many languages are left, and then selecting it. While picking, hover a language to see where it is syntax highlighted.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button beside a language, or select it and press <kbd>Delete</kbd>, to remove it from the list. <em>Plain text</em> cannot be removed.</li><li>See where each language is syntax highlighted: the <em>Code blocks</em> badge stands for code blocks in text notes, the <em>Code notes</em> badge for code notes.</li></ul><p>The languages are listed in the same order wherever you choose one: the language menu in the <a class=\"reference-link\" href=\"#root/_help_AlJ73vBCjWDw\">Status bar</a>, the <em>Code</em> submenu when creating a note, and the language of a code block. By default, the list is sorted alphabetically, with <em>Plain text</em> first. To use an order of your own:</p><ol><li>Turn off the <em>Sort alphabetically</em> switch at the top of the section.</li><li>Hold the <strong>=</strong> handle shown beside a language, and then drag it up or down. Alternatively, select a language and press <kbd>Ctrl</kbd>+<kbd>↑</kbd> or <kbd>Ctrl</kbd>+<kbd>↓</kbd>.</li></ol><p>Turning <em>Sort alphabetically</em> back on does not discard your order: it is used again the next time the switch is turned off.</p><p>Note that the list of languages is not immediately refreshed, you'd have to manually <a href=\"#root/_help_s8alTXmpFR61\">refresh the application</a>.</p><p>The list of languages is also shared with the <a href=\"#root/_help_QxEyIjRBizuC\">Code blocks</a> feature of <a href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</p><h2>Word wrap</h2><p>Long lines can be displayed on multiple lines:</p><ul><li>Globally for all code notes, from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes.</em></li><li>For a particular note, by going to the menu in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> and selecting <em>Word wrap</em> and selecting the appropriate option:<ul><li><em>Auto</em>, to respect the global word wrap for code notes.</li><li><em>On</em> or <em>Off</em>, to change the state of the word wrap for this note regardless of the global option.</li></ul></li></ul><aside class=\"admonition note\"><p>Word wrapping can also be adjusted at note level through the <code>#wrapLines</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, which can also be inherited.</p></aside><h2>Line numbers</h2><p>The numbers at the start of each line can be hidden from <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Code Notes</em> → <em>Editor</em> → <em>Line numbers</em>. The setting applies to every code editor, such as the source of a <a href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> note, and to code shown without its editor (see <em>Color schemes</em> below).</p><p>An included code note or an embedded code file can show or hide them on its own through the <em>Line numbers</em> submenu of its <em>More actions</em> menu, see <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>. Its <em>Auto</em> entry follows the setting.</p><h2>Adjusting options using the status bar</h2><p>The status bar at the bottom of the editor shows the position of the cursor, the current indentation settings and language.</p><p>The cursor position is shown as <em>Ln</em> (the line) and <em>Col</em> (the column), both counted from 1. A tab counts as many columns as the display width of tabs, so the column matches where the cursor appears on screen. While text is selected, <em>Selected</em> shows the number of selected characters, counting each line break as one.</p><p>Clicking on the indentation indicator opens a menu with three sections:</p><ol><li><em>Indent Using</em> — switch between Spaces and Tabs (<code>#indentWithTabs</code>). If a per-note override is active, a \"Reset to default\" option appears.</li><li><em>Display Width</em> — choose from preset widths (1, 2, 3, 4, 6, 8). Changes are saved as a per-note <code>#tabWidth</code> label.</li><li><em>Re-indent Content To</em> — convert existing indentation to a different style. For example, re-indent a file from 4 spaces to 2 spaces, or from spaces to tabs. This rewrites the leading whitespace on every line while preserving alignment remainders.</li></ol><p>Clicking the language indicator lets you change the note's MIME type. As in the <em>Note type</em> selector, typing narrows the list of languages.</p><p>The same two menus are in the toolbar of a code note or a code file included in a text note, see <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p><h3>Re-indentation</h3><p>When you re-indent content, the editor:</p><ul><li>Measures the visual column width of each line's leading whitespace using the current style</li><li>Calculates indent levels and any alignment remainder</li><li>Rebuilds the leading whitespace in the target style</li><li>Preserves non-leading whitespace, blank lines, and content without indentation</li></ul><h2>Transforming text</h2><p>To change the selected lines or text, right-click the selection and open <em>Transform</em>. Its commands come in three groups:</p><ul><li><em>Sort ascending</em>, <em>Sort descending</em>, <em>Shuffle lines</em>, <em>Reverse line order</em> and <em>Deduplicate lines</em>, which keeps the first copy of each line.</li><li><em>Trim leading</em>, <em>Trim trailing</em> and <em>Trim both</em> remove the whitespace at the start, at the end or at both ends of each line. <em>Remove blank lines</em> also removes the lines that hold only whitespace.</li><li><em>To uppercase</em>, <em>To lowercase</em>, <em>To sentence case</em>, <em>To title case</em> and <em>Remove diacritics</em>.</li></ul><p>The commands of the first two groups change every line that the selection touches, even partly. Those of the third group change only the selected text. Each change is undone in one step with <kbd>Ctrl</kbd>+<kbd>Z</kbd>.</p><ul><li>Sorting reads numbers, dates and times by their value, as sorting a table does (see <a class=\"reference-link\" href=\"#root/_help_NdowYOC1GFKS\">Tables</a>), and ignores the case of letters and the indentation. Blank lines go last.</li><li><em>To sentence case</em> lowercases the text and capitalizes the first word of each sentence and of each line. <em>To title case</em> capitalizes every word except minor words such as \"of\" and \"the\", which stay lowercase unless they start or end a sentence.</li><li><em>Remove diacritics</em> turns letters such as <code>é</code>, <code>ș</code> and <code>ł</code> into <code>e</code>, <code>s</code> and <code>l</code>, and removes the vowel points of Hebrew and Arabic. Letters such as <code>ß</code> and <code>æ</code> stay as they are.</li><li>Sorting and the case changes follow the language set in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Language & Region</em> → <em>Default content language</em>. In Turkish, for example, an uppercase <code>i</code> is <code>İ</code>.</li></ul><h2>Color schemes</h2><p>Since Trilium 0.94.0 the colors of code notes can be customized by going <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → Code Notes and looking for the <em>Appearance</em> section.</p><p>A code note or a code file shown without its editor, such as in an <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>, on the cards of <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a> or in a tooltip, uses the same colors and line numbers as the editor does. A printout uses the <em>Light theme</em>. A <a href=\"#root/_help_R9pX4DGra2Vt\">shared page</a> uses the VS Code light or dark theme, following the mode of the page.</p><aside class=\"admonition note\"><p><strong>Why are there only a few themes whereas the code block themes for text notes have a lot?</strong><br>The reason is that Code notes use a different technology than the one used in Text notes, and as such there is a more limited selection of themes. If you find a CodeMirror 6 (not 5) theme that you would like to use, let us know and we might consider adding it to the set of default themes. There is no possibility of adding new themes (at least for now), since the themes are defined in JavaScript and not at CSS level.</p></aside><h2>Programming ligatures</h2><p>If you see <code>!=</code> displayed as <code>≠</code> or <code>-></code> as <code>→</code> inside a code note, those are <em>font ligature</em>: the default monospace font draws certain character pairs as a single symbol. The underlying text is not changed by Trilium (unlike text notes which have <a class=\"reference-link\" href=\"#root/_help_oI7GoyilXXAr\">Automatic replacements</a>), and copying it out gives you back <code>!=</code> and <code>-></code>.</p><p>This can be turned off with <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a><em>→ Appearance → Fonts → Programming ligatures</em>.</p><h2>Virtual keyboard behavior</h2><p>When using a virtual keyboard, keyboard suggestions and corrections are controlled as follows:</p><ul><li>For <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> and plain text code notes, the autocorrect is <strong>on</strong>, as well as automatic capitalization.</li><li>For all the other code notes, the autocorrect is off in order to avoid issues when typing code.</li></ul><aside class=\"admonition note\"><p>Not all browsers and platforms respect this value, so the keyboard suggestions might appear without autocorrecting or the browser might disregard this and autocorrect anyway.</p></aside>",
"_help_m523cpzocqaD": "<p>Trilium allows you to save common searches as notes within the note tree. The search results will appear as sub-notes under these \"saved search\" notes. Here is an example of how it works:</p><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:812/585;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Saved%20Search_saved-search.gif\" width=\"812\" height=\"585\"></figure><p>A saved search runs when you open it, and when you expand it in the note tree. A saved search in a tab that is not shown, such as a background tab restored at startup, runs when you switch to that tab. Its results stay until you run the search again with the <em>Search</em> button of the search parameters. If the query has an error, it appears as a notification.</p><p>In <a class=\"reference-link\" href=\"#root/_help_64ZTlUPgEPtW\">Safe mode</a>, and when the request fails, the search does not run on its own. Press <em>Search now</em> to run it.</p><p>Once a search is saved, the <em>Search parameters</em> is still available underneath the <a class=\"reference-link\" href=\"#root/_help_l7pigIGu01K2\">Title</a> in order to be able to change the settings later on but it will appear collapsed by default.</p><h2>Location</h2><p>By default, saved searches are stored in the day note. However, you can designate a different note to store saved searches by marking it with the <code>#searchHome</code> label. Additionally, for <a href=\"#root/_help_9sRHySam5fXb\">workspaces</a>, you can use the <code>#workspaceSearchHome</code> label to specify a storage location for saved searches within that workspace.</p>",
"_help_iRwzGnHPzonm": "<p>Relation map is a type of note which visualizes notes and their <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>.</p><h2>Interaction</h2><ul><li>To create a new note and add it to the map, press the <span class=\"tn-icon bx bx-note\"></span> <em>Add note</em> button at the bottom of the map, then click anywhere on the map to place it there.<ul><li>While the map waits for the click, a translucent box follows the mouse to show where the note will go. To cancel, press the button again (now labeled <em>Cancel</em>) or press <kbd>Esc</kbd>.</li><li>The note is created as a child of the map, with the default title of a new note. It opens in the note panel (see below) with its title selected, so you can type its name straight away.</li></ul></li><li>An existing note can also be dragged from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. It will be placed at the position it's dragged on.<ul><li>Multiple notes can also be dragged via <a class=\"reference-link\" href=\"#root/_help_yTjUdsOi4CIE\">Multiple selection</a>. The notes will be positioned near the dragged position without overlapping.</li><li>The dragged note can be a sub-child of the map, or it can be at any arbitrary position.</li></ul></li><li>Notes can also be pasted onto the map. Copy or cut them in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, then click the map and press <kbd>Ctrl</kbd>+<kbd>V</kbd>, or right click an empty part of the map and select <em>Paste note(s)</em>.<ul><li>With <kbd>Ctrl</kbd>+<kbd>V</kbd>, the notes are placed under the mouse, or in the middle of the map if the mouse is not over it. From the right click menu, they are placed where the menu was opened.</li><li>Copied notes stay where they are in the tree. Cut notes are moved under the map, as if they had been pasted into it in the tree.</li><li>Links to notes, such as an <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> copied from a text note, can be pasted the same way. If the clipboard holds no link to a note, the notes last copied or cut in the tree are pasted.</li><li>The right click menu of an empty part of the map also has <em>Add note</em>, which creates a new note where the menu was opened.</li></ul></li><li>To create a relationship, hold the mouse on the dot on the right of a note and then:<ul><li>Drag it over another note to create a relationship pointing from the first note to the second one.</li><li>Drag over the same note to create a self-referencing relationship (represented as a loop).</li><li>Once dragged, a popover next to the relationship asks for its name. Type a new name and press <kbd>Enter</kbd>, or pick a relation name already in use from the suggestions. To cancel, press <kbd>Esc</kbd>, close the popover or click elsewhere on the map.</li></ul></li><li>Each note is shown as a card with its icon and title, colored in the note's color the same way as the cards of a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>.</li><li>Hovering a note highlights its relationships, in the note's color if it has one, and fades the other relationships.</li><li>To view or edit a note, click it on the map. This opens the note panel (see below).<ul><li>To open the note in a new tab instead, <kbd>Ctrl</kbd>+click it or click it with the middle mouse button. <kbd>Shift</kbd>+click opens it in a new window. The right click menu offers the same options.</li></ul></li><li>To edit the title of a note, change its color or delete it (either from the map, or delete it completely), right click the note.</li><li>To rename or delete a relationship, right click it and select the corresponding option.</li><li>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> map, notes cannot be moved and relationships cannot be drawn, renamed or deleted. The right click menu of a note only offers to open it, and a relationship has no right click menu.</li><li>To move around the map, drag an empty part of it, and zoom with the mouse wheel or the <span class=\"tn-icon bx bx-minus-circle\"></span> and <span class=\"tn-icon bx bx-plus-circle\"></span> buttons at the bottom-right corner. Clicking the zoom percentage goes back to 100%, and <span class=\"tn-icon bx bx-scan\"></span> <em>Fit to view</em> zooms and pans so that all the notes are visible.<ul><li>Once the map has been clicked, the arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> pan it, and <kbd>+</kbd> and <kbd>-</kbd> zoom it. The <kbd>?</kbd> button at the top-right corner of the map lists all its keyboard shortcuts.</li></ul></li></ul><h2>Note panel</h2><p>When a note on the map is clicked, a panel opens to the right of the map and the note is highlighted. If the panel would cover the note, or the note is partly off-screen, the map pans to bring it into view. The panel contains:</p><ul><li>The title and icon of the note, both editable.</li><li>A <span class=\"tn-icon bx bx-expand-alt\"></span> button to expand the panel over the whole map, and to restore it afterwards.</li><li>Buttons to interact with the note:<ul><li><span class=\"tn-icon bx bx-log-in\"></span> Open the note in the current tab, or, through the <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> menu, in a new tab, split, window or the quick edit popup.</li><li>A <span class=\"tn-icon bx bx-palette\"></span> color picker to change the color of the note.</li><li>A <span class=\"tn-icon bx bx-trash\"></span> button to remove the note from the map, which can optionally delete the note as well.</li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> of the note, if any.</li><li>The note's content, which can be edited directly from the panel.</li></ul><p>The color picker and the remove button are not shown if the map is read-only.</p><p>Clicking another note on the map switches the panel to it. Similarly, clicking an <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> inside the panel switches the panel to that note, as long as it is on the map.</p><p>To close the panel, press the <span class=\"tn-icon bx bx-x\"></span> button at its top-right, click an empty part of the map, or press <kbd>Esc</kbd>.</p><p>On mobile, the note opens as a dialog over the whole screen instead of a panel.</p><h2>Development process demo</h2><p>This is a basic example how you can create simple diagram using relation maps:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-dev-process.png\" width=\"934\" height=\"667\"><p>And this is how you can create it:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-dev-process-demo.gif\" width=\"812\" height=\"585\"><p>We start completely from scratch by first creating new note called \"Development process\" and changing its type to \"Relation map\". After that we create new notes one by one and place them by clicking into the map. We also drag <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>between notes and name them. That's all!</p><p>Items on the map - \"Specification\", \"Development\", \"Testing\" and \"Demo\" are actually notes which have been created under \"Development process\" note - you can click on them and write some content. Connections between notes are called \"<a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>\".</p><h2>Family demo</h2><p>This is more complicated demo using some advanced concepts. Resulting diagram is here:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-family.png\" width=\"941\" height=\"758\"><p>This is how you get to it:</p><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Relation%20Map_relation-map-family-demo.gif\" width=\"812\" height=\"585\"><p>There are several steps here:</p><ul><li>we start with empty relation map and two existing notes representing Prince Philip and Queen Elizabeth II. These two notes already have <code>isPartnerOf</code> <a href=\"#root/_help_zEY4DaJG4YT5\">relations</a>defined.<ul><li>There are actually two \"inverse\" relations (one from Philip to Elizabeth and one from Elizabeth to Philip)</li></ul></li><li>we drag both notes to relation map and place to suitable position. Notice how the existing <code>isPartnerOf</code> relations are displayed.</li><li>now we create new note - we name it \"Prince Charles\" and place it on the relation map by clicking on the desired position. The note is by default created under the relation map note (visible in the note tree on the left).</li><li>we create two new relations <code>isChildOf</code> targeting both Philip and Elizabeth<ul><li>now there's something unexpected - we can also see the relation to display another <code>hasChild</code> relation. This is because there's a <a href=\"#root/_help_OFXdgB2nNk1F\">relation definition</a> which puts <code>isChildOf</code> as an \"<a href=\"#root/_help_OFXdgB2nNk1F\">inverse</a>\" relation of <code>hasChildOf</code> (and vice versa) and thus it is created automatically.</li></ul></li><li>we create another note for Princess Diana and create <code>isPartnerOf</code> relation from Charles. Again notice how the relation has arrows both ways - this is because <code>isPartnerOf</code> definition specifies its inverse relation as again \"isPartnerOf\" so the opposite relation is created automatically.</li><li>as the last step we pan & zoom the map to fit better to window dimensions.</li></ul><p>Relation definitions mentioned above come from \"Person template\" note which is assigned to any child of \"My Family Tree\" relation note. You can play with the whole thing in the <a href=\"#root/_help_wX4HbRucYSDD\">demo notes</a>.</p><h2>Details</h2><p>You can specify which relations should be displayed with comma delimited names of relations in <code>displayRelations</code> label.</p><p>Alternatively, you can specify comma delimited list of relation names in <code>hideRelations</code> which will display all relations, except for the ones defined in the label.</p><h2>See also</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a> is a similar concept.</li></ul>",
"_help_bdUJEHsAPYQR": "<figure class=\"image image_resized\" style=\"width:72.68%;\"><img style=\"aspect-ratio:1311/1271;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Note%20Map_image.png\" width=\"1311\" height=\"1271\"></figure><p>A Note map is a note type which displays a standalone version of the feature of the same name: <a class=\"reference-link\" href=\"#root/_help_BCkXAVs63Ttv\">Note Map (Link map, Tree map)</a>. Consult that page for more information on how the note map works and what it displays.</p><p>Once created, the note map will display the relations between notes. Only the notes that are part of the parent of the note map will be displayed (including their children).</p><h2>Root note</h2><p>The root note defines the starting point of the graph, from which the relations and the hierarchy are derived from.</p><p>There are three possible root notes:</p><ul><li>The default root note is the parent note of the note map.</li><li>To use the currently <a href=\"#root/_help_OR8WJ7Iz9K4U\">hoisted note</a> instead, set the <code>mapRootNoteId</code> label to <code>hoisted</code>.</li><li>To use a specific note instead, set <code>mapRootNoteId</code> to the <a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a> of the desired note.</li></ul><h2>Customization</h2><p>The note map can be customized using the following <a class=\"reference-link\" href=\"#root/_help_HI6GBBIduIgv\">Labels</a>:</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Description</th></tr></thead><tbody><tr><td><code>#mapIncludeRelation</code></td><td>Comma-delimited relation names to include from the note map.</td></tr><tr><td><code>#mapExcludeRelation</code></td><td>Comma-delimited relation names to exclude from the note map.</td></tr><tr><td><code>#mapRootNoteId</code></td><td>The ID of the note the map roots from, or <code>hoisted</code>. See the root note section above for more information.</td></tr></tbody></table></figure>",
"_help_HcABDtFCkbFN": "<figure class=\"image\"><img style=\"aspect-ratio:601/216;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Render%20Note_image.png\" width=\"601\" height=\"216\"></figure><p>Render Note is a special case of <a href=\"#root/_help_yIhgI5H7A2Sm\">front-end scripting</a> which allows rendering custom content inside a note. This makes it possible to create custom dashboards, or to use a custom note editor.</p><p>The content can either be a vanilla HTML, or Preact JSX.</p><h2>Creating a render note</h2><ol><li>Create a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note with the:<ol><li>HTML language for the legacy/vanilla method, with what needs to be displayed (for example <code><p>Hello world.</p></code>).</li><li>JSX for the Preact-based approach (see below).</li></ol></li><li>Create a <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</li><li>Assign the <code>renderNote</code> <a href=\"#root/_help_zEY4DaJG4YT5\">relation</a> to point at the previously created code note.</li></ol><h2>Legacy scripting using jQuery</h2><p>A static HTML is generally not enough for <a class=\"reference-link\" href=\"#root/_help_CdNpE2pqjmI6\">Scripting</a>. The next step is to automatically change parts of the note using JavaScript.</p><p>For a simple example, we are going to create a render note that displays the current date in a field.</p><p>To do so, first create an HTML code note with the following content:</p><pre><code class=\"language-text-html\"><h1>Current date & time</h1>\nThe current date & time is <span class=\"date\"></span></code></pre><p>Now we need to add the script. Create another <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a>, but this time of JavaScript (frontend) language. Make sure the newly created note is a direct child of the HTML note created previously; with the following content:</p><pre><code class=\"language-text-javascript\">const $dateEl = api.$container.find(\".date\");\n$dateEl.text(new Date());</code></pre><p>Now create a render note at any place and set its <code>~renderNote</code> relation to point to the HTML note. When the render note is accessed it will display:</p><blockquote><p><strong>Current date & time</strong><br>The current date & time is Sun Apr 06 2025 15:26:29 GMT+0300 (Eastern European Summer Time)</p></blockquote><h2>Dynamic content using Preact & JSX</h2><p>As a more modern alternative to jQuery, it's possible to use Preact & JSX to render pages. Since JSX is a superset of JavaScript, there's no need to provide a HTML anymore.</p><p>Here are the steps to creating a simple render note:</p><ol><li><p>Create a note of type <a class=\"reference-link\" href=\"#root/_help_HcABDtFCkbFN\">Render Note</a>.</p></li><li><p>Create a child <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note with JSX as the language.<br>As an example, use the following content:</p><pre><code class=\"language-text-x-trilium-auto\">export default function() {\n return (\n <>\n <p>Hello world.</p>\n </>\n );\n}</code></pre></li><li><p>In the parent render note, define a <code>~renderNote</code> relation pointing to the newly created child.</p></li><li><p>Refresh the render note and it should display a “Hello world” message.</p></li></ol><h2>Refreshing the note</h2><p>It's possible to refresh the note via:</p><ul><li>The <span class=\"tn-icon bx bx-refresh\"></span> button in the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area.</li><li>The “Render active note” <a href=\"#root/_help_A9Oc6YKKc65v\">keyboard shortcut</a> (not assigned by default).</li></ul><h2>Printing</h2><p>A render note can be printed or exported as PDF from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> once its <code>~renderNote</code> relation is set (see <a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing & Exporting as PDF</a>). Unlike other notes, it is printed exactly as it is displayed: the script does not run again, so what was typed, selected or loaded in the note is kept.</p><ul><li>The content is laid out again at the width of the page, so elements sized by the script for the screen (such as charts) might not fit.</li><li>Scrolling areas, such as a table in a scrolling container, are printed at their full height, without a scrollbar.</li><li>To adjust the layout for printing, use a <code>~printCss</code> relation.</li><li>The light colors are used for printing, whatever the current theme.</li></ul><p>When a render note is printed as part of a <a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a> collection, or from another view such as its attachments, it is not on screen, so its script runs again for the print. In a collection, the output is printed without the note's own styles.</p><h2>Examples</h2><ul><li><a class=\"reference-link\" href=\"#root/_help_R7abl2fc6Mxi\">Weight Tracker</a> which is present in the <a class=\"reference-link\" href=\"#root/_help_6tZeKvSHEUiB\">Demo Notes</a>.</li></ul>",
"_help_s1aBHPd79XYj": "<aside class=\"admonition tip\"><p>For a quick understanding of the Mermaid syntax, see <a class=\"reference-link\" href=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/Syntax%20reference.dat\">Syntax reference</a> (official documentation).</p></aside><figure class=\"image\"><img style=\"aspect-ratio:1464/915;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams_image.png\" width=\"1464\" height=\"915\"></figure><p>Trilium supports Mermaid, which adds support for various diagrams such as flowchart, sequence diagram, class diagram, state diagram, pie charts, etc., all using a text description of the chart instead of manually drawing the diagram.</p><p>This note type is a split view, meaning that both the source code and a preview of the document are displayed side-by-side. See <a class=\"reference-link\" href=\"#root/_help_SL5f1Auq7sVN\">Note types with split view</a> for more information.</p><h2>Sample diagrams</h2><p>Starting with v0.103.0, Mermaid diagrams no longer start with a sample flowchart, but instead a pane at the bottom will show all the supported diagrams with sample code for each:</p><ul><li>Simply click on any of the samples to apply it.</li><li>The pane will disappear as soon as something is typed in the code editor or a sample is selected. To make it appear again, simply remove the content of the note.</li></ul><h2>Layouts</h2><p>Depending on the chart being edited and user preference, there are two layouts supported by the Mermaid note type:</p><ul><li>Horizontal, where the source code (editable part) is on the left side of the screen and the preview is to the right.</li><li>Vertical, where the source code is at the bottom of the screen and the preview is at the top.</li></ul><p>It's possible to switch between the two layouts at any time by pressing the <span class=\"tn-icon bx bxs-dock-left\"></span> icon in the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>.</p><h2>Interaction</h2><ul><li>The source code of the diagram (in Mermaid format) is displayed on the left or bottom side of the note (depending on the layout).<ul><li>Changing the diagram code will refresh automatically the diagram.</li><li>The front matter (the block between <code>---</code> lines at the start of the diagram, which holds its title and configuration) is highlighted as YAML, and so are the node properties of flowcharts and Kanban boards (such as <code>@{ shape: tool }</code>). Configuration directives (<code>%%{init: …}%%</code>) are highlighted apart from comments, and so are the accessibility title and description (<code>accTitle:</code> and <code>accDescr:</code>).</li><li><kbd>Ctrl</kbd>+<kbd>/</kbd> (Mac: <kbd>⌘</kbd>+<kbd>/</kbd>) comments out the current or selected lines with <code>%%</code>, or with <code>#</code> in the front matter. Pressing it again on commented lines removes the comment marker.</li></ul></li><li>The preview of the diagram is displayed at the right or top side of the note (depending on the layout):<ul><li>There are dedicated buttons at the bottom-right of the preview to control the zoom in, zoom out or fit the diagram.</li><li>The preview can be moved around by holding the left mouse button and dragging.</li><li>Zooming can also be done by using the scroll wheel.</li><li>The zoom and position on the preview will remain fixed as the diagram changes, to be able to work more easily with large diagrams.</li><li>Double-clicking the preview resets the zoom/position.</li><li>The preview can also be focused by clicking on it, case in which keyboard shortcuts can be used:<ul><li><kbd>+</kbd> or <kbd>E</kbd> to zoom in, <kbd>-</kbd> or <kbd>Q</kbd> to zoom out.</li><li><kbd>/</kbd> to reset the zoom/position.</li><li>Arrow keys or <kbd>W</kbd> <kbd>A</kbd> <kbd>S</kbd> <kbd>D</kbd> to pan. Holding <kbd>Shift</kbd> pans faster.</li></ul></li></ul></li><li>The size of the source/preview panes can be adjusted by hovering over the border between them and dragging it with the mouse.</li><li>In the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a>:<ul><li>The source/preview can be laid out left-right (via <span class=\"tn-icon bx bxs-dock-left\"></span>) or bottom-top (via <span class=\"tn-icon bx bxs-dock-bottom\"></span>).</li><li>Press the <span class=\"tn-icon bx bx-copy\"></span> (<em>Copy image reference to the clipboard</em>) to be able to insert the image representation of the diagram into a text note. See <a class=\"reference-link\" href=\"#root/_help_0Ofbk1aSuVRu\">Image references</a> for more information.</li></ul></li><li>To export the diagram as either SVG or PNG, go to the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> and select <em>Export as image</em>:<ul><li>Select <em>SVG (vector)</em> to download a scalable/vector rendering of the diagram. Can be used to present the diagram without degrading when zooming.</li><li>Select <em>PNG (raster)</em> to download a normal image (at 1x scale, raster) of the diagram. Can be used to send the diagram in more traditional channels such as e-mail.</li></ul></li><li>The note can be marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a>, case in which it switches by default to the preview (although it can be switched back using the source/preview buttons) and the source is no longer editable.</li></ul><h2>Errors in the diagram</h2><p>If there is an error in the source code, the error will be displayed in an information pane.</p><p>During the state of an error, the diagram will no longer be rendered and the previously working diagram will remain in the preview section.</p><h2>Diagrams in a text note</h2><p>To show a diagram inside a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note instead of in a note of its own, insert one with the <span class=\"tn-icon cke cke-trilium-mermaid-insert\"></span> <em>Mermaid diagram</em> button of the <span class=\"tn-icon cke cke-plus\"></span> <em>Insert</em> menu. It has the same views, zoom and error display as a Mermaid note, and its source stays in the text note as a code block. See <em>Mermaid diagram</em> in <a class=\"reference-link\" href=\"#root/_help_CohkqWQC1iBv\">Insert buttons</a>.</p>",
"_help_RH6yLjjWJHof": "<p>Mermaid supports a different layout engine which supports slightly more complex diagrams, called the <a href=\"https://eclipse.dev/elk/\">Eclipse Layout Kernel (ELK)</a>. Trilium has support for these as well, but it's not enabled by default.</p><p>In order to activate ELK for any diagram, insert the following YAML frontmatter right at the beginning of the diagram:</p><pre><code class=\"language-text-x-yaml\">---\nconfig:\n layout: elk\n---</code></pre><figure class=\"table\"><table><thead><tr><th>With ELK off</th><th>With ELK on</th></tr></thead><tbody><tr><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/ELK%20layout_ELK%20off.svg\"></td><td><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mermaid%20Diagrams/ELK%20layout_ELK%20on.svg\"></td></tr></tbody></table></figure>",
"_help_grjYqerjn243": "<figure class=\"image\"><img src=\"{{helpAssets}}/User%20Guide/Note%20Types/Canvas_image.png\" alt=\"grafik\"></figure><p>Canvas notes use the Excalidraw library to allow handwritten notes with mouse, pen or touch on an infinite canvas. It also supports basic diagramming, text and graphics input.</p><h2>Interaction</h2><ul><li>The note can be togged <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><h2>Pen width</h2><p>The pen draws at half the <em>Stroke width</em> picked in the properties panel, which suits handwriting. To draw at the full width instead, turn off <em>Thin pen stroke</em> in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Other</em>. Strokes already drawn keep their width.</p><h2>Embedding notes</h2><p>Since v0.104.0, Canvas supports embedding notes in a similar fashion to the <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> functionality for <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</p><p>To embed a note:</p><ul><li>From the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, drag the item onto the canvas.</li><li>Manually, by choosing <em>More tools</em> → <em>Web Embed</em> and pasting the link to the note (e.g. <code>root/MujWAc9fQ1nj</code>).</li></ul><p>Embedding notes in the canvas follows the same rules as <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>: some notes are rendered as images (e.g. <a class=\"reference-link\" href=\"#root/_help_gBbsAeiuUxI5\">Mind Map</a>), whereas some render fully interactive such as <a class=\"reference-link\" href=\"#root/_help_GTwFsgaA0lCt\">Collections</a>.</p><h2>Linking to a note</h2><ol><li>From the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> right click the note to be linked and selected <em>Advanced → Copy note path to the clipboard</em>.</li><li>In the canvas note, right click an element and select <em>Add link</em> (or press <kbd>Ctrl</kbd>+<kbd>K</kbd>). Paste the link and press <kbd>Enter</kbd>.</li><li>A <span class=\"tn-icon bx bx-link-external\"></span> icon will appear at the top-right of the element which will navigate to the linked note when clicked.</li></ol><h2>Drawing in a text note</h2><p>To draw inside a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note instead of in a note of its own, insert a drawing canvas with <span class=\"tn-icon bx bx-pen\"></span><em>Drawing canvas</em> in the <span class=\"tn-icon cke cke-plus\"></span><em>Insert</em> menu. See <em>Drawing canvases</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</p>",
"_help_1vHRoWCEjj0L": "<h2>Configuration</h2><p>A webview needs to know which URL to render, and it can be provided by setting the <code>webViewSrc</code> <a href=\"#root/_help_zEY4DaJG4YT5\">label</a>, such as:</p><pre><code class=\"language-text-x-trilium-auto\">#webViewSrc=\"https://www.wikipedia.org\"</code></pre><p>The URL needs to contain the full scheme.</p><h2>Web view on the server vs. Electron</h2><p>When accessing Trilium via a browser instead of the desktop application, the web view will still try to render the content of the desired webpage. However, since it's running in a browser there are quite a few limitations as opposed to the desktop one.</p><p>More specifically, quite a few websites oppose being embedded in another website (technically they have a non-permisive <code>X-Frame-Options</code> header). This is not bypassable by Trilium so the page will simply fail to render.</p><p>You can diagnose this by right clicking the Trilium web page → Inspect (element) and looking in the “Console” tab for errors such as:</p><ul><li><code>Refused to display 'https://www.google.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'.</code></li><li><code>Refused to frame 'https://duckduckgo.com/' because an ancestor violates the following Content Security Policy directive: \"frame-ancestors 'self' https://html.duckduckgo.com\".</code></li></ul><p>There are a few websites that do render such as <code>wikipedia.org</code>.</p><p>Do note that we are also applying some sandboxing constraints on the server side, so if you have any issues other than the unresolvable <code>X-Frame-Options</code> described above, feel free to report them.</p><p>On the desktop side, a different technology is used which bypasses the constraints of an <code>iframe</code> (<code>webview</code>).</p><h2>Embedding in other note types</h2><p>Starting with v0.104.0, web views can be embedded into other note types:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_IF7Q6I9x7zuw\">Dashboard</a></li><li><a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a></li><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes via <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</li></ul>",
"_help_gBbsAeiuUxI5": "<figure class=\"image image-style-align-center\"><img style=\"aspect-ratio:892/675;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Mind%20Map_image.png\" width=\"892\" height=\"675\"></figure><p>The mindmap allows for easy jotting down of ideas and storing them in a hierarchical fashion.</p><h2>Terminology</h2><ul><li>A <strong>node</strong> is a single idea, represented differently based on depth (filled rounded rectangle for the root note, unfilled rectangles for sub-ideas, lines only for sub-sub-ideas).</li><li>The <strong>root node</strong> is the top-most node from which all other nodes derive, displayed as a filled rectangle. There can only be a single root node.</li></ul><h2>Interaction</h2><ul><li>To create a new node at the same level as the current one, press <kbd>Enter</kbd>, enter the desired text and then press <kbd>Enter</kbd> once again to confirm.</li><li>Similarly, to create a sub-node, press <kbd>Tab</kbd>, enter the desired text and then press <kbd>Enter</kbd>.</li><li>To create a parent, use <kbd>Ctrl</kbd>+<kbd>Enter</kbd> instead.</li><li>To remove a node, press <kbd>Delete</kbd>.</li><li>To move a node up or down, press <kbd>Page Up</kbd> or <kbd>Page Down</kbd>.</li><li>To adjust the font size, color of the text or background or to add a link, click on a node and use the floating panel that appears to the right.</li><li>To select one or more notes, drag and drop across the map.</li><li>Right click the node to bring a contextual menu with options such as creating new nodes, focusing on a particular notes or creating links between them.</li><li>Use the buttons at the top-left to change the positioning of the nodes relative to the root node (to the left, to the right, or to both sides).</li><li>In the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area, an <a href=\"#root/_help_0Ofbk1aSuVRu\">image reference</a> can be copied by pressing the <span class=\"tn-icon bx bx-copy\"></span> button, to paste the mind map in a text note.</li><li>From the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, the diagram can be exported either as SVG (vectorial) or PNG (raster) by selecting <em>Export as image</em>.</li><li>The note can be set as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> which will disable all editing features.</li></ul>",
"_help_W8vYD3Q1zjCR": "<p>The <em>File</em> note type can be used to attach various external files such as images, videos or PDF documents.</p><h2>Uploading a file</h2><p>Since these files come from an external source, it is not possible to create a <em>File</em> note type directly:</p><ul><li>Drag a file into the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Right click a note and select <em>Import into note</em> and point it to one of the supported files.</li></ul><h2>Supported file types</h2><h3>PDFs</h3><p>PDFs can be uploaded to Trilium and they will display a live preview with full support for various features such as table of contents, annotations, as well as remembering the last page read. For more information, see the dedicated <a class=\"reference-link\" href=\"#root/_help_XJGJrpu7F9sh\">PDFs</a> page.</p><h2>Office documents</h2><p>Trilium offers previews for Office documents such as Word (<code>.docx</code>), Excel (<code>.xlsx</code>) and PowerPoint (<code>.pptx</code>). For more information, see the dedicated <a class=\"reference-link\" href=\"#root/_help_KG48zgNY31NW\">Office documents</a>.</p><h3>Images</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:879/766;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/2_File_image.png\" width=\"879\" height=\"766\"></figure><p>Interaction:</p><ul><li>An <a href=\"#root/_help_0Ofbk1aSuVRu\">image reference</a> can be copied by pressing the <span class=\"tn-icon bx bx-copy\"></span> icon from the <a class=\"reference-link\" href=\"#root/_help_1P8QXI5edXNd\">Note buttons</a> area, which allows pasting it in a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note.</li></ul><h3>Videos</h3><p>See <a class=\"reference-link\" href=\"#root/_help_AjqEeiDUOzj4\">Audio & Video</a>.</p><h3>Audio</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:850/243;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/1_File_image.png\" width=\"850\" height=\"243\"></figure><p>Adding a supported audio file will reveal a basic audio player that can be used to play it.</p><p>Interactions:</p><ul><li>The audio can be played/paused using the dedicated button.</li><li>Dragging the mouse across, or clicking the progress bar will seek through the song.</li><li>The volume can be set.</li><li>The playback speed can be adjusted via the contextual menu next to the volume.</li></ul><h3>Text files</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:926/347;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File_image.png\" width=\"926\" height=\"347\"></figure><p>Files that are identified as containing text will show a preview of their content. One common use case for this type of file is to embed text files whose content is not necessarily of interest to the user, such as third-party libraries or generated content, that can then be downloaded if needed.</p><p>Note that generally text files will be <a href=\"#root/_help_mHbBMPDPkVV5\">imported</a> as either <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> or <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes. To bypass this behavior and create a <em>File</em> note type, use the <em>Import into note</em> feature and uncheck <em>Import HTML, Markdown and TXT as text notes</em>, as well as <em>Import recognized code files as code notes</em>. </p><p>Since one of the use cases for having files instead of notes is to display large files, the content preview is limited to a relatively small amount of characters. To view the full file, consider opening it in an external application.</p><h3>GPS tracks</h3><p>Trilium displays information about GPS tracks in <code>.gpx</code> format, such as the distance, duration, elevation profile, tracks, markers.</p><p>When a <code>.gpx</code> note is dropped in a <a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>, the track itself will also be displayed on the map.</p><figure class=\"image\"><img style=\"aspect-ratio:1500/807;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/4_File_image.png\" width=\"1500\" height=\"807\"></figure><h3>Fonts</h3><p>Supported font formats will show an interactive preview of the font:</p><ul><li>A field to type in a custom text.</li><li>A slider to change the font size of the preview.</li><li>A preview of the text at the given size.</li><li>A sampling of various font sizes for this font.</li><li>The Latin alphabet.</li></ul><p>Additionally, enabling <em>In font picker</em> will make the font available in the <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Appearance</em> font selection. See <a class=\"reference-link\" href=\"#root/_help_w4rMEhJsALlA\">Personalizing the font</a> for more information.</p><h3>Unknown file types</h3><figure class=\"image image-style-align-center image_resized\" style=\"width:50%;\"><img style=\"aspect-ratio:532/240;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/3_File_image.png\" width=\"532\" height=\"240\"></figure><p>If the file could not be identified as any of the supported file types from above, it will be treated as an unknown file. In this case, all the default interactions will be available such as downloading or opening the file externally, but there will be no preview of the content.</p><h2>Interaction</h2><ul><li>Regardless of the file type, a series of buttons will be displayed in the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> area.<ul><li><span class=\"tn-icon bx bx-download\"></span> (Download), which will download the file for local use.</li><li><span class=\"tn-icon bx bx-link-external\"></span> (Open), will will open the file with the system-default application.</li><li><span class=\"tn-icon bx bx-folder-open\"></span> (Upload new revision) to replace the file with a new one.</li></ul></li><li>It is <strong>not</strong> possible to change the note type of a <em>File</em> note.</li><li>Convert into an <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> from the <a href=\"#root/_help_8YBEPzcpUgxw\">note menu</a>.</li></ul><h2>Relation with other notes</h2><ul><li><p>Files are also displayed in the <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> based on their type:</p><img class=\"image_resized\" style=\"aspect-ratio:853/315;width:50%;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/5_File_image.png\" width=\"853\" height=\"315\"></li><li><p>Non-image files can be embedded into text notes as read-only widgets via the <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> functionality.</p></li><li><p>Image files can be embedded into text notes like normal images via <a class=\"reference-link\" href=\"#root/_help_0Ofbk1aSuVRu\">Image references</a>.</p></li></ul><h2>File size limit</h2><p>An individual file cannot be bigger than 374 MiB. For more information see <em>Maximum import size</em> in <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a>.</p>",
"_help_XJGJrpu7F9sh": "<figure class=\"image image_resized\" style=\"width:74.34%;\"><img style=\"aspect-ratio:1360/698;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/PDFs_image.png\" width=\"1360\" height=\"698\"></figure><p>PDFs file can be uploaded in Trilium, where they will be displayed without the need to download them first.</p><p>Since v0.102.0, PDFs will be rendered using Trilium's built-in PDF viewer, which is a customization of <a href=\"https://mozilla.github.io/pdf.js/\">Mozilla's PDF.js viewer</a> (also built-in in the Mozilla Firefox browser). Versions prior to that render PDFs using the browser's default PDF viewer.</p><h2>Features</h2><ul><li>The last page viewed and scroll position is maintained in between restarts or note navigations.</li><li>Annotations (text, highlights) as well as comments. These are saved automatically.</li><li>Forms can be filled.</li><li>Can be printed or downloaded.</li><li>Can be saved as a <a href=\"#root/_help_KC1HB96bqqHX\">template</a> and the content of the PDF will be copied over to the new note. This is especially useful in combination with annotations or filled forms.</li><li>Integrates with the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> by displaying the list of pages with thumbnails, table of contents and a listing of the annotations.</li><li>Basic support for signatures (the hand-drawn ones, not proper digital signatures), similar to annotations. Signatures are stored and can be reused across multiple documents (up to 5).</li></ul><h2>Storing last position and settings</h2><p>For every PDF, Trilium will remember the following information:</p><ul><li>The current page.</li><li>The scroll position, within the current page.</li><li>The rotation of the page.</li></ul><p>This makes it useful when reading large documents since the position is remembered automatically. This happens in the background, however it's recorded only a few seconds after stopping any scroll actions.</p><aside class=\"admonition tip\"><p>Technically, the information about the scroll position and rotation is stored in the <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> section, in a dedicated attachment called <code>pdfHistory.json</code>.</p></aside><h2>Annotations</h2><p>Since v0.102.0 it's possible to annotate PDFs. To do so, look for the annotation buttons on the right side of the PDF toolbar (<img src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/1_PDFs_image.png\" width=\"120\" height=\"32\">).</p><p>Since v0.103.0:</p><ul><li>Annotations are disabled if the note is marked as <a class=\"reference-link\" href=\"#root/_help_CoFPLs3dRlXc\">Read-Only Notes</a>.</li><li>Comments can also be added, which is similar to highlights but also attach a text.</li><li>The <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> also displays a list of annotations (highlights, comments).</li></ul><h3>Supported annotations</h3><p>The following annotation methods are supported:</p><ul><li><strong>Highlight</strong><br>Allows highlighting text with one of the predefined colors.<ul><li>The thickness is also adjustable.</li><li>It's also possible to highlight the blank space, turning the feature more into a thicker pen.</li></ul></li><li><strong>Text</strong><br>Allows adding arbitrary text, with a custom color and size.</li><li><strong>Pen</strong><br>Allows free drawing on the document, with variable color, thickness and opacity.</li><li><strong>Image</strong><br>Allows inserting images from outside Trilium directly into the document.</li></ul><h3>Editing existing annotations</h3><p>Although annotations are stored in the PDF itself, they can be edited. To edit an annotation, press one of the annotation buttons from the previous section to enter edit mode and click on an existing annotation. This will reveal a toolbar with options to customize the annotation (e.g. to change a color), as well as the possibility to remove it.</p><h3>How are annotations stored</h3><p>Annotations are stored directly in the PDF. When modifications are made, Trilium will replace the PDF with the new one.</p><p>Since modifications are automatically saved, there's no need to manually save the document after making modifications to the annotations.</p><p>The benefit of “baked-in annotations” is that they are also accessible if downloading (for external use outside Trilium) or sharing the note.</p><p>The downside is that the entire PDF needs to be sent back to the server, which can slow down performance for larger documents. If you encounter any issues from this system, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a>.</p><h2>Linking to a page or an annotation</h2><p>A link can open a PDF at a given page, or at one of its annotations. To create one:</p><ul><li>To link to a page, right-click the page in the <em>Pages</em> section of the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> and select <em>Copy reference</em>.</li><li>To link to an annotation, right-click it in the <em>Annotations</em> section of the sidebar and select <em>Copy reference</em>.</li></ul><p>Pasted into a text note, the reference becomes one of the <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a>, showing the title of the PDF followed by the page (<em>Page 5</em>), or by <em>Annotation on page 5</em> for a reference to an annotation. Clicking it opens the PDF and scrolls to the page or to the annotation.</p><p>A reference to an annotation also carries its page, so a link to an annotation that was deleted still opens the right page.</p><aside class=\"admonition note\"><p>An annotation drawn since the PDF was opened does not have a permanent identifier until the PDF is opened again, so a reference copied for it points at its page only.</p></aside><h2>Filling out forms</h2><p>Similar to annotations, forms are also supported by Trilium since v0.102.0. If the document has fields that can be filled-in, they will be indicated with a colored background.</p><p>Simply type text in the forms and they will be automatically saved.</p><h2>Sidebar navigation</h2><p>See the dedicated section on PDFs in <a class=\"reference-link\" href=\"#root/_help_2dcGDhp9WFKb\">Outline tab</a>.</p><h2>Share functionality</h2><p>PDFs can also be shared using the <a class=\"reference-link\" href=\"#root/_help_R9pX4DGra2Vt\">Sharing</a> feature. This will also use Trilium's customized PDF viewer.</p><p>If you are using a reverse proxy on your server with strict access limitations for the share functionality, make sure that <code>[host].com/pdfjs</code> directory is accessible. Note that this directory is outside the <code>/share</code> route as it's common with the rest of the application.</p><h2>OCR</h2><p>PDFs are eligible for <a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>, which means that their text can be used in <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p>",
"_help_AjqEeiDUOzj4": "<figure class=\"image image-style-align-right image_resized\" style=\"width:61.8%;\"><img style=\"aspect-ratio:953/587;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/Audio%20%26%20Video_image.png\" width=\"953\" height=\"587\"></figure><p>Starting with v0.103.0, Trilium has a custom media player for both video and audio files, which offers more features than the built-in player.</p><p>Versions prior to v0.103.0 also support media, but using the built-in player.</p><p>The file is streamed directly, so when accessing the note from a server it doesn't have to download the entire file to start playing it.</p><h2>Note on large media files</h2><p>Although Trilium offers support for media files, it is generally not meant to be used with very large files. Uploading large media will cause the <a class=\"reference-link\" href=\"#root/_help_wX4HbRucYSDD\">Database</a> to balloon, as well as any <a class=\"reference-link\" href=\"#root/_help_ODY7qQn5m2FT\">Backup</a> of it. In addition, there might be slowdowns when first uploading the files. Otherwise, a large database should not impact the general performance of Trilium significantly.</p><h2>Supported formats</h2><p>Trilium uses the built-in media decoding mechanism of the browser (or Electron/Chromium when running on the desktop). Starting with v0.103.0, a message will be displayed instead when a media format is not supported.</p><h2>Interactions</h2><p>To play/pause, simply click anywhere on the media. For video files, the controls at the bottom will hide automatically after playing, simply move the mouse to show them again.</p><p>The bottom bar has the following features:</p><ul><li>A track bar to seek across the media. Audio files up to 60 MB will display a waveform seekbar, to give a visual overview of the track's structure: silences, pauses, and louder segments.</li><li>On the left of the track bar, the current time is indicated.</li><li>On the right of the track bar, the remaining time is indicated.</li><li>On the left side there are buttons to:<ul><li>Adjust the playback speed (e.g. 0.5x, 1x).</li><li>Play mode (applies to all media from the parent note):<ul><li>Play once — play the media until it ends, then stop.</li><li>Loop — replay the media automatically once it ends.</li><li>Play next — when the current item ends, continue with the next one in the same parent note until the last item finishes.</li></ul></li><li>Rotate the video by 90 degrees (video only).</li></ul></li><li>In the center:<ul><li>Previous media — jumps to the previous media: the nearest media note above the current one in the tree (within the same parent note) in the case of media notes, or the previous media attachment.</li><li>Go back by 10s</li><li>Play/pause</li><li>Go forward by 10s</li><li>Next media — jumps to the next media: the nearest media note below the current one in the tree (within the same parent note) in the case of media notes, or the next media attachment.</li></ul></li><li>On the right side:<ul><li>Mute button</li><li>Volume adjustment</li><li>Full screen (video only)</li><li>Zoom to fill, which will crop the video so that it fills the entire window (video only).</li><li>Picture-in-picture, if the browser supports it (video only).</li></ul></li></ul><h2>Including media in notes</h2><figure class=\"image\"><img style=\"aspect-ratio:1395/145;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/File/1_Audio%20%26%20Video_image.png\" width=\"1395\" height=\"145\"><figcaption>An audio note include (configured to the \"Small\" size).</figcaption></figure><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> and <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes can embed an interactive media player directly in the note content. To do so, include the audio or video file:</p><ul><li><strong>Text notes:</strong> in the formatting toolbar, click <em>Insert</em> → <em>Include</em>.</li><li><strong>Markdown notes:</strong> type <code>/include</code> press <kbd>Enter</kbd>.</li></ul><p>Then select the audio/video file note to be included.</p><h2>Keyboard shortcuts</h2><p>The following keyboard shortcuts are supported by the media player:</p><figure class=\"table\"><table><tbody><tr><td><kbd>Space</kbd></td><td>Play/pause</td></tr><tr><td><kbd>Left arrow key</kbd></td><td>Go back by 10s</td></tr><tr><td><kbd>Right arrow key</kbd></td><td>Go forward by 10s</td></tr><tr><td><kbd>Ctrl</kbd> + <kbd>Left arrow key</kbd></td><td>Go back by 1 min</td></tr><tr><td><kbd>Ctrl</kbd> + <kbd>Right arrow key</kbd></td><td>Go right by 1 min</td></tr><tr><td><kbd>Page Up</kbd></td><td>Navigate to the previous media</td></tr><tr><td><kbd>Page Down</kbd></td><td>Navigate to the next media</td></tr><tr><td><kbd>F</kbd></td><td>Toggle full-screen</td></tr><tr><td><kbd>M</kbd></td><td>Mute/unmute</td></tr><tr><td><kbd>Home</kbd></td><td>Go to the beginning of the media</td></tr><tr><td><kbd>End</kbd></td><td>Go to the end of the media</td></tr><tr><td><kbd>Up</kbd></td><td>Increase volume by 5%</td></tr><tr><td><kbd>Down</kbd></td><td>Decrease volume by 5%</td></tr><tr><td><kbd>Alt+F1</kbd> (customizable)</td><td>Show this list of keyboard shortcuts on screen.</td></tr></tbody></table></figure>",
"_help_KG48zgNY31NW": "<p>Since v0.105.0, office documents stored in Trilium display an inline preview of their content, without the need to download them or open them in an external application.</p><h2>Supported formats</h2><ul><li>Microsoft Office formats: Word (<code>.docx</code>), Excel (<code>.xlsx</code>) and PowerPoint (<code>.pptx</code>).</li><li>The OpenDocument alternatives to the previous formats (Text, Spreadsheet, Presentation), created by editors such as LibreOffice and OpenOffice.</li><li><a href=\"https://en.wikipedia.org/wiki/Rich_Text_Format\">Rich Text Format (RTF)</a>.</li><li><a href=\"https://en.wikipedia.org/wiki/EPUB\">EPUB</a> e-books.</li></ul><aside class=\"admonition note\"><p>Older Microsoft Office formats (<code>.doc</code>, <code>.xls</code>, <code>.ppt</code>) are not supported.</p></aside><h2>How it works</h2><p>The document is converted to a simplified representation on the server and rendered as read-only content, similar to a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note.</p><p>The preview generally preserves:</p><ul><li>Headings, paragraphs and text alignment.</li><li>Text formatting: bold, italic, underline, strikethrough, subscript/superscript, text and highlight colors, fonts and font sizes.</li><li>Bulleted and numbered lists.</li><li>Tables, including merged cells and cell background colors.</li><li>Embedded images.</li><li>Links and footnotes.</li></ul><p>To keep links readable regardless of the theme, the default hyperlink color applied automatically by word processors is ignored; links that were deliberately given a custom color by the author keep it.</p><h2>Limitations</h2><ul><li>The preview is read-only. To edit the document, download it or open it in an external application; the content of the note is not affected by the preview. Alternatively copy and paste it into a text note.</li><li>The preview is a simplified rendering: complex layouts (columns, text boxes, headers and footers), charts and the precise styling of table borders are not reproduced.</li><li>Documents larger than 20 MB are not previewed, to keep the server responsive. The usual download and open actions remain available.</li><li>If the document cannot be converted, a notice is displayed instead and the file can still be downloaded or opened externally.</li></ul><h2>Relation with other features</h2><ul><li>The same preview is used when an office document is displayed in the <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> or embedded in a text note via <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>, as well as for office documents stored as <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a>.</li><li>Independently of the preview, the text content of office documents is also extracted in the background so that it can be found with <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> via <a class=\"reference-link\" href=\"#root/_help_TiQbQDgP8L5t\">Text Extraction (OCR)</a>.</li><li><code>.csv</code> and <code>.xlsx</code> files can be converted to <a class=\"reference-link\" href=\"#root/_help_GWHEkY4I4OE3\">Spreadsheets</a> via the <a href=\"#root/_help_mHbBMPDPkVV5\">import</a> function.</li></ul>",
"_help_GWHEkY4I4OE3": "<figure class=\"image\"><img style=\"aspect-ratio:1102/573;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Spreadsheets_image.png\" width=\"1102\" height=\"573\"></figure><aside class=\"admonition important\"><p>Spreadsheets are a new type of note introduced in v0.103.0 and are currently considered experimental/beta. As such, expect major changes to occur to this note type.</p></aside><p>Spreadsheets provide a familiar experience to Microsoft Excel or LibreOffice Calc, with support for formulas, data validation and text formatting.</p><h2>Spreadsheets vs. collections</h2><p>There is a slight overlap between spreadsheets and the <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> collection. In general the table collection is useful to track meta-information about notes (for example a collection of people and their birthdays), whereas spreadsheets are quite useful for calculations since they support formulas.</p><p>Spreadsheets also benefit from a wider range of features such as data validation, formatting and can work on a relatively large dataset.</p><h2>Data intercompatibility (import/export)</h2><p>Starting with v0.104.0, Trilium provides a level of data intercompatibility between the internal format (Univer) and the following formats:</p><ul><li>Microsoft Excel (.xlsx)<ul><li>Preserves basic formatting (fonts, sizes, borders, backgrounds).</li><li>Formulas are preserved, but note that not all Excel functions are supported and vice-versa with Univer.</li><li>Images (cell-bound or floating), without preserving rotation.</li><li>Supports multi-sheets natively.</li></ul></li><li>Comma-Separated Values (.csv)<ul><li>Since it's a text-based format, any formatting is lost.</li><li>Formulas are evaluated and turned into their final value instead.</li><li>Multi-sheets spreadsheets are exported as a single ZIP containing a CSV file per sheet.</li></ul></li></ul><p>Both <a href=\"#root/_help_mHbBMPDPkVV5\">import and export</a> are supported, as follows:</p><ul><li>To import a file, simply drag it into the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and it will be converted into a spreadsheet note.<ul><li>To avoid this behavior (e.g. to import a .xlsx file as an actual <a class=\"reference-link\" href=\"#root/_help_W8vYD3Q1zjCR\">File</a>), uncheck the corresponding option in the <a href=\"#root/_help_mHbBMPDPkVV5\">Import dialog</a>.</li><li>Multiple files can be imported at the same time, including a mixture of .csv and .xlsx files. Folder structure can be preserved by using a .zip file.</li></ul></li><li>Unlike importing, exporting is on a per-note basis:<ul><li>In the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>, choose the <em>Export to Excel</em> or <em>Export to CSV</em> options.</li><li>If exported as a single file via <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a>, the resulting file will be a custom <code>.triliumsheet</code> file that preserves the spreadsheet as-is.<ul><li>The export is intentionally a different process than the normal <a class=\"reference-link\" href=\"#root/_help_mHbBMPDPkVV5\">Import & Export</a> functionality because it does conversion to multiple formats with varying degrees of compatibility.</li></ul></li></ul></li></ul><p>Cells pasted from Excel or another application keep their formatting except for the font, so they use the spreadsheet's font like the rest of the cells.</p><aside class=\"admonition important\"><p>Import & export for both .xlsx and .csv files are supported on a best-effort basis. It does not support advanced features (data validation, scripting, etc.). If you notice a particular issue, it can be <a href=\"#root/_help_wy8So3yZZlH9\">reported</a>, however all bug reports must contain a sample file in order to be taken into consideration.</p></aside><h2>Supported features</h2><p>The spreadsheet has support for the following features:</p><ul><li>Since v0.104.0, images that can be either inside a cell or floating above.<ul><li>The images are saved as <a class=\"reference-link\" href=\"#root/_help_0vhv7lsOLy82\">Attachments</a> for performance reasons.</li><li>The image upload respects the same compression settings as text <a class=\"reference-link\" href=\"#root/_help_mT0HEkOsz6i1\">Images</a>.</li></ul></li><li>Filtering</li><li>Sorting</li><li>Data validation</li><li>Conditional formatting</li><li>Notes / annotations</li><li>Find / replace</li></ul><p>We might consider adding <a href=\"https://docs.univer.ai/guides/sheets/features/filter\">other features</a> from Univer at some point. If there is a particular feature that can be added easily, it can be discussed over <a href=\"#root/_help_wy8So3yZZlH9\">GitHub Issues</a>.</p><h3>Share functionality</h3><p>Spreadsheets can be <a href=\"#root/_help_R9pX4DGra2Vt\">shared</a>, case in which a best-effort HTML rendering of the spreadsheet is done:</p><ul><li>Preserves basic formatting.</li><li>Cells with formulas display the precalculated value instead of the formula.</li></ul><p>Since v0.104.0:</p><ul><li>Numbers and dates are properly formatted.</li><li>Images are shown inside a cell or floating above, including rotation.</li></ul><p>For more advanced use cases, this will most likely not work as intended. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report issues</a>, but keep in mind that we might not be able to have a complete feature parity with all the features of Univer.</p><h2>Features not supported yet</h2><h3>Regarding Pro features</h3><p>Univer spreadsheets also feature a <a href=\"https://univer.ai/pro\">Pro plan</a> which adds quite a lot of functionality such as charts, printing, pivot tables, export, etc.</p><p>As the Pro plan needs a license, Trilium does not support any of the premium features. Theoretically, pro features can be used in trial mode with some limitations, we might explore this direction at some point.</p><h3>Planned features</h3><p>There are a few features that are already planned but are not supported yet:</p><ul><li>Trilium-specific formulas (e.g. to obtain the title of a note).</li><li>User-defined formulas</li><li>Cross-workbook calculation</li></ul><p>If you would like us to work on these features, consider <a href=\"https://triliumnotes.org/en/support-us\">supporting us</a>.</p><h3>Mobile support</h3><p>Versions prior to v0.104.0 have no dedicated mobile support, which means that the interaction is difficult without a mouse and keyboard. Starting with v0.104.0 we integrate Univer's mobile plugin, which introduces feature such as drag to pan which makes the interface more usable on mobile.</p>",
"_help_6RM1Q7ppFVoj": "<p>Trilium has always supported Markdown through its <a href=\"#root/_help_Oau6X9rCuegd\">import feature</a>, however the file was either transformed to a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note (converted to Trilium's internal HTML format) or saved as a <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> note with only syntax highlight.</p><p>This note type is a split view, meaning that both the source code and a preview of the document are displayed side-by-side. See <a class=\"reference-link\" href=\"#root/_help_SL5f1Auq7sVN\">Note types with split view</a> for more information.</p><h2>Rationale</h2><p>The goal of this note type is to fill a gap: rendering Markdown but not altering its structure or its whitespace which would inevitably change otherwise through import/export.</p><p>Even if Markdown is now specially treated by having a preview mechanism, Trilium remains at its core a WYSWYG editor so Markdown will not replace text notes.</p><aside class=\"admonition note\"><p>Feature requests regarding the Markdown implementation will be considered, but if they are outside the realm of Trilium, they will not be implemented. One of the core aspects of the Markdown integration is that it reuses components that are already available through other features of the application.</p></aside><h2>Features</h2><h3>Source view pane</h3><ul><li>Syntax highlighting for the Markdown syntax.</li><li>Nested syntax highlighting for code inside code blocks, including <a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> in <code>```mermaid</code> blocks.</li><li>When editing larger documents, the preview scrolls along with the source editor.</li></ul><h3>Preview pane</h3><p>The following features are supported by Trilium's Markdown format and will show up in the preview pane:</p><ul><li><p>All standard and GitHub-flavored syntax (basic formatting, tables, blockquotes).</p></li><li><p>Basic HTML is also supported (e.g. collapsible blocks using <code><details></code> and <code><summary></code>).</p></li><li><p>Code blocks with syntax highlight.</p><ul><li>The language must be specified for syntax highlight to be applied (e.g. <code>```js</code>).</li><li>Code blocks will respect the text wrapping from the <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> section in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>.</li></ul></li><li><p><a class=\"reference-link\" href=\"#root/_help_NwBbFdNZ9h7O\">Block quotes & admonitions</a></p></li><li><p><a class=\"reference-link\" href=\"#root/_help_YfYAtQBcfo5V\">Math Equations</a> (both inline and block)</p></li><li><p><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> using <code>```mermaid</code></p></li><li><p><a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a> (no built-in Markdown syntax, but HTML syntax works just fine):</p><pre><code class=\"language-text-html\"><figure class=\"include-note\" data-note-id=\"vJDjQm0VK8Na\" data-box-size=\"expandable\">\n <figcaption>An optional caption, with <strong>HTML</strong> formatting</figcaption>\n</figure></code></pre><ul><li>The caption is optional. Markdown is not processed inside the HTML block, so format the caption with HTML tags.</li><li>Includes written as <code><section class=\"include-note\"></code>, the syntax of earlier versions, still work.</li><li>These can also be quickly created via the <code>/include</code> command or via a dedicated keyboard shortcut (not assigned by default).</li></ul></li><li><p><a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> via its HTML syntax, or through a <em>Wikilinks</em>-like format (only <a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>):</p><pre><code class=\"language-text-x-trilium-auto\">[[Hg8TS5ZOxti6]]</code></pre></li><li><p>To-do lists with extended task states:</p><figure class=\"table\"><table class=\"ck-table-resized\" style=\"border-style:none;\"><colgroup><col style=\"width:80.6%;\"><col style=\"width:19.4%;\"></colgroup><tbody><tr><td><pre><code class=\"language-text-x-markdown\">- [ ] None\n- [/] Doing\n- [X] Done\n- [?] Maybe\n- [-] Cancelled</code></pre></td><td><figure class=\"image image-style-align-right\"><img style=\"aspect-ratio:218/221;\" src=\"{{helpAssets}}/User%20Guide/Note%20Types/Markdown_image.png\" width=\"218\" height=\"221\"></figure></td></tr></tbody></table></figure><p>Task states are customizable: you can reorder them, create new ones with different colors and symbols, or delete the ones you don't need. See <a class=\"reference-link\" href=\"#root/_help_i16PM6A7GXdU\">Customizing to-do task states</a> for more details.</p><p>Note that to-do items with task states other than \"None\" and \"Done\" are Trilium-specific and may not work well with other Markdown software.</p></li><li><p><a class=\"reference-link\" href=\"#root/_help_AgjCISero73a\">Footnotes</a> are also supported via the corresponding Markdown syntax:</p><pre><code class=\"language-text-x-trilium-auto\">This is [^1], while this is [^2].\n\n[^1]: the first footnote\n[^2]: the second footnote</code></pre><ul><li>These can also be quickly created using the <code>/footnote</code> command.</li></ul></li><li><p>Page breaks for <a class=\"reference-link\" href=\"#root/_help_NRnIZmSMc5sj\">Printing & Exporting as PDF</a>:</p><pre><code class=\"language-text-x-trilium-auto\"><div class=\"page-break\"></div></code></pre></li><li><p>Highlights (background color) are supported both via the <code>==</code> Markdown syntax, as well as the canonical HTML representation in Trilium:</p><pre><code class=\"language-text-x-trilium-auto\">==highlighted==\n<span style=\"background-color:#e5e64d;--tn-background:#e5e64d;\">Highlighted</span></code></pre></li></ul><h3>Links</h3><p>Multiple types of links are supported:</p><ul><li><p>Web URLs can be written with the standard Markdown syntax:</p><pre><code class=\"language-text-x-trilium-auto\">[Wikipedia](https://www.wikipedia.org)</code></pre></li><li><p><a href=\"#root/_help_hrZ1D00cLbal\">Reference link</a> to other notes with dynamic title, either by manually entering the note ID or via the <em>Add link</em> dialog:</p><pre><code class=\"language-text-x-trilium-auto\">[[B9oMG6rFvvfq]]</code></pre></li><li><p><a href=\"#root/_help_hrZ1D00cLbal\">Reference link</a> to other notes with a custom text:</p><pre><code class=\"language-text-x-trilium-auto\">[This is a link](#root/LhtnZxtVsUMp)</code></pre></li></ul><p>To create a link, either:</p><ul><li>Type it manually using the syntax described above.</li><li>Use the <em>Add link</em> dialog by pressing <kbd>Ctrl</kbd>+<kbd>L</kbd> or typing the <code>/link</code> command.</li></ul><p><a class=\"reference-link\" href=\"#root/_help_UmgZAfcltxkS\">Link Previews</a> are also rendered, but there is no mechanism to insert them automatically as of now, they have to be copied from a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note instead.</p><h3>Keyboard shortcuts</h3><p>The Markdown notes share some of the keyboard shortcuts from <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes:</p><ul><li><em>Cut to note</em> (<kbd>Ctrl</kbd>+<kbd>X</kbd>) which cuts the selection into a new child note.</li><li><em>Add link</em> (<kbd>Ctrl</kbd>+<kbd>L</kbd>) which shows the dialog to create external or reference links.</li><li><em>Date/time</em> (<kbd>Alt</kbd>+<kbd>T</kbd>) which respects the same formatting as text notes.</li><li><em>Include note</em> (not assigned by default), which triggers the same dialog to insert notes as the one for text notes.</li></ul><p>In addition, the following formatting keyboard shortcuts are available:</p><ul><li><kbd>Ctrl</kbd>+<kbd>B</kbd> to toggle <strong>bold</strong>.</li><li><kbd>Ctrl</kbd>+<kbd>I</kbd> to toggle <em>italic</em>.</li><li><kbd>Ctrl</kbd>+<kbd>M</kbd> to wrap the current selection in an inline math (<code>$</code>).</li><li><kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>X</kbd> to toggle <del>strikethrough</del>.</li></ul><h3>Images & attachments</h3><p>Images can be inserted into the document in four different methods:</p><ul><li>Drag & drop directly into the editor area.</li><li>Pasting an image from clipboard.</li><li>Pasting a reference to another <a href=\"#root/_help_0vhv7lsOLy82\">attachment</a> (e.g. <em>Copy reference to clipboard</em> button).</li><li>Use the <code>/image</code> slash command.</li></ul><p>An image reference to an attachment looks like this:</p><pre><code class=\"language-text-x-trilium-auto\"></code></pre><h3>Auto-completion</h3><h4>Slash commands</h4><p>Just like <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, Markdown notes support a selection of slash commands:</p><ul><li>Inserting the current date & time (<code>/date</code>).</li><li><a href=\"#root/_help_nBAXQFj20hS1\">Including</a> another note (<code>/include</code>).</li><li>Uploading and inserting an image (<code>/image</code>).</li><li>Inserting a note link (<code>/link</code>).</li><li>Inserting a math equation block (<code>/math</code>).</li><li>Inserting a <a href=\"#root/_help_AgjCISero73a\">footnote</a> (<code>/footnote</code>).</li><li>Inserting a <a href=\"#root/_help_s1aBHPd79XYj\">Mermaid</a> diagram (<code>/mermaid</code>), with one variant per sample template (e.g. <code>/mermaid:flowchart</code>).</li><li>Inserting a collapsible block (<code>/collapsible</code>).</li><li>Inserting <a href=\"#root/_help_rJ9grSgoExl9\">tabs</a> (<code>/tabs</code>).</li><li>Inserting a page break for printing (<code>/page-break</code>).</li><li>Inserting a table (<code>/table</code>).</li><li>Creating admonitions (e.g. <code>/tip</code>, <code>/note</code>, <code>/important</code>, <code>/caution</code>, <code>/warning</code>).</li><li>Inserting task items (<code>/todo:<state></code>, e.g. <code>/todo:done</code>), one per configured task state.</li><li>Inserting code snippets (<code>/snippet:<name></code>) from your Markdown/plain-text snippet notes.</li></ul><p>The list shows each command by its title, as in Text notes. Typing a command's title, its keyword (as listed above) or a related word such as <code>latex</code> or <code>grid</code> finds it.</p><p>Note that slash commands only work outside of code blocks and inline code.</p><h4>Linking notes with <code>@</code> or <code>[[</code></h4><p>As in <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes, typing <code>@</code> at the start of a line or after a space opens the note search. Picking a note replaces what was typed with a link to it in the Wikilinks-like format (<code>[[noteId]]</code>), which the preview shows as an <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> with the note's title.</p><p>The search runs on everything typed after the <code>@</code>, spaces included, so a title such as <code>@My meeting notes</code> can be typed out; press <kbd>Esc</kbd> to close the list and go on writing. If no note fits, the list offers to create one, as a child of the Markdown note or in the inbox; the link is inserted once the note is created.</p><p>You can also start typing the link directly: <code>[[</code> opens the same list, and closing the brackets yourself dismisses it. To change where an existing link points, place the cursor inside it and pick another note.</p><p>Like slash commands, <code>@</code> and <code>[[</code> do nothing inside code blocks and inline code.</p><p>In the editor, a <code>[[noteId]]</code> link shows as the note's icon and title, so you can tell which note it points to without looking up its ID. Clicking it, or moving the cursor next to it, shows the link as written so it can be edited. Links inside code blocks and inline code are left as they are.</p><h4>Code block language auto-completion</h4><p>Starting with v0.104.0, typing ``` to insert a code block will automatically open a list of suggested language types which have syntax highlighting.</p><p>The list of languages matches the one for <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes set in <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a>, it's not the full list of languages supported by Trilium.</p><h3>Other features</h3><ul><li>The <a class=\"reference-link\" href=\"#root/_help_BFvAtE74rbP6\">Table of contents</a> will be displayed in the <a class=\"reference-link\" href=\"#root/_help_RnaPdbciOfeq\">Right Sidebar</a> based on the Markdown-level headings.</li><li>A Markdown note included in a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note shows its source, its preview or both, and can be edited in place. See <em>Included Markdown</em> in <a class=\"reference-link\" href=\"#root/_help_nBAXQFj20hS1\">Include Note</a>.</li></ul><h3>Shared notes</h3><p>When a Markdown note is <a href=\"#root/_help_R9pX4DGra2Vt\">shared publicly</a>, it will be rendered with extended formatting just like <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</p><p>Most of the features described previously should be supported. If you face any issues, feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report it</a> alongside a sample Markdown file.</p><h2>Creating Markdown notes</h2><p>There are two ways to create a Markdown note:</p><ol><li>Create a new note (e.g. in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>) and select the type <em>Markdown</em>, just like all the other note types.</li><li>Create a note of type <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> and select as the language either <em>Markdown</em> or <em>GitHub-Flavored Markdown</em>. This maintains compatibility with your existing notes prior to the introduction of this feature.</li></ol><aside class=\"admonition note\"><p>There is no distinction between the new Markdown note type and code notes of type Markdown; internally both are represented as <a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> notes with one of the following MIME types:</p><ul><li><code>text/markdown</code></li><li><code>text/x-markdown</code></li><li><code>text/x-gfm</code> (GitHub Flavored Markdown)</li></ul></aside><h2>Import/export</h2><h3>Import</h3><p>By default, when importing a single Markdown file it automatically gets converted to a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. To avoid that and have it imported as a Markdown note instead:</p><ul><li>Right click the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Import into note</em>.</li><li>Select the file normally.</li><li>Uncheck <em>Import HTML, Markdown and TXT as text notes if it's unclear from the metadata</em>.</li></ul><p>When importing a Trilium ZIP, it will preserve the Markdown type without converting to text notes thanks to the meta-information in it.</p><h3>Exporting</h3><p>When exporting Markdown files, the extension is preserved and the content remains the same as in the source view (with some small exceptions such as handling of attachments).</p><p>When exporting Markdown files as ZIP, choosing HTML or Markdown as the export format makes no difference as that only affects <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes.</p><p>If the Markdown note contains attachments, a ZIP export will rewrite the links to attachments so that they are replaced with a relative path to the attachment. On import, the links are re-written back.</p><h2>Conversion between text notes and Markdown notes</h2><p><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes can be converted into Markdown notes and vice versa. See <a class=\"reference-link\" href=\"#root/_help_jludwdW7N4hg\">Converting between note types</a>.</p><h2>Sync-scrolling & block highlight</h2><p>When scrolling through the editing pane, the preview pane will attempt to synchronize its position to make it easier to see the preview.</p><p>In addition, the block in the preview matching the position of the cursor in the source view will appear slightly highlighted.</p><p>The sync is currently one-way only, scrolling the preview will not synchronize the position of the editor.</p><p>This feature cannot be disabled as of now; if the scrolling feels distracting, consider temporarily switching to the editor mode and then switching to preview mode when ready.</p><aside class=\"admonition note\"><p>This feature of synchronizing the scroll is based on blocks but it's provided on a best-effort basis since our underlying Markdown library doesn't support this feature natively, so we had to implement our own algorithm. Feel free to <a href=\"#root/_help_wy8So3yZZlH9\">report issues</a>, but always provide a sample Markdown file to be able to reproduce it.</p></aside>",
"_help_jludwdW7N4hg": "<p>A note's type may be converted to another:</p><ul><li><a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> notes to <a class=\"reference-link\" href=\"#root/_help_6RM1Q7ppFVoj\">Markdown</a> notes</li><li>Markdown notes to Text notes</li></ul><p>Before conversion, a revision is saved automatically, so you can restore the original or recover any missing elements from it if the conversion produces undesired results. Read more about <a class=\"reference-link\" href=\"#root/_help_vZWERwf8U3nx\">Note Revisions</a>.</p><h2>Converting individual notes</h2><h3>Markdown to Text Note</h3><p>Markdown notes can be converted to Text Notes with negligible loss of formatting fidelity.</p><p>To do so, go to the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Advanced</em> and select <em>Convert to text note</em>.</p><h3>Text Note to Markdown</h3><aside class=\"admonition warning\"><p>Since Markdown does not support all the capabilities of Text notes, this conversion is lossy in terms of formatting: some formatting may be lost, and some unsupported elements may even be dropped. It's strongly recommended that you inspect the content for any information that might have gone missing after the conversion.</p></aside><p>To convert a text note to Markdown, go to the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Advanced</em> and select <em>Convert to Markdown note</em>.</p><h2>Converting multiple notes</h2><p>A note type conversion can also be performed on an entire subtree or a set of multiple notes using <a class=\"reference-link\" href=\"#root/_help_ivYnonVFBxbQ\">Bulk Actions</a>.</p>",
"_help_GTwFsgaA0lCt": "<p>Collections are a unique type of note that don't have content, but instead display their child notes in various presentation methods.</p><h2>Main collections</h2><div class=\"trilium-tabs\"><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-calendar\"></span> Calendar</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_xWbu3jpNWapp\">Calendar</a> displays a week, month or year calendar with the notes being shown as events. New events can be added easily by dragging across the calendar.</p><figure class=\"image\"><img style=\"aspect-ratio:1651/810;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_calendar.webp\" width=\"1651\" height=\"810\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-table\"></span> Table</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> displays each note as a row in a table, with <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> being shown as well. This makes it easy to visualize attributes of notes, as well as making them easily editable.</p><figure class=\"image\"><img style=\"aspect-ratio:1643/647;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_table.webp\" width=\"1643\" height=\"647\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-columns\"></span> Kanban Board</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> displays notes in columns, grouped by the value of a label. Items and columns can easily be created or dragged around to change their status.</p><figure class=\"image\"><img style=\"aspect-ratio:1174/850;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_board.webp\" width=\"1174\" height=\"850\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-map-alt\"></span> Geo Map</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a> which displays a geographical map in which the notes are represented as pins on the map. New markers can be easily added by pointing on the map. In addition <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a> such as paths, rectangles and circles can be added, as well as GPX tracks.</p><figure class=\"image\"><img style=\"aspect-ratio:844/639;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_geomap.webp\" width=\"844\" height=\"639\"></figure></div></section><section class=\"trilium-tab\"><p class=\"trilium-tab-title\"><span class=\"tn-icon bx bx-slideshow\"></span> Presentation</p><div class=\"trilium-tab-panel\"><p><a class=\"reference-link\" href=\"#root/_help_zP3PMqaG71Ct\">Presentation</a> which shows each note as a slide and can be presented full-screen with smooth transitions or exported to PDF for sharing.</p><figure class=\"image\"><img style=\"aspect-ratio:1120/763;\" src=\"{{helpAssets}}/User%20Guide/Collections_collection_presentation.webp\" width=\"1120\" height=\"763\"></figure></div></section></div><h2>Classic collections</h2><p>Classic collections are read-only mode and compiles the contents of all child notes into one continuous view. This makes it ideal for reading extensive information broken into smaller, manageable segments.</p><ul><li><a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a> which is the default presentation method for child notes (see <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a>), where the notes are displayed as tiles with their title and content being visible.</li><li><a class=\"reference-link\" href=\"#root/_help_mULW0Q3VojwY\">List View</a> is similar to <a class=\"reference-link\" href=\"#root/_help_8QqnMzx393bx\">Grid View</a>, but it displays the notes one under the other with the content being expandable/collapsible, but also works recursively.</li></ul><p>Classic collections make use of pagination to support a large number of notes. The size of a page can be customized via <code>pageSize</code>.</p><h2>Creating a new collection</h2><p>To create a new collection, right-click a note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em> → <em>Collection</em> → the desired type.</p><p>By default, collections come with a default configuration and sometimes even sample notes. To create a collection completely from scratch:</p><ol><li>Create a new note of type <em>Text</em> (or any type).</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> to <em>Collection</em>.</li><li>In <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, select the desired view type.</li><li>Consult the help page of the corresponding view type in order to understand how to configure them.</li></ol><h2>Configuration</h2><p>To change the configuration of a collection or even switch to a different collection (e.g. from Kanban Board to a Calendar), see the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> bar at the top of the note.</p><h2>Archived notes</h2><p>By default, <a href=\"#root/_help_MKmLg5x6xkor\">archived notes</a> will not be shown in collections. This behavior can be changed by going to <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> and checking <em>Show archived notes</em>.</p><p>Archived notes will be generally indicated by being greyed out as opposed to the normal ones.</p><h2>Hiding the child notes from the note tree</h2><p>For collections with a large number of items, it can be helpful to hide the items from the note tree for performance reasons and to reduce clutter. This is especially useful for standalone collections, such as a geomap or a task board.</p><p>To do so, go to <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> and select <em>Hide child notes in tree</em>.</p><h2>Advanced use cases</h2><h3>Adding a description to a collection</h3><p>To add a text before the collection, for example to describe it:</p><ol><li>Create a new collection.</li><li>Change the <a href=\"#root/_help_KSZ04uQ2D1St\">note type</a> from <em>Collection</em> to <em>Text</em>.</li></ol><p>Now the text will be displayed above while still maintaining the collection view.</p><p>The only downside to this method is that <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> will not be shown anymore. In this case, modify the attributes manually or switch back temporarily to the <em>Collection</em> type for configuration purposes.</p><h3>Using saved search</h3><p>Collections, by default, only display the child notes. However, it is possible to use the <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> functionality to display notes all across the tree, with advanced querying functionality.</p><p>To do so, simply start a <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a> and go to the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> and select a desired type of collection. To keep the search-based collection, use a <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a>.</p><aside class=\"admonition important\"><p>While in search, none of the collections will not display the child notes of the search results. The reason is that the search might hit a note multiple times, causing an exponential rise in the number of results.</p></aside><h2>Under the hood</h2><p>Collections by themselves are simply notes with no content that rely on the <a class=\"reference-link\" href=\"#root/_help_0ESUbbAxVnoK\">Note List</a> mechanism (the one that lists the children notes at the bottom of a note) to display information.</p><p>By default, new collections use predefined <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> that are stored safely in the <a class=\"reference-link\" href=\"#root/_help_2mUhVmZK8RF3\">Hidden Notes</a> to define some basic configuration such as the type of view, but also some <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> to make editing easier.</p><p>Collections don't store their configuration (e.g. the position on the map, the hidden columns in a table) in the content of the note itself, but as attachments.</p>",
"_help_xWbu3jpNWapp": "<figure class=\"image\"><img style=\"aspect-ratio:2016/1413;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Calendar_image.png\" width=\"2016\" height=\"1413\"></figure><p>The Calendar view will display each child note in a calendar that has a start date and optionally an end date, as an event.</p><p>The Calendar view has multiple display modes:</p><ul><li>Month view, where the entire month is displayed and all-day events can be inserted. Both time-specific events and all-day events are listed.</li><li>Week view, where all the 7 days of the week (or 5 if the weekends are hidden) are displayed in columns. This mode allows entering and displaying time-specific events, not just all-day events.</li><li>Day view, which views only a single day. Especially useful for heavy agendas or mobile views.</li><li>List view, which displays all the events of a given month in sequence.</li><li>Year view, which displays the entire year for quick reference.</li></ul><p>Unlike other Collection view types, the Calendar view also allows some kind of interaction, such as moving events around as well as creating new ones.</p><h2>Creating a calendar</h2><p>Right click on an existing note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em> → <em>Collection</em> → <em>Calendar</em>.</p><h2>Creating a new event/note</h2><p>To create a new event:</p><ul><li>First, click the desired day (month & year views) or the desired timeslot (day view).</li><li>Alternatively, drag across multiple days (or time slots) to set both the start and end date.</li></ul><p>In either cases, a small popup will show with a prompt for a title and the date & time of the event that will be created. The date and time can be changed there the same way as in the popup view of an existing event (see below).</p><p>At this point, the event hasn't been created yet to protect against accidental clicks. Add a title optionally and press the <em>Create</em> button. If no title is provided, the event will follow the <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a> rules.</p><p>The <span class=\"tn-icon bx bx-detail\"></span> template field below the date and time shows the note type or template the event's note is made from. To make the event from another one, press the field and select it from the list; the calendar remembers the choice for the next event. Select <em>More templates…</em> to change which templates are listed (see <a href=\"#event-templates\">Event templates</a>). The date and time entered for the event replace any dates and times the template carries.</p><p>To give the event a time before creating it (for example, after clicking a day in the month view), press <em>Add time</em> and set the start and end time; the duration is shown to the right of them. To make the event all-day again, press the <span class=\"tn-icon bx bx-x\"></span> button at the end of the row. Adding or removing a time keeps the dates, so an event can start at a time on one day and end at a time on another (for example, a night shift). Changing the start date or time moves the end by the same amount, keeping the duration. An empty end date means the event ends on the day it starts; setting the end time before the start time moves the end date to the next day.</p><p>After creating the event, it will show up on the calendar. To edit the content of the event (including recurrence), click on it to bring it into the popup view.</p><aside class=\"admonition note\"><p>Creating new notes from the calendar will respect the <code>~child:template</code> relation if set on the Collection note.</p></aside><h2>Interacting with events</h2><ul><li>Hovering the mouse over an event will display information about the note.<br><img src=\"{{helpAssets}}/User%20Guide/Collections/4_Calendar_image.png\"></li><li>Left clicking the event will open a dedicated popup to quickly configure the event or edit its note content.</li><li>Right click will offer more options including opening the note in a new split or window.</li><li>Drag and drop an event on the calendar to move it to another day.</li><li>The length of an event can be changed by placing the mouse to the right edge of the event and dragging the mouse around.</li></ul><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> calendar, events can't be dragged, resized or created, their context menu only offers the places to open them in, and the button to pin the current date is hidden. Switching between the month, week and day views still works, but the choice isn't saved.</p><h3>Popup view</h3><p>When an event is clicked, a popup will show near the event which contains the following inforamtion:</p><ul><li>The title and icon of the event, both editable.</li><li>Buttons to interact with the event:<ul><li>Open the event in the same pane, new tab, etc.</li><li>Color picker to change the color of the event.</li><li>Button to remove the event from the calendar, which can optionally delete its corresponding note.</li></ul></li><li>Calendar-specific features:<ul><li>The start date and, for an event spanning several days, the end date.</li><li>The start and end time with the duration to the right of them, and a <span class=\"tn-icon bx bx-x\"></span> button that removes the time, making the event all-day. An all-day event shows an <em>Add time</em> button instead.</li><li>A full recurrence editor, opened from the dropdown below the time, to have the same event show up weekly, monthly, etc.</li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the calendar, press anywhere outside the popup.</li><li>Or simply press the <kbd>Escape</kbd> key.</li></ul><p>It is possible to switch between events by clicking on them even when the popup view is already open.</p><p>Events can have <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> between them and clicking on such a link will automatically navigate the calendar to the right date and the popup view to the new note.</p><h2>Interaction on mobile</h2><p>When Trilium is on mobile, the interaction with the calendar is slightly different:</p><ul><li>Clicking on an event displays the popup view, which allows editing the event.</li><li>Long-presing an event triggers the contextual menu, including the option to open in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>.</li><li>To insert a new event, touch and hold the empty space. When successful, the empty space will become colored to indicate the selection.<ul><li>Before releasing, drag across multiple spaces to create multi-day events.</li><li>When released, a prompt will appear to enter the note title.</li></ul></li><li>To move an existing event, touch and hold the event until the empty space near it will become colored.<ul><li>At this point the event can be dragged across other days on the calendar.</li><li>Or the event can be resized by tapping on the small circle to the right end of the event.</li><li>To exit out of editing mode, simply tap the empty space anywhere on the calendar.</li></ul></li></ul><h2>Configuring the calendar view</h2><p>In the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, it's possible to:</p><ul><li>Hide weekends from the week view.</li><li>Display week numbers on the calendar.</li><li>Hide routine events from the month, year and list views (see <a href=\"#hiding-routine-events\">Hiding routine events</a>).</li><li>Set the slot duration (the length of each time row in day/week view).</li><li>Set the slot label interval (how often time labels appear on the axis in day/week view).</li></ul><p>The same settings are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it). The time slots are listed there whichever view the calendar is in. Its <em>Included notes</em> section sets whether archived notes are shown and how deep the calendar looks for events (see <a href=\"#limiting-the-depth\">Limiting the depth</a>).</p><h3>Event templates</h3><p>By default, a new event is a <a class=\"reference-link\" href=\"#root/_help_iPIMuisry3hd\">Text</a> note. To make events from other note types, or from <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> with predefined content and attributes (such as a color), open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, and find <em>Event templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the <span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template is created as a child of the calendar, and is not shown as an event.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted.</li><li>Press the <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button of a custom template to edit, open in a new window, duplicate, or delete it.</li><li>Drag a template by its handle to reorder the list shown when creating an event.</li></ul><p>The dialog is not available on a read-only calendar, or on a calendar marked with <code>#calendarRoot</code> or <code>#workspaceCalendarRoot</code> (see <a href=\"#using-with-the-journal--calendar\">Using with the Journal / calendar</a>).</p><h3>Event attributes</h3><p>Events can show the values of their attributes below their title, in the month view, and in the week and day views for all-day events and for timed ones tall enough to hold them. To choose which attributes are shown, open the <span class=\"tn-icon bx bx-cog\"></span> <em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it) and find <em>Event attributes</em>. It lists the <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> the calendar defines, and those its events define themselves. Here you can:</p><ul><li>Turn an attribute on to show it on the events. New attributes are hidden until you turn them on, which keeps the calendar from getting cluttered.</li><li>Drag an attribute by its handle to change the order in which the events show them.</li><li>Create a new attribute, which is shown on the events right away, or edit or delete one the calendar defines.</li></ul><p>The dates, times and recurrence of the events are not listed, as the calendar always shows them itself.</p><p>To change an attribute's value without opening the event, right-click the event (or long-press it on a phone) and use the <em>Attributes</em> section of its context menu. It lists the shown attributes of the “checkbox”, “select” and “date” types, and works as on a <a href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a>.</p><p>If an event has a <code>#calendar:displayedAttributes</code> label, including one inherited from the calendar, the attributes listed in that label are shown instead.</p><h2>Configuring the calendar using attributes</h2><p>The following attributes can be added to the Collection type:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#calendar:hideWeekends</code></td><td>When present (regardless of value), it will hide Saturday and Sundays from the calendar.</td></tr><tr><td><code>#calendar:weekNumbers</code></td><td>When present (regardless of value), it will show the number of the week on the calendar.</td></tr><tr><td><code>#calendar:hideRoutineEvents</code></td><td>When present (regardless of value), it will hide routine events from the month, year and list views. See <a href=\"#hiding-routine-events\">Hiding routine events</a>.</td></tr><tr><td><code>#calendar:initialDate</code></td><td>Change the date the calendar opens on. When not present, the calendar opens on the current date.</td></tr><tr><td><code>#calendar:view</code></td><td><p>Which view to display in the calendar:</p><ul><li><code>timeGridDay</code> for the <em>day</em> view;</li><li><code>timeGridWeek</code> for the <em>week</em> view;</li><li><code>dayGridMonth</code> for the <em>month</em> view;</li><li><code>multiMonthYear</code> for the <em>year</em> view;</li><li><code>listMonth</code> for the <em>list</em> view.</li></ul><p>Any other value will be dismissed and the default view (month) will be used instead.</p><p>The value of this label is automatically updated when changing the view using the UI buttons.</p></td></tr><tr><td><code>#calendar:slotDuration</code></td><td>Sets how long each timeslot is on the calendar. Defaults to <code>00:15:00</code> (15 minutes). Must have the format \"HH:MM:SS\". For example, to create timeslots for every 10 minutes, you would set <code>#calendar:slotDuration=\"00:10:00\"</code>.</td></tr><tr><td><code>#calendar:slotLabelInterval</code></td><td>Sets how often the timeslots on the calendar should be labeled. Defaults to <code>01:00:00</code> (1 hour). Must have the format \"HH:MM:SS\". For example, to label timeslots every 30 minutes, you would set <code>#calendar:slotLabelInterval=\"00:30:00\"</code>.</td></tr><tr><td><code>~child:template</code></td><td>Defines the template for newly created notes in the calendar (via dragging or clicking).</td></tr></tbody></table></figure><p>In addition, the first day of the week can be either Sunday or Monday and can be adjusted from the application settings.</p><h2>Configuring the calendar events using attributes</h2><p>For each note of the calendar, the following attributes can be used:</p><figure class=\"table\"><table><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><code>#startDate</code></td><td>The date the event starts, which will display it in the calendar. The format is <code>YYYY-MM-DD</code> (year, month and day separated by a minus sign).</td></tr><tr><td><code>#endDate</code></td><td>Similar to <code>startDate</code>, mentions the end date if the event spans across multiple days. The date is inclusive, so the end day is also considered. The attribute can be missing for single-day events.</td></tr><tr><td><code>#startTime</code></td><td>The time the event starts at. If this value is missing, then the event is considered a full-day event. The format is <code>HH:MM</code> (hours in 24-hour format and minutes).</td></tr><tr><td><code>#endTime</code></td><td>Similar to <code>startTime</code>, it mentions the time at which the event ends (in relation with <code>endDate</code> if present, or <code>startDate</code>).</td></tr><tr><td><code>#recurrence</code></td><td>This is an optional CalDAV <code>RRULE</code> string that if present, determines whether a task should repeat or not. Note that it does not include the <code>DTSTART</code> attribute, which is derived from the <code>#startDate</code> and <code>#startTime</code> directly. For examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></td></tr><tr><td><code>#color</code></td><td>Displays the event with a specified color (named such as <code>red</code>, <code>gray</code> or hex such as <code>#FF0000</code>). This will also change the color of the note in other places such as the note tree.</td></tr><tr><td><code>#calendar:color</code></td><td><strong>❌️ Removed since v0.100.0. Use</strong> <code>#color</code> <strong>instead.</strong> <br> <br>Similar to <code>#color</code>, but applies the color only for the event in the calendar and not for other places such as the note tree.</td></tr><tr><td><code>#iconClass</code></td><td>If present, the icon of the note will be displayed to the left of the event title.</td></tr><tr><td><code>#calendar:title</code></td><td>Changes the title of an event to point to an attribute of the note other than the title, can either a label or a relation (without the <code>#</code> or <code>~</code> symbol). See <em>Use-cases</em> for more information.</td></tr><tr><td><code>#calendar:titleTemplate</code></td><td>Changes the title an event is displayed with on the calendar, filled in again for every occurrence of a repeating event. See <em>Use-cases</em> for displaying an age on a birthday.</td></tr><tr><td><code>#calendar:displayedAttributes</code></td><td>Takes precedence over the <a href=\"#event-attributes\">Event attributes</a> chosen in the calendar's properties. Allows displaying the value of one or more attributes in the calendar, in the order given, like this: <br> <br><img src=\"{{helpAssets}}/User%20Guide/Collections/6_Calendar_image.png\"> <br> <br><code>#weight=\"70\" #Mood=\"Good\" #calendar:displayedAttributes=\"weight,Mood\"</code> <br> <br>It can also be used with relations, case in which it will display the title of the target note: <br> <br><code>~assignee=@My assignee #calendar:displayedAttributes=\"assignee\"</code></td></tr><tr><td><code>#calendar:startDate</code></td><td>Allows using a different label to represent the start date, other than <code>startDate</code> (e.g. <code>expiryDate</code>). The label name <strong>must not be</strong> prefixed with <code>#</code>. If the label is not defined for a note, the default will be used instead.</td></tr><tr><td><code>#calendar:endDate</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end date.</td></tr><tr><td><code>#calendar:startTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the start time.</td></tr><tr><td><code>#calendar:endTime</code></td><td>Similar to <code>#calendar:startDate</code>, allows changing the attribute which is being used to read the end time.</td></tr></tbody></table></figure><h2>How the calendar works</h2><p><img src=\"{{helpAssets}}/User%20Guide/Collections/8_Calendar_image.png\"></p><p>The calendar displays all the child notes of the Collection that have a <code>#startDate</code>. An <code>#endDate</code> can optionally be added.</p><p>A text note with a start date is shown with the <span class=\"tn-icon bx bx-calendar-event\"></span> icon in the note tree and elsewhere, unless it has an icon of its own (set with <code>#iconClass</code>). The start date is read from the label <code>#calendar:startDate</code> names, if any.</p><p>The start date & end date can easily be edited from the calendar collection itself by clicking on the event. To edit the date while in the event note itself, the following attributes can be added to the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#viewType=calendar #label:startDate(inheritable)=\"promoted,alias=Start Date,single,date\"\n#label:endDate(inheritable)=\"promoted,alias=End Date,single,date\"\n#hidePromotedAttributes </code></pre><p>This will result in:</p><p><img src=\"{{helpAssets}}/User%20Guide/Collections/7_Calendar_image.png\"></p><p>When not used in a Journal, the calendar is recursive. That is, it will look for events not just in its child notes but also in the children of these child notes.</p><h3>Limiting the depth</h3><p>To limit how deep the calendar looks for events, set <em>Maximum nesting depth</em> under <em>Included notes</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Calendar properties</em> dialog (see <a href=\"#event-templates\">Event templates</a> for how to open it), or the <code>#maxNestingDepth</code> label: <code>0</code> shows only the child notes, <code>1</code> adds their children, and so on. Without a value, events are looked for at every level. The setting doesn't apply in a Journal.</p><h2>Recurrence</h2><p>The built in calendar view also supports repeating tasks (e.g. every week, every month as well as more complex recurrency rules).</p><p>Starting with v0.105.0, recurrence can be directly edited from the calendar by clicking on an event and then selecting the <em>Repeats</em> option.</p><h3>Custom recurrence using a subset of RRULE</h3><p>If the existing recurrence editor from the event popup is not sufficient, more complex rules can be manually set via the <code>#recurrence</code> label.</p><p>For example, to make a note repeat on the calendar:</p><ul><li>Every Day - <code>#recurrence=\"FREQ=DAILY;INTERVAL=1\"</code></li><li>Every 3 days - <code>#recurrence=\"FREQ=DAILY;INTERVAL=3\"</code></li><li>Every week - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=1\"</code></li><li>Every 2 weeks on Monday, Wednesday and Friday - <code>#recurrence=\"FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE,FR\"</code></li><li>Every 3 months - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=3\"</code></li><li>Every 2 months on the First Sunday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=2;BYDAY=1SU\"</code></li><li>Every month on the Last Friday - <code>#recurrence=\"FREQ=MONTHLY;INTERVAL=1;BYDAY=-1FR\"</code></li></ul><p>For other examples of valid <code>RRULE</code> strings see <a href=\"https://icalendar.org/rrule-tool.html\">https://icalendar.org/rrule-tool.html</a></p><p>Note that the recurrence string does not include the <code>DTSTART</code> attribute as defined in the iCAL specifications. This is derived directly from the <code>startDate</code> and <code>startTime</code> attributes</p><p>If you want to override the label the calendar uses to fetch the recurrence string, you can use the <code>#calendar:recurrence</code> attribute. For example, you can set <code>#calendar:recurrence=taskRepeats</code>. Then you can set your recurrence string like <code>#taskRepeats=\"FREQ=DAILY;INTERVAL=1\"</code></p><p>Also note that the recurrence label can be made promoted as with the start and end dates. </p><aside class=\"admonition warning\"><p>If the recurrence string is not valid, a toast will be shown with the note ID and title of the note with the erroneous recurrence message. This note will not be added to the calendar</p></aside><h3>Hiding routine events</h3><p>Events that repeat on most days of the week, such as sleep or working hours, fill every cell of the month view. To hide them from the views that show many days at once, check <em>Hide routine events</em> in the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> (or set <code>#calendar:hideRoutineEvents</code>).</p><p>An event counts as routine when it has a start time and repeats on 4 or more days a week on average, for example:</p><figure class=\"table\"><table><thead><tr><th>Event</th><th>Days a week</th><th>Hidden from the month, year and list views</th></tr></thead><tbody><tr><td>Every day from 23:00 to 07:00</td><td>7</td><td>Yes</td></tr><tr><td>Monday to Friday from 09:00 to 17:00</td><td>5</td><td>Yes</td></tr><tr><td>Every other day at 07:00</td><td>3.5</td><td>No</td></tr><tr><td>Monday, Wednesday and Friday at 18:00</td><td>3</td><td>No</td></tr><tr><td>Every day, without a start time</td><td>7</td><td>No, as it lasts the whole day</td></tr><tr><td>Every month or every year</td><td>—</td><td>No</td></tr></tbody></table></figure><p>The day and week views always show routine events. To show them everywhere again, uncheck the option.</p><h2>Customizing the slot duration and label interval</h2><p>Time slots in day and week views can be customized from <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a></p><ul><li><em>Slot duration</em> controls how tall each time slot is on the calendar (essentially the smallest unit of time the grid is divided into).<ul><li>A shorter duration means more rows and finer granularity; a longer one means fewer, chunkier rows.</li><li>The default is one row every 15 minutes.</li></ul></li><li><em>Label interval</em> controls how often a time label appears on the left-hand axis.<ul><li>This is independent of the slot size: you can have very small slots but only label every hour to keep the axis readable.</li><li>The default is a time label shown every hour.</li></ul></li></ul><aside class=\"admonition note\"><p>These values can also be customized directly via the <code>#calendar:slotDuration</code> and <code>#calendar:slotLabelInterval</code> <a href=\"#root/_help_HI6GBBIduIgv\">labels</a>. Both values use <code>HH:mm:ss</code> format. Hours can go up to <code>24</code> (<code>24:00:00</code>), while minutes and seconds must be between <code>00</code> and <code>59</code>. The minimum meaningful duration is 1 minute (<code>00:01:00</code>).</p></aside><h2>Use-cases</h2><h3>Using with the Journal / calendar</h3><p>It is possible to integrate the calendar view into the Journal with day notes. In order to do so change the note type of the Journal note (calendar root) to Collection and then select the Calendar View.</p><p>While in journal mode, the popup editor will not show dates, recurrence, colors or removal, since day notes aren't editable events.</p><p>Based on the <code>#calendarRoot</code> (or <code>#workspaceCalendarRoot</code>) attribute, the calendar will know that it's in a calendar and apply the following:</p><ul><li>The calendar events are now rendered based on their <code>dateNote</code> attribute rather than <code>startDate</code>.</li><li>Interactive editing such as dragging over an empty era or resizing an event is no longer possible.</li><li>Clicking on the empty space on a date will automatically open that day's note or create it if it does not exist.</li><li>Direct children of a day note will be displayed on the calendar despite not having a <code>dateNote</code> attribute. Children of the child notes will not be displayed.</li></ul><img src=\"{{helpAssets}}/User%20Guide/Collections/5_Calendar_image.png\" width=\"1217\" height=\"724\"><h3>Using a different attribute as event title</h3><p><img class=\"image-style-align-right\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Calendar_image.png\" width=\"445\" height=\"124\">By default, events are displayed on the calendar by their note title. However, it is possible to configure a different attribute to be displayed instead.</p><p>To do so, assign <code>#calendar:title</code> to the child note (not the calendar/Collection note), with the value being <code>name</code> where <code>name</code> can be any label (make not to add the <code>#</code> prefix). The attribute can also come through inheritance such as a template attribute. If the note does not have the requested label, the title of the note will be used instead.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-11 #endDate=2025-02-13 #name=\"My vacation\" #calendar:title=\"name\"</code></pre><h3>Using a relation attribute as event title</h3><p><img class=\"image-style-align-right image_resized\" style=\"aspect-ratio:294/151;width:21.22%;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Calendar_image.png\" width=\"294\" height=\"151\">Similarly to using an attribute, use <code>#calendar:title</code> and set it to <code>name</code> where <code>name</code> is the name of the relation to use.</p><p>Moreover, if there are more relations of the same name, they will be displayed as multiple events coming from the same note.</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=2025-02-14 #endDate=2025-02-15 ~for=@John Smith ~for=@Jane Doe #calendar:title=\"for\"</code></pre><p><img class=\"image-style-align-left\" src=\"{{helpAssets}}/User%20Guide/Collections/Calendar_image.png\" width=\"296\" height=\"150\">Note that it's even possible to have a <code>#calendar:title</code> on the target note (e.g. “John Smith”) which will try to render an attribute of it. Note that it's not possible to use a relation here as well for safety reasons (an accidental recursion of attributes could cause the application to loop infinitely).</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:title=\"shortName\" #shortName=\"John S.\"</code></pre><h3>Displaying an age on a recurring event</h3><p>A birthday or an anniversary repeats every year, and what is interesting about each occurrence is the number of years it marks. To display it:</p><ol><li>Set the event's start date to the original date (for example, the date of birth).</li><li>Click the event, then select the <em>Repeats</em> dropdown.</li><li>Select <em>Yearly</em> and check <em>Show the number of years in the title</em>.</li></ol><p>The event is then displayed as “John Smith (35)” in 2025, “John Smith (36)” in 2026, and so on. Only the calendar is affected; the note keeps its own title.</p><p>The checkbox sets the <code>#calendar:titleTemplate</code> label, which sets the title an event is displayed with and is filled in again for every occurrence the recurrence rule produces:</p><pre><code class=\"language-text-x-trilium-auto\">#startDate=1990-05-12 #recurrence=\"FREQ=YEARLY\" #calendar:titleTemplate=\"${title} (${years})\"</code></pre><p>To word the title differently, edit the label directly. The checkbox is then disabled, as it is when the template is inherited, so that it never overwrites a template of your own.</p><p>The following values can be used in the template:</p><figure class=\"table\"><table><thead><tr><th>Value</th><th>Description</th></tr></thead><tbody><tr><td><code>${title}</code></td><td>The title the event would otherwise be displayed with: the note title, or the attribute <code>#calendar:title</code> points to.</td></tr><tr><td><code>${years}</code></td><td>The whole years between <code>#startDate</code> and the occurrence being displayed. It is <code>0</code> on the first occurrence.</td></tr><tr><td><code>${date}</code></td><td>The date of the occurrence being displayed, as a <a href=\"https://day.js.org/docs/en/display/format\">day.js</a> object. For example, <code>${date.format('YYYY')}</code>.</td></tr><tr><td><code>${startDate}</code></td><td>The date the event starts on, in the same form. For example, <code>${startDate.format('YYYY')}</code>.</td></tr></tbody></table></figure><p>To use the same template for every event of a calendar, make the label inheritable on the Collection note:</p><pre><code class=\"language-text-x-trilium-auto\">#calendar:titleTemplate(inheritable)=\"${title} (${years})\"</code></pre><aside class=\"admonition note\"><p>A template that cannot be read — an unknown value, or an expression other than a value and the <code>format</code> call shown above — leaves the event with its plain title and reports the reason in the browser console.</p></aside>",
"_help_2FvYrpmOXm29": "<figure class=\"image\"><img style=\"aspect-ratio:1050/259;\" src=\"{{helpAssets}}/User%20Guide/Collections/Table_image.png\" width=\"1050\" height=\"259\"></figure><p>The table view displays information in a grid, where the rows are individual notes and the columns are <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>. In addition, values are editable.</p><h2>How it works</h2><p>The tabular structure is represented as such:</p><ul><li>Each child note is a row in the table.</li><li>If child rows also have children, they will be displayed under an expander (nested notes).</li><li>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted attribute</a> that is defined on the Collection note.<ul><li>Actually, both promoted and unpromoted attributes are supported, but it's a requirement to use a label/relation definition.</li><li>The promoted attributes are usually defined as inheritable in order to show up in the child notes, but it's not a requirement.</li></ul></li><li>If there are multiple attribute definitions with the same <code>name</code>, only one will be displayed.</li><li>If an attribute definition has multiple values, they will all be grouped under a single column, with chips indicating individual values.</li></ul><p>There are also a few predefined columns:</p><ul><li>The current item number, identified by the <code>#</code> symbol.<ul><li>This simply counts the note and is affected by sorting.</li></ul></li><li><a class=\"reference-link\" href=\"#root/_help_m1lbrzyKDaRB\">Note ID</a>, representing the unique ID used internally by Trilium</li><li>The title of the note.</li><li><em>Created</em> and <em>Modified</em>, the date and time the note was created and last modified. These columns are hidden by default and can't be edited; show them from the column context menu and click their header to sort by them.</li></ul><h2>Interaction</h2><h3>Creating a new table</h3><p>Right click on an existing note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em> → <em>Collection</em> → <em>Table</em>.</p><h3>Adding columns</h3><p>Each column is a <a href=\"#root/_help_OFXdgB2nNk1F\">promoted or unpromoted attribute</a> that is defined on the Collection note.</p><p>To create a new column, either:</p><ul><li>Press <em>Add new column</em> at the bottom of the table.</li><li>Right click on an existing column and select Add column to the left/right.</li><li>Right click on the empty space of the column header and select <em>Label</em> or <em>Relation</em> in the <em>New column</em> section.</li></ul><h3>Adding new rows</h3><p>Each row is actually a note that is a child of the Collection note.</p><p>To create a new note, either:</p><ul><li>Press <em>Add new row</em> at the bottom of the table.</li><li>Right click on an existing row and select <em>Insert row above, Insert child note</em> or <em>Insert row below</em>.</li></ul><p>By default it will try to edit the title of the newly created note.</p><p>Alternatively, the note can be created from the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> or <a href=\"#root/_help_CdNpE2pqjmI6\">scripting</a>.</p><h3>Context menu</h3><p>There are multiple menus:</p><ul><li>Right clicking on a column, allows:<ul><li>Sorting by the selected column and resetting the sort.</li><li>Hiding the selected column or adjusting the visibility of every column.</li><li>Adding new columns to the left or the right of the column.</li><li>Editing the current column.</li><li>Deleting the current column.</li></ul></li><li>Right clicking on the space to the right of the columns, allows:<ul><li>Adjusting the visibility of every column.</li><li>Adding new columns.</li></ul></li><li>Right clicking on a row, allows:<ul><li>Opening the corresponding note of the row in a new tab, split, window or quick editing it.</li><li>Inserting a new note above or below the selected row. These options are only enabled if the table is not sorted.</li><li>Inserting a new child note for the selected row.</li><li>Deleting the row.</li></ul></li></ul><h3>Opening notes</h3><p>Hovering over a row shows an <em>Open</em> button at the end of its title, which opens the note in quick edit. On a touch screen, the button is always visible.</p><p>Clicking the title itself renames the note instead (see below). To open the note elsewhere:</p><ul><li><kbd>Ctrl</kbd>+click or middle click the title to open the note in a new tab.</li><li><kbd>Shift</kbd>+click the title to open it in a new window.</li><li>Right click the row to open the note in a new tab, split or window, or in quick edit.</li></ul><h3>Editing data</h3><p>Simply click on a cell within a row to change its value. The change will not only reflect in the table, but also as an attribute of the corresponding note.</p><ul><li>The editing will respect the type of the promoted attribute, by presenting a normal text box, a number selector or a date selector for example.</li><li>A boolean column shows a checkbox, which is checked or unchecked with a single click. A note without the label shows an unchecked box.</li><li>It also possible to change the title of a note by clicking it.</li><li>Editing relations is also possible<ul><li>Simply click on a relation and it will become editable. Enter the text to look for a note and click on it.</li><li>To remove a relation, remove the title of the note from the text box and click outside the cell.</li></ul></li></ul><h3>Editing columns</h3><p>It is possible to edit a column by right clicking it and selecting <em>Edit column…</em> This will basically change the label/relation definition at the collection level.</p><p>Turn on <em>Multiple values</em> to let each note hold several values in that column. The cell then shows them as chips (see <a href=\"#root/_help_OFXdgB2nNk1F\">Multiple values</a> in Promoted Attributes). The same toggle is available when adding a column.</p><p>If the <em>Name</em> field of a column is changed, this will trigger a batch operation in which the corresponding label/relation will be renamed in all the children.</p><h3>Read-only tables</h3><p>On a <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> table, the cells can't be edited and the rows can't be dragged. Clicking a note's title opens it in quick edit, so there's no <em>Open</em> button. The <em>New row</em> and <em>New column</em> buttons are hidden, and the context menus offer only what leaves the notes as they are: sorting and hiding columns, and opening the notes. Columns can still be resized and reordered, but the layout isn't saved. The <em>Table properties</em> dialog isn't available.</p><h2>Working with the data</h2><h3>Sorting by column</h3><p>By default, the order of the notes matches the order in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>. However, it is possible to sort the data by the values of a column:</p><ul><li>To do so, simply click on a column.</li><li>To switch between ascending or descending sort, simply click again on the same column. The arrow next to the column will indicate the direction of the sort. On a column that isn't sorted, the arrow appears only while hovering over its header.</li><li>To disable sorting and fall back to the original order, right click any column on the header and select <em>Clear sorting.</em></li></ul><h3>Reordering and hiding columns</h3><ul><li>Columns can be reordered by dragging the header of the columns.</li><li>Columns can be hidden or shown by right clicking on a column and clicking the item corresponding to the column.</li></ul><h3>Reordering rows</h3><p>Notes can be dragged around to change their order. To do so, move the mouse over the three vertical dots near the number row and drag the mouse to the desired position.</p><p>This will also change the order of the note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</p><p>Reordering does have some limitations:</p><ul><li>If the parent note has <code>#sorted</code>, reordering will be disabled.</li><li>If using nested tables, then reordering will also be disabled.</li><li>Currently, it's possible to reorder notes even if column sorting is used, but the result might be inconsistent.</li></ul><h3>Nested trees</h3><p>If the child notes of the collection also have their own child notes, then they will be displayed in a hierarchy.</p><p>Next to the title of each element there will be a button to expand or collapse. By default, all items are expanded.</p><p>Since nesting is not always desirable, it is possible to limit the nesting to a certain number of levels or even disable it completely. To do so, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Table properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or set the <code>#maxNestingDepth</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a> of the collection:</p><ul><li><code>0</code> disables nesting, showing only the children of the collection.</li><li><code>1</code> also shows their children, <code>2</code> the level below that, and so on.</li><li>Removing the label shows every level again.</li></ul><p>Limitations:</p><ul><li>While in this mode, it's not possible to reorder notes.</li></ul><h2>Limitations</h2><ul><li>There is no support to filter the rows by a certain criteria. Consider using the table view in search for that use case; for example, <code>note.dateCreated >= TODAY-7</code> lists the notes created in the last week.</li></ul><h2>Use in search</h2><p>The table view can be used in a <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> by adding the <code>#viewType=table</code> attribute.</p><p>Unlike when used in a Collection, saved searches are not limited to the sub-hierarchy of a note and allows for advanced queries thanks to the power of the <a class=\"reference-link\" href=\"#root/_help_eIg8jdvaoNNd\">Search</a>.</p><p>However, there are also some limitations:</p><ul><li>It's not possible to reorder notes.</li><li>It's not possible to add a new row.</li></ul><p>Columns are supported, by being defined as <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> to the <a class=\"reference-link\" href=\"#root/_help_m523cpzocqaD\">Saved Search</a> note.</p><p>Editing is also supported.</p>",
"_help_CtBQqbwXDx1w": "<p>The Board view lets you arrange subnotes as cards on a <a href=\"https://en.wikipedia.org/wiki/Kanban_board\">Kanban board</a>.</p><h2>Creating a Kanban board</h2><p>Right-click an existing note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>, select <em>Insert child note</em> → <em>Collection</em> → <em>Kanban Board</em>.</p><h2>How it works</h2><p>When you first create a collection of the <em>Board</em> type, a few subnotes are created, each with a <code>#status</code> label set. The board then groups each note by the value of its status attribute.</p><p>Notes are displayed recursively, so even grandchildren and more deeply nested notes will be displayed. However, unlike the <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a>, the notes are not displayed hierarchically.</p><p>To limit how deep the board looks, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and set <em>Maximum nesting depth</em> (under the <em>Included notes</em> section), or apply the <code>#maxNestingDepth</code> label to the board note: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p><h2>Working with columns</h2><h3>Creating columns</h3><p>You can create a new column by pressing the <span class=\"tn-icon bx bx-plus\"></span><em>Add column</em> button located after the last column.</p><p>Enter the new name (which must not match another column), optionally select an icon by pressing the circle at the start of the text box, and then press the (+) button or <kbd>Enter</kbd>. Click or tap outside the text box, or press <kbd>Esc</kbd>, to dismiss it.</p><p>Columns can also be added from a context menu:</p><ul><li>To add a column at the end of the board, right-click an empty area of the board and select <span class=\"tn-icon bx bx-columns\"></span><em>Add new column</em>.</li><li>To add a column next to an existing one, open its column menu and select <span class=\"tn-icon bx bx-columns\"></span><em>Add new column</em> → <em>Before</em> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd>) or <em>After</em> (<kbd>Ctrl</kbd>+<kbd>Enter</kbd>).</li></ul><p>Once a board is set up, the <em>Add column</em> button can be hidden. To do so, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and turn off <em>Show the \"Add column\" button</em> (under the <em>General</em> section), or apply the <code>#board:hideAddColumn</code> label to the board note. Columns can still be added from the context menus above.</p><h3>Reordering columns</h3><p>The order of the columns can be changed at any time. There are several ways to do this:</p><ul><li><strong>Using touch or a mouse:</strong> Touch and hold the column header, or click and hold it with the mouse. Drag the column left or right until it reaches the desired location, and then release it.</li><li><strong>Using the keyboard:</strong> While the keyboard focus is anywhere inside the column, you can use these key combinations. If the column header itself is focused, you can omit <kbd>Alt</kbd>:<ul><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Right</kbd>: Move the column to the right.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Left</kbd>: Move the column to the left.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Home</kbd>: Make it the first column.</li><li><kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>End</kbd>: Make it the last column.</li></ul></li><li><em>Using the column menu:</em> Open the column menu and use the <span class=\"tn-icon bx bx-horizontal-left\"></span> <em>Move column</em> submenu.</li></ul><h3>Renaming and recoloring columns</h3><p>To change the name of a column, open the column menu and select <span class=\"tn-icon bx bx-edit-alt\"></span> <em>Rename column</em>, or press <kbd>F2</kbd> while the column header is selected.</p><p>From the same menu, you can tint the column with a different color by using the color palette at the bottom of the menu.</p><h3>Collapsing and expanding columns</h3><h4>Collapsing</h4><p>A column can be collapsed (minimized) to occupy less space on the screen and make the board look less cluttered. This is particularly useful for columns that are not frequently used, or when you want to focus on only a few columns and keep the rest out of sight.</p><p>To collapse a column:</p><ul><li><strong>Using a mouse:</strong> Double-click the column header.</li><li><strong>Using touch:</strong> Tap the column header, and then press the <span class=\"tn-icon bx bx-collapse-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Focus the column header, and then press <kbd>Space</kbd>.</li></ul><p>Alternatively, you can use the <span class=\"tn-icon bx bx-collapse-horizontal\"></span> <em>Collapse column</em> command from the column menu.</p><p>Once a column is collapsed, its cards are no longer visible, but the column can still receive cards from other columns:</p><ul><li><strong>Drop cards onto a collapsed column:</strong> The cards will be moved to the column (at the bottom if manual sorting is enabled).</li><li><strong>Hold cards over a collapsed column for a few seconds:</strong> The column will expand, allowing you to drop the cards at the desired position (if manual sorting is enabled) or peek at the other cards before deciding whether to drop them.</li><li><strong>Move a card to a collapsed column using the keyboard:</strong> The column will temporarily expand to reveal the moved card. You can then continue moving the selected cards up or down, or to another column.</li></ul><p>Collapsed columns can still be reordered, and their menus remain available.</p><p>A collapsed column shows its title vertically, read from the bottom up. If any column title on the board contains Chinese, Japanese or Korean characters, the titles of all collapsed columns read from the top down instead, so that those characters stay upright.</p><h4>Expanding</h4><p>You can restore a collapsed column so that its content is visible again in the following ways:</p><ul><li><strong>Using a mouse:</strong> Click the collapsed column.</li><li><strong>Using touch:</strong> Tap the collapsed column, and then press the <span class=\"tn-icon bx bx-expand-horizontal\"></span> button on the side toolbar.</li><li><strong>Using the keyboard:</strong> Move the focus to the collapsed column, and then press <kbd>Space</kbd>.</li></ul><h4>Keeping a column collapsed</h4><p>By default, once a column is expanded, it remains expanded. However, you can configure a column to collapse again after you finish working with it. To activate this behavior, open the column menu and check <span class=\"tn-icon bx bx-lock-alt\"></span> <em>Keep the column collapsed</em>.</p><p>A column configured to remain collapsed will expand like any other collapsed column, but only temporarily, until another column is focused.</p><h4>Collapsing and expanding all columns</h4><p>You can expand or collapse all columns at once by using the <span class=\"tn-icon bx bx-collapse-alt\"></span> (collapse) and <span class=\"tn-icon bx bx-expand-alt\"></span> (expand) buttons. On the desktop, these buttons are located at the bottom of the screen; on the mobile interface, they are in the header.</p><h3>Sorting cards within a column</h3><p>By default, the cards in a column are sorted manually by moving them up and down. You can also keep them sorted automatically, using customizable criteria for each column. To customize the sorting options, open the column menu → <em>Sort</em>. The following options are available:</p><ul><li><span class=\"tn-icon bx bx-collection\"></span> <em>Board's default</em>: Use the default sorting order (initially manual for new boards).</li><li><span class=\"tn-icon bx bx-move-vertical\"></span> <em>Manually</em>: Sort cards by manually moving them up and down.</li><li><span class=\"tn-icon bx bx-text\"></span> <em>Title</em>: Sort cards by title.</li><li><span class=\"tn-icon bx bx-calendar-plus\"></span> <em>Creation date & time</em>: Sort cards by the creation date and time of the note represented by each card. If a card was created from an existing note, the date and time will match the original creation date and time of that note, not when the card was added to the board.</li><li>Any custom attribute: Any card attribute (see <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) can be used as a sorting criterion.</li><li><span class=\"tn-icon bx bx-sort-up\"></span> <em>Ascending</em>: Sort from smallest to largest (A to Z, 0 to 9, or oldest to newest).</li><li><span class=\"tn-icon bx bx-sort-down\"></span> <em>Descending</em>: Sort in reverse order, from largest to smallest.</li></ul><aside class=\"admonition important\"><p>The card order you set is preserved after you switch away from manual sorting. When you switch back to manual sorting, the cards will be in the same order in which you arranged them.</p></aside><h4>How card attributes are sorted</h4><p>When cards are sorted by an attribute, they are ordered according to the following rules:</p><figure class=\"table\"><table><thead><tr><th>Attribute type</th><th>Sort order (ascending)</th></tr></thead><tbody><tr><td>Text, Multi-line text, URL, Email, Phone</td><td>A to Z, 0 to 9</td></tr><tr><td>Number</td><td>lowest → greatest</td></tr><tr><td>Date, Date & time</td><td>oldest → newest</td></tr><tr><td>Time</td><td>earliest hour (closest to 0) → latest hour (closest to 24)</td></tr><tr><td>Checkbox</td><td>unchecked → checked</td></tr><tr><td>Select</td><td>The order in which the options are declared. <br>For example, a select attribute declared with “Low”, “Medium”, and “High” options will be sorted as follows: Low → Medium → High.</td></tr><tr><td>Color</td><td>Grays → colors. Colors are ordered by their color-wheel <a href=\"https://en.wikipedia.org/wiki/Hue\">hue</a> angle (from 0° to 360°).</td></tr></tbody></table></figure><p>Relation attributes are ordered according to the title of the target note.</p><p>Cards with attributes that have no value set are always sorted at the end of the column, regardless of whether the sort order is ascending or descending. If an attribute holds more than one value, only the first value is used for sorting.</p><h4>Configuring the default sorting options</h4><p>Every new column uses the <em>Board's default</em> sorting option, which is initially set to manual sorting on new boards. However, the default can be changed to any other sorting criterion and direction. To configure it, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Default card order</em> (under the <em>General</em> section).</p><p>Once the default is changed, all columns set to the <em>Board's default</em> sorting option will follow the new sorting options.</p><p>Columns using a sorting option other than <em>Board's default</em> will not be affected by the new default. To override all columns so that they use the default sorting options, use the <em>Reset sorting options to default for all columns</em> command in <em>Board properties</em>.</p><aside class=\"admonition warning\"><p>Using the <code>#sorted</code> attribute on Kanban boards <strong>is no longer recommended</strong>, because it applies to every column and prevents manual sorting. Instead, use <code>#board:sortColumns</code>, which is designed exclusively for board collections and can take one of the following values: <code>title</code>, <code>creationDate</code>, or <code>attr:_<attribute name>_</code>, for example, <code>#board:sortColumns=attr:dueDate</code>. Using the <code>#board:sortColumnsDescending</code> label will switch to descending order.</p></aside><h3>Setting a limit</h3><p>For each column, you can limit the number of cards it contains (also known as a WIP limit). Once the limit is exceeded, the column displays a visual warning to indicate that it is over its limit.</p><p>To enable the limit, go to the column menu → <span class=\"tn-icon bx bx-tachometer\"></span> <em>Set limit</em>, and then:</p><ul><li>Turn on the <em>Warn for exceeding the column capacity</em> toggle.</li><li>Enter the desired limit in the <em>Maximum number of cards in the column</em> text box.</li><li>Press the <em>Set limit</em> button.</li></ul><p>A column that has reached its limit can still accept new cards. Blocking new cards is not supported and most likely never will be, due to the way Trilium works: cards are regular notes, and the attributes used to group them into columns can be set from anywhere in the app, outside the board control. As a result, enforcing the limit would not be consistent.</p><h3>Archiving a column</h3><p>If you want to hide a column from the board without deleting it, you can archive it by opening the column menu → <span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive column</em>. Archiving a column does not set the archived flag (see <a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>) on the notes corresponding to its cards.</p><p>To show archived columns again, go to <span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived columns will appear faded. To restore one, open its column menu and select <span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive column</em>.</p><h3>Deleting a column</h3><p>You can delete a column by opening the column menu → <span class=\"tn-icon bx bx-trash\"></span> <em>Delete column</em>, or by pressing <kbd>Delete</kbd> when a column header is focused, and then confirming. This removes the column from the board and unsets the grouping attribute for each note represented by a card in that column. If the column contains cards, the confirmation also offers to delete their notes instead of keeping them.</p><p>The inbox column is not deleted this way. Its menu entry is <span class=\"tn-icon bx bx-trash\"></span> <em>Remove inbox column</em>, and <kbd>Delete</kbd> on its header hides the inbox without changing any card.</p><h3>The inbox column</h3><p>The inbox column is a special column containing cards that are not assigned to another column. It is particularly useful when you switch an existing collection containing child notes to a board collection. The inbox column turns all child notes into cards that you can quickly distribute among the other columns. It can also act as a backlog where you can keep new cards that might eventually become part of the board.</p><p>The inbox column is hidden by default. To show it, go to <span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <em>Show inbox column</em>. The inbox column is distinguishable by its transparent background. It is always the first column and cannot be moved. It does not support a card limit. Otherwise, it operates like a regular column: its title, icon, and color can be changed; it can be sorted manually or automatically; and it can be collapsed.</p><p>You can also show the inbox column by applying the <code>#board:showInbox</code> label (read more about <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) to the board note.</p><p>Optionally, the inbox column can also list nested notes from the board collection's subtree. To enable this, open the column menu and check <span class=\"tn-icon bx bx-subdirectory-right\"></span> <em>Include nested notes</em>.</p><h3>Changing the width of columns</h3><p>There are three predefined widths for board columns: narrow (default), medium, and wide. To change the width, open the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> → <em>Column width</em> (under the <em>General</em> section). This option applies to every column on the board, except in the mobile version.</p><p>The same option is also available through the <code>#board:columnWidth</code> label (read more about <a class=\"reference-link\" href=\"#root/_help_zEY4DaJG4YT5\">Attributes</a>) on the board note, which accepts “<code>narrow</code>”, “<code>medium</code>”, or “<code>wide</code>” as its value.</p><p>You can also redefine these three widths by using custom app CSS (read more about <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a>) and assigning the desired pixel values as follows:</p><pre><code class=\"language-text-x-trilium-auto\">#trilium-app {\n --board-column-width-narrow: 275px;\n --board-column-width-medium: 325px;\n --board-column-width-wide: 400px;\n}</code></pre><h2>Working with cards</h2><h3>Creating a new card</h3><p>To create a new card, press the <span class=\"tn-icon bx bx-plus\"></span><em>New card</em> button located at the bottom of each column. To create a new card above or below a specific card, right-click or hold that card, and then select <span class=\"tn-icon bx bx-list-plus bx-flip-vertical\"></span> <em>Insert new above</em> or <span class=\"tn-icon bx bx-list-plus\"></span> <em>Insert new below</em> from the context menu. Alternatively, press <kbd>Shift</kbd> + <kbd>Enter</kbd> to create a new card above the focused card, or <kbd>Enter</kbd> to create one below it.</p><p>Next, type the title of the new card, and then press the <span class=\"tn-icon bx bx-plus-circle\"></span> button or <kbd>Enter</kbd> to complete it. Tap or click anywhere outside the text box to dismiss it. You can also select a different icon and card template. To learn more about card templates, see Card templates (learn more about <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a>).</p><p>After the card is created, you can tap or click it, or press <kbd>Space</kbd>, to edit the note content.</p><p>When using the <span class=\"tn-icon bx bx-plus\"></span> <em>New card</em> button, cards are always created at the end of the column. To create the card at the top of the column, right-click or hold the <span class=\"tn-icon bx bx-plus-circle\"></span> button and select <span class=\"tn-icon bx bx-vertical-top\"></span> <em>Create at top</em>. When using keyboard shortcuts, focus the column header and press <kbd>Enter</kbd> to create a new card at the start of the column, or <kbd>Shift</kbd> + <kbd>Enter</kbd> to create one at the end.</p><h3>Adding an existing note as a card</h3><p>Any note in your knowledge base can be represented as a card on a board. To add an existing note to your board, create a new card but do not enter a title. Instead, press the <span class=\"tn-icon bx bx-folder-open\"></span> button. Alternatively, use the <span class=\"tn-icon bx bx-folder-open\"></span> <em>Add an existing note as a card</em> command from the column menu.</p><p>In the dialog that opens, search for the note by name, and then press the <em>Add to column</em> button to insert it. Alternatively, you can drag any note from the tree and drop it at the desired position on the board.</p><p>If the target note is already in the board collection's subtree, it will already be listed in the <strong>inbox column</strong>.</p><aside class=\"admonition important\"><p>Notes added to the board are cloned, not duplicated. This means that changes to their titles, content, and attributes on the board are reflected in their original locations as well. See <a class=\"reference-link\" href=\"#root/_help_IakOLONlIfGI\">Cloning Notes</a> for more information.</p></aside><h3>Selecting multiple cards</h3><p>When working with a board, you may need to perform operations on multiple cards at once, such as moving them to another column, setting attributes or colors, deleting them, or archiving them.</p><p>You can select multiple cards in the following ways:</p><ul><li><strong>Using a mouse and keyboard:</strong><ul><li>To add a card to the selection, hold <kbd>Ctrl</kbd> and click the card. Repeat this for other cards until all the desired cards are selected. Clicking a selected card again while holding <kbd>Ctrl</kbd> will deselect it.</li><li>If the cards you want to select form a continuous sequence within a column, hold <kbd>Shift</kbd>, click the first card in the sequence, and then click the last card.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li><li><strong>On mobile:</strong><ol><li>To enter selection mode, tap the <span class=\"tn-icon bx bx-select-multiple\"></span> button at the top of the screen. A selection toolbar will appear in the header, displaying “0 cards selected”.</li><li>Tap the cards you want to select. If you tap a selected card again, it will be deselected. To select all cards in a column, press the <span class=\"tn-icon bx bx-list-check\"></span> button on the selection toolbar. To clear the selection, press the <span class=\"tn-icon bx bx-x\"></span> button.</li><li>Use the side toolbar to apply actions to the selected cards.</li></ol></li><li><strong>Using only the keyboard:</strong><ul><li>To add the currently focused card to the selection, press <kbd>Ctrl</kbd> + <kbd>Space</kbd>. Repeat this for the other cards you want to select. Pressing <kbd>Ctrl</kbd> + <kbd>Space</kbd> again on a selected card will deselect it.</li><li>To select a continuous sequence of cards within a column, hold <kbd>Shift</kbd> and use the <kbd>Up</kbd> and <kbd>Down</kbd> arrow keys to expand or shrink the selection.</li><li>To select every card in the column the focus is in, press <kbd>Ctrl</kbd> + <kbd>A</kbd>. The same action is available from the column menu, as <span class=\"tn-icon bx bx-selection\"></span><em>Select all cards</em>.</li><li>Press <kbd>Esc</kbd> to clear the selection.</li></ul></li></ul><h3>Moving cards between columns</h3><p>To move one or more cards to another column, use one of the following methods:</p><h4>Using touch or a mouse</h4><p>Touch and hold the card, or click and hold it with the mouse, and then drag it to the desired column. If the column uses manual sorting, you can also position the card relative to the other cards.</p><aside class=\"admonition tip\"><p>To drag a card outside the board, for example to the note tree, another split, or another window, hold <kbd>Ctrl</kbd> and then start dragging.</p></aside><p>If the target column is collapsed, you can drop the card onto its header to move it into that column (at the end if manually sorted), without expanding it. However, if you want to reveal its cards before dropping, hold the card over the column for a few seconds; the column will then expand.</p><aside class=\"admonition tip\"><p><strong>You can quickly drop a card at the start or end of a column.</strong></p><p>Drop the card above the column while the “Drop as the first card” hint is displayed to make it the first card in that column. Alternatively, drop it below the column while the “Drop as the last card” hint is displayed to make it the last card.</p></aside><h4>Using the keyboard</h4><p>You can also use keyboard shortcuts to move the selected card or cards between columns:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Right</kbd>: Move to the next column.</li><li><kbd>Ctrl</kbd> + <kbd>Left</kbd>: Move to the previous column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Right</kbd>: Move to the last column.</li><li><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Left</kbd>: Move to the first column.</li></ul><h4>Using the context menu</h4><p>To quickly move a card to another column, open the card's context menu and select the destination column. The menu lists the first seven columns; on a wider board, the remaining ones are grouped under <em>More…</em>.</p><h3>Reordering cards within a column</h3><p>Cards within a column can be freely reordered unless the column uses a sorting option other than manual. To reposition a card, drag it as described in the <strong>Moving cards between columns</strong> section and drop it at the desired position.</p><p>Alternatively, you can use keyboard shortcuts to move the selected card or cards:</p><ul><li><kbd>Ctrl</kbd> + <kbd>Up</kbd>: Move up.</li><li><kbd>Ctrl</kbd> + <kbd>Down</kbd>: Move down.</li><li><kbd>Ctrl</kbd> + <kbd>Home</kbd>: Move to the top of the column.</li><li><kbd>Ctrl</kbd> + <kbd>End</kbd>: Move to the end of the column.</li></ul><p>If multiple cards are selected, the keyboard shortcuts work only if the selection consists of a continuous sequence of cards.</p><h3>Editing a card</h3><p>Every card on a board is a regular note. To edit the note associated with a card, click or tap the card, or press <kbd>Space</kbd> when the card is selected. The note will open in a Quick Edit dialog, where you can modify it. You can also open the note in a new tab, split, or window by using the <span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> submenu in the card's context menu. To open the note in a new tab on the desktop version, you can also click or tap the <span class=\"tn-icon bx bx-link-external\"></span> <em>Open note</em> menu item directly, without opening its submenu.</p><p>To change the title or icon of a card, use one of the following methods:</p><ul><li><strong>Using a mouse:</strong> Place the mouse pointer over the card, and then click the <span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>On mobile:</strong> Hold the card until the side toolbar appears, and then tap the <span class=\"tn-icon bx bx-rename\"></span> button.</li><li><strong>Using the keyboard:</strong> Select a card, and then press <kbd>F2</kbd>.</li><li><em>Using the context menu:</em> Open the card's context menu and select <span class=\"tn-icon bx bx-rename\"></span> <em>Edit title & icon</em>.</li></ul><p>You can then enter a new name and select another icon. To move the keyboard focus from the title field to the icon selector, press <kbd>Shift</kbd> + <kbd>Tab</kbd>. Click or tap anywhere outside the card, or press <kbd>Enter</kbd>, to apply the change. Press <kbd>Esc</kbd> to discard the changes.</p><p>Each card can be tinted with a different color. Open the card's context menu and select the desired color. If no color is assigned, the card inherits the column color.</p><aside class=\"admonition important\"><p>The title, icon, and color of a card are the same as those of the corresponding note. If that note exists in multiple locations in the tree, any change to its title, icon, or color on the board will apply in those locations as well, not only on the board.</p></aside><h3>Archiving a card</h3><p>A card can be hidden from the board without deleting it by using the <span class=\"tn-icon bx bx-archive-in\"></span> <em>Archive note</em> command from the card's context menu.</p><p>To show archived cards again, go to <span class=\"tn-icon bx bx-cog\"></span> <em>Collection options</em> and toggle <span class=\"tn-icon bx bx-archive-in\"></span> <em>Show archived notes</em>, or turn on <em>Show archived cards and columns</em> in <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> (under the <em>Included notes</em> section). Archived cards will appear faded. To restore one, open its context menu and select <span class=\"tn-icon bx bx-archive-out\"></span> <em>Unarchive note</em>.</p><aside class=\"admonition warning\"><p>Archiving a card sets the <code>#archived</code> flag on its note. If the note exists in multiple locations in the tree, it will appear archived in those locations as well. Read more about <a class=\"reference-link\" href=\"#root/_help_MKmLg5x6xkor\">Archived Notes</a>.</p></aside><h3>Deleting a card</h3><p>You can remove one or more cards from the board and delete their associated notes by using the <span class=\"tn-icon bx bx-trash\"></span> <em>Delete note…</em> command from the card's context menu, or by pressing <kbd>Shift</kbd> + <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the <span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Removing a card from the board without deleting the note</h4><p>To remove a card from the board's columns while keeping its note, open the card's context menu and select <span class=\"tn-icon bx bx-task-x\"></span> <em>Remove from column</em>, or press <kbd>Delete</kbd>. On mobile, hold the card until the side toolbar appears, and then tap the <span class=\"tn-icon bx bx-task-x\"></span> button.</p><p>This command is not available when the inbox column is enabled. Instead, drag the card to the inbox column to achieve the same result.</p><p>The note remains in the board collection but is not assigned to any column. To see it on the board again, enable the inbox column.</p><aside class=\"admonition note\"><p>Under the hood, removing a card simply unsets the note's grouping attribute.</p></aside><h3>Working with custom card attributes</h3><p>By default, the face of a card displays a minimal set of information: the title, icon, and color. In some cases, this may not provide enough useful information at a glance. You can extend the card to display extra information, called card attributes, such as a due date, priority, completion status, or any other information you need. Card attributes use the same principles as <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a>.</p><h4>Creating a new attribute</h4><p>To create a new attribute, follow these steps:</p><ol><li>Go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the <em>Card attributes</em> section, and then press the <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em> button.</li><li>Enter a name for the attribute. This is the internal name used by Trilium, so do not use spaces or special characters.</li><li>Select a type (text, number, checkbox, and so on).</li><li>Set the display name. This is the name shown on the card.</li><li>Press <em>Save & close</em>.</li></ol><aside class=\"admonition note\"><p>For each newly created attribute, Trilium creates an attribute definition on the board collection note. A card displays the attributes declared as inheritable on the board note, as well as any attribute the card gets a definition for from elsewhere, for example through <a class=\"reference-link\" href=\"#root/_help_KC1HB96bqqHX\">Templates</a> or another parent note it is cloned under. Attributes that only the cards define are listed after the board's own.</p></aside><p>Here is an example of the attributes you can define for a typical Kanban board used to track tasks:</p><figure class=\"table\"><table><thead><tr><th>Attribute name</th><th>Attribute type</th><th>Attribute display name</th></tr></thead><tbody><tr><td>dueDate</td><td>Date & Time</td><td>Due date</td></tr><tr><td>priority</td><td>Select (options: Low, Medium, High, Urgent)</td><td>Priority</td></tr><tr><td>done</td><td>Checkbox</td><td>Done</td></tr></tbody></table></figure><h4>Modifying the values of custom attributes</h4><p>To set the value of a custom attribute, click or tap the card, and then enter or select the desired value in the dialog header.</p><p>For attributes of the “select”, “checkbox” or “date” type, you can quickly change the value by using the card's context menu under the <em>Attributes</em> section. A date attribute's submenu offers <em>Not set</em> to clear the value, and a date picker: a calendar to pick any day, with buttons below it for <em>Today</em>, <em>Tomorrow</em> and <em>Next week</em> (the first day of next week, as set in the first day of the week option). Use the arrows to change the month, and click a day to set it. From the keyboard, the arrow keys move by day and week, <kbd>Page Up</kbd> and <kbd>Page Down</kbd> by month, and <kbd>Enter</kbd> sets the day; <kbd>↓</kbd> from the last week moves to the buttons, <kbd>←</kbd> and <kbd>→</kbd> move between them, and <kbd>↑</kbd> returns to the calendar.</p><h4>Reordering, hiding, redefining, and deleting custom attributes</h4><p>Go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>. Under the <em>Card attributes</em> section, you can:</p><ul><li>Hold the <strong>=</strong> handle shown beside an attribute, and then drag the item up or down to reorder the attributes. This determines the order in which the attributes are displayed on the card.</li><li>Turn off the toggle to hide an attribute from the card's face. The attribute remains available when you edit the card. For the current grouping attribute, the toggle is disabled.</li><li>Press the <span class=\"tn-icon bx bxs-edit\"></span> button to modify the definition of an attribute.</li><li>Press the <span class=\"tn-icon bx bx-trash\"></span> button to delete the attribute and all its values from every note in the board collection.</li></ul><p>Attributes that the cards get from a template or another parent note can be reordered and hidden here, but not modified or deleted. Edit them on the note that defines them.</p><p>If cards define an attribute with the same name but a different type or different select options, for example through two different templates, or if a card overrides the board's definition with its own, the attribute is marked <em>Multiple definitions</em>. Such an attribute is sorted as text and does not appear in the card's context menu.</p><h3>Managing card templates</h3><p>When you create a new card, Trilium offers four templates by default: <em>Text</em>, <em>Markdown</em>, <em>Canvas</em>, and <em>Spreadsheet</em>. You can customize this list to include other note types or custom templates with predefined placeholder content and prefilled card attributes.</p><p>To customize the card templates, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em> and find <em>Card templates</em>. Here you can:</p><ul><li>Include a note type or note template already created in your knowledge base by pressing the <span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em> button and then selecting the desired note type or template.</li><li>Create a new template by pressing the <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new template</em> button. The template editor will open, where you can define the icon, title, default attribute values, and default content. The note template will be created as a child of the board collection.</li><li>Press the <span class=\"tn-icon bx bx-x\"></span> button to remove a template from the list. The template is removed only from the list, not deleted from your knowledge base. You can add it again using <span class=\"tn-icon bx bx-list-plus\"></span> <em>Add existing template</em>.</li><li>Press the <span class=\"tn-icon bx bx-dots-vertical-rounded\"></span> button to open a dropdown that lets you edit, open in a new window, duplicate, or delete a template. This button is visible only for custom note templates.</li><li>Hold the <strong>=</strong> handle shown beside a template, and then drag the item up or down to reorder the templates. This determines the order in which templates are listed in the template dropdown when you create a new card. You can move the most frequently used templates to the top for faster access.</li></ul><h3>Grouping cards</h3><p>On a board, cards are grouped into columns. The column to which a card belongs is determined by the value of the <strong>grouping attribute</strong>, which is a regular attribute of the card's note.</p><p>By default, boards use the <strong>Status</strong> attribute as the grouping attribute. When you move a card to a column called “Waiting on Customer”, the card's Status attribute is set to “Waiting on Customer”.</p><aside class=\"admonition note\"><p>Under the hood, the Status attribute is declared on the board collection note with the name <code>status</code>. It is a select-type attribute that is inheritable and promoted. Each select option becomes a column, and each new column created on the board extends the list of options.</p></aside><h4>Creating a new grouping attribute</h4><p>To quickly create a new grouping attribute:</p><ol><li>Open the <span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header and select <span class=\"tn-icon bx bx-plus\"></span> <em>Create a new attribute</em>.</li><li>Fill in the <em>Name</em> field. This is used internally by Trilium, so do not use spaces or special characters.</li><li>Enter the <em>Display name</em>. This is the attribute name shown in the dropdown list.</li><li>Press <em>Save & close</em>.</li></ol><aside class=\"admonition tip\"><p>Because the grouping attribute is a regular card attribute, you can also create it in <em>Board properties</em>. Make sure you set the attribute type to “select”.</p></aside><h4>Switching the grouping attribute</h4><p>Switching the grouping attribute lets you view your cards by priority, category, or any other custom grouping attribute. You can switch the grouping attribute at any time by using the <span class=\"tn-icon bx bx-category-alt\"></span> <em>Group by</em> dropdown in the board header. You can also change it using the <code>#board:groupBy=<_attribute name_></code> label.</p><aside class=\"admonition warning\"><p>The order of cards in manually sorted columns corresponds to their positions within the board collection subtree. This means that the card order is shared across all views, regardless of the grouping attribute. Reordering notes in one view will also reorder them in other views that use a different grouping attribute.</p></aside><h4>Deleting a grouping attribute</h4><p>To delete a grouping attribute, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Board properties</em>, find the attribute under the <em>Card attributes</em> section, and press the corresponding <span class=\"tn-icon bx bx-trash\"></span> button.</p><h4>Grouping by relations</h4><p>A more advanced use case is grouping by <a href=\"#root/_help_Cq5X6iKQop6R\">Relations</a>.</p><p>In this mode:</p><ul><li>The columns represent the <em>target notes</em> of a relation.</li><li>When creating a new column, you select a note instead of entering a column name.</li><li>The column icon matches the target note.</li><li>Moving notes between columns changes their relations.</li><li>Renaming an existing column changes the target note for all notes in that column.</li></ul><p>Using relations instead of labels has several benefits:</p><ul><li>The status or grouping of notes is visible outside the Kanban board, for example, on the <a class=\"reference-link\" href=\"#root/_help_bdUJEHsAPYQR\">Note Map</a>.</li><li>A column takes its title and icon from the target note, so renaming that note anywhere in the tree renames the column.</li></ul><p>To use relations for grouping:</p><ol><li><p>Create a Kanban board from scratch rather than from a template.</p></li><li><p>Assign <code>#viewType=board #hidePromotedAttributes</code> to emulate the default template.</p></li><li><p>Set <code>#board:groupBy</code> to the name of a relation, <strong>including the</strong> <code>~</code> <strong>prefix</strong> (for example, <code>~status</code>).</p></li><li><p>Optionally, use <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> to make changing the status within the note easier:</p><pre><code class=\"language-text-x-trilium-auto\">#relation:status(inheritable)=\"promoted,alias=Status,single\"</code></pre></li></ol><h2>Searching and filtering the board</h2><p>You can search for cards using the search box at the top of the board. Enter your keywords, and then press the <span class=\"tn-icon bx bx-search\"></span> button in the search field or press <kbd>Enter</kbd>. Only cards whose titles, content, or attribute values match the query will be displayed. Columns without results will be temporarily collapsed to make room for the matching cards. Press the <span class=\"tn-icon bx bx-x\"></span> button in the search field to clear the search and display all cards again.</p><h3>Advanced filtering</h3><p>If you need to refine the view to display only cards matching specific criteria beyond a regular text search, you can use Trilium's search query syntax. Here are some example queries:</p><p>Display only cards whose <strong>Priority</strong> attribute is set to “Low”:</p><pre><code class=\"language-text-x-trilium-auto\">#priority=Low</code></pre><p>Display only cards whose <strong>Issue Category</strong> is set to “Software” and whose <strong>Site</strong> is set to either “Office” or “Factory”:</p><pre><code class=\"language-text-x-trilium-auto\">#issueCategory=\"Software\" AND (#site=\"Office\" OR #site=\"Factory\")</code></pre><p>Display only cards with a <strong>Due Date</strong> in the next seven days that are not yet marked as <strong>Done</strong>:</p><pre><code class=\"language-text-x-trilium-auto\">#dueDate >= TODAY AND #dueDate <= TODAY+7 AND #!done</code></pre><p>The filter persists even after you close the tab. When you reopen the collection, the filter remains active until you clear the search query by using the <span class=\"tn-icon bx bx-x\"></span> button.</p><h2>Linking to a column or a card</h2><p>You can create a link that opens the board and points out a specific column or card. Open the column menu or the card’s context menu, select <span class=\"tn-icon bx bx-copy\"></span> <em>Copy reference</em>, and then paste the link where you need it.</p><p>In a text note, the pasted link displays the title, icon, and color of the column or card it points to. In a Markdown or code note, the plain link address is pasted instead. Opening the link scrolls the board to the column or card and focuses it. If the column belongs to a different grouping attribute, the board switches to that attribute first.</p><h2>Read-only boards</h2><p>A board marked as <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> only shows its cards. It has no buttons to add a card or a column, column and card titles can't be renamed, and column icons can't be changed. Cards and columns can't be dragged, moved or deleted with the keyboard, and notes dragged in from the note tree aren't added. The context menus of a card or a column keep only the entries that change nothing, such as opening the note or <span class=\"tn-icon bx bx-copy\"></span><em>Copy reference</em>, and the board's own menu doesn't open. The cards can still be grouped by another attribute, but the choice isn't saved, and no new grouping attribute can be created.</p>",
"_help_81SGnPGMk7Xc": "<figure class=\"image\"><img style=\"aspect-ratio:1561/1149;\" src=\"{{helpAssets}}/User%20Guide/Collections/Geo%20Map_image.png\" width=\"1561\" height=\"1149\"></figure><p>This note type displays the children notes on a geographical map, based on an attribute. It is also possible to add new notes at a specific location using the built-in interface.</p><h2>Features</h2><ul><li>Add markers on the map, which can be customized with icons, colors and text.</li><li>Search the notes already on the map, and look up places anywhere in the world.</li><li>Turn a place the map already shows into a marker by clicking it.</li><li>Draw paths, areas, rectangles and circles onto the map.</li><li>Display tracks on the map using <code>.gpx</code> files.</li><li>Show your own location on the map and follow it as you move.</li><li>3D view of the map, which displays buildings when using a vector map.</li></ul><h2>System requirements</h2><p>Starting with v0.105.0, the geomap uses MapLibre GL which requires WebGL v1 support. In general, most devices will support it because browsers/Electron can render it in software if needed.</p><p>If the map could not be drawn because WebGL could not be initialized, an error message will appear instead of the map (<em>This map can't be drawn because WebGL isn't available…</em>).</p><p>The button that shows your location is offered only when Trilium is reached over HTTPS, in the desktop application or in the mobile application. Browsers refuse to share the location of a device with a page served over plain HTTP, so on such a server the button does not appear. The desktop application on Linux does not offer it either, because it has no way to find the location of the device there.</p><h2>Interaction</h2><ul><li>At the top-left there is the search bar. It searches the notes already on the map, and it can also search for places online when you ask it to. While you move through the results of a search, a counter with previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and next (<span class=\"tn-icon bx bx-chevron-right\"></span>) buttons appears under it.</li><li>At the bottom-center there is a central toolbar which provides editing features: adding new markers on the map (<span class=\"tn-icon bx bx-pin\"></span>) and importing GPX tracks (<span class=\"tn-icon bx bx-trip\"></span>).</li><li>At the bottom-right there are the viewport items:<ul><li>Zoom in/out (<span class=\"tn-icon bx bx-plus-circle\"></span> / <span class=\"tn-icon bx bx-minus-circle\"></span>)<ul><li>On mobile these are hidden, use pinch to zoom instead.</li><li>On desktop, alternatively use the scroll wheel to adjust the zoom.</li></ul></li><li>A <span class=\"tn-icon bx bx-current-location\"></span> button that shows your location on the map and follows it (see <em>Going to your location</em> below).</li><li><span class=\"tn-icon bx bx-fullscreen\"></span> Full screen button which focuses the entire map onto the screen, while still allowing for edits.</li></ul></li><li>At the top-center (on desktop, or left-center on mobile and in split views) there are the drawing tools such as paths, areas, rectangles and circles.<ul><li>When the map is read-only, the toolbar is not shown.</li></ul></li></ul><h2>Creating a new geo map</h2><p>Right click on an existing note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em> → <em>Collection</em> → <em>Geo Map</em>.</p><p>By default the map will be empty and will show the entire world.</p><h2>Repositioning the map</h2><ul><li>Click and drag the map in order to move across the map.</li><li>Use the mouse wheel, two-finger gesture on a touchpad or the +/- buttons on the bottom-right to adjust the zoom.</li></ul><p>The position on the map and the zoom are saved inside the map note and restored when visiting again the note.</p><p>A map that has no position saved yet is framed around the markers it contains when you open it, so they are all in view without having to go looking for them. A map that contains no markers shows the whole world instead.</p><p>In practice this applies to maps whose markers were added externally, by a script or through <a class=\"reference-link\" href=\"#root/_help_pgxEVkzLl1OP\">ETAPI (REST API)</a>. When you add markers yourself you have already moved the map to reach the place you are marking, and that movement saves a position.</p><h2>Going to your location</h2><p>Press the <em>Show your location</em> (<span class=\"tn-icon bx bx-current-location\"></span>) button at the bottom-right of the map, beside the zoom buttons. The first time, the browser or the operating system asks whether Trilium may know where the device is. In the desktop application the operating system's location settings decide.</p><p>The map then moves to where the device is and marks it with a blue dot. A lighter circle around the dot shows how accurate the position is: a phone with GPS gives a dot on the street, while a computer located through its network connection can give a circle that covers a neighbourhood. The map follows the dot as it moves, and the button stays pressed while it does.</p><p>Dragging the map stops it from following. The dot stays and keeps moving, and pressing the button again brings the map back to it. Pressing the button while the map is following turns the dot off.</p><p>Click the dot to see its coordinates in the panel a searched place is shown in. From there the position can be kept as a marker (see <em>Keeping a place as a marker</em>). Clicking the lighter circle around the dot is a click on the map.</p><p>If the position cannot be found, a message says so and the button keeps waiting for one; press it again to stop. If you refuse the permission, the button is disabled until the map is opened again. To allow it after all, change the permission for Trilium in the browser or in the system's location settings.</p><p>Your position is not stored in the note, and Trilium does not send it anywhere on its own. Moving the map there does what any other pan or zoom does: the tile provider behind the map's style sees the coordinates of the area now on screen. The map does remember where you left it, as it does after any other movement, so a map you have taken to your location opens there the next time.</p><h2>Searching the map</h2><p>The search bar at the top-left of the map searches in two places. It always searches the notes that are already on the map. It can also search for places online, but only when you ask it to.</p><h3>Searching the notes already on the map</h3><p>Type in the search bar, and the notes on the map are matched by their title as you type. Accents are ignored, both in what you type and in the titles, so <code>zurich</code> finds <em>Zürich Hauptbahnhof</em>. Each word is searched for on its own, so <code>hotel paris</code> finds <em>Paris Hotel</em>. Notes without a <code>#geolocation</code> attribute are not offered, since there would be nowhere to go. Drawn shapes and GPS tracks are offered, even though they carry no such attribute: selecting one brings the whole shape or route into view.</p><p>If more notes match than the list can show, you are offered the ones closest to the area you are viewing.</p><h3>Searching for places online</h3><p>Looking up a place sends what you typed to a third-party service. For this reason, it never happens while you type. Instead, the last row of the result list offers the search. That row reads <em>Search online for \"…\"</em>, with the name of the service below it. The search runs only when you press that row or select it with Enter.</p><p>Trilium uses Nominatim, the place search run by the OpenStreetMap Foundation. It needs no account and no API key. Its name is shown on every row that belongs to it: the row that offers the search, the row that says a search is running, and the row that reports that nothing was found or that the service could not be reached.</p><p>The search prefers the area you are viewing. Places inside the current view are searched for first and listed above the others. If you search for a shop while looking at your own town, you therefore find the branch in that town, and not one with the same name on another continent. The view is always treated as at least 25 km across, so a search made while zoomed into a single street still covers the town around it.</p><h3>Going to a point</h3><p>If you type or paste coordinates into the search bar, a <em>Go to</em> row is offered above all the other results. Selecting it moves the map to that exact spot and marks it. You can then keep it as a marker, in the same way you keep a place found by searching.</p><p>Points are untitled by default; the corresponding note opens with the default name selected so it can be easily replaced. If the map has a <a class=\"reference-link\" href=\"#root/_help_47ZrP6FNuoG8\">Default Note Title</a> label, the marker is named by that template instead.</p><p>The supported forms are:</p><ul><li>A plain pair, such as <code>45.9432, 24.9668</code>. This is what Google Maps and OpenStreetMap both give you when you ask for the coordinates of a place, and it is also what the <code>#geolocation</code> attribute holds.</li><li>The <code>geo:</code> link that the map itself offers for a place, through the <em>Open location</em> action.</li><li>The address of a place on Google Maps or OpenStreetMap, pasted whole.</li></ul><p>A pair that is not a place on Earth, such as <code>1234, 5678</code>, is not offered.</p><h3>Reading the results</h3><p>Results are gathered under headings, and each group is ordered by distance from the middle of the map:</p><ul><li><em>On this map</em>: notes that are already on the map, whatever their distance.</li><li><em>Nearby</em>: places found within about 25 km of the view.</li><li><em>Far away</em>: all the other places.</li></ul><p>The headings only appear when at least two of the three groups contain something. Every row that has a position shows how far away it is, in kilometres or miles according to your locale. A place found online shows its name on the first line and its address on the second.</p><h3>Selecting a result</h3><p>Selecting a note already on the map moves to its marker and opens the note beside the map, as clicking the marker would.</p><p>Selecting a place found online moves the map to it and marks it with a temporary pin. The pin has a different color from the map's own markers. The map is fitted to the area that the place covers, so a country fills the view, while a house is shown at street level. Some places have a boundary, such as a country, a county or a park. When the service reports one, that boundary is outlined under the pin.</p><p>A panel then opens with the place's full address and its coordinates: in the top-right corner on desktop, and at the bottom of the map on mobile, where the top is kept for the search bar and the result counter. Pressing the coordinates copies them to the clipboard.</p><h3>Keeping a place as a marker</h3><p>Press <em>Add as marker</em> in that panel to keep the place. A child note is created under the map. It takes the name of the place, as well as the icon, which matches the kind of place it is. Its <code>#geolocation</code> attribute is already set. The note opens beside the map, so you can edit it straight away. The temporary pin disappears, because the place is now a marker like any other.</p><p>The button is not offered on a map that cannot be edited, where the panel can still be read.</p><p>Press the panel's close button, or the Escape key, to send the place away without keeping it. The pin goes with it.</p><h3>Stepping through the results</h3><p>Once you select a result, a counter appears under the search bar, with a previous (<span class=\"tn-icon bx bx-chevron-left\"></span>) and a next (<span class=\"tn-icon bx bx-chevron-right\"></span>) button. These buttons move through everything the search offered, in the order it was listed. You can therefore compare several results without opening the list again. Pressing the counter itself moves the map back to the current result, which is useful after you have moved the map away from it.</p><h3>The keyboard</h3><ul><li><kbd>Enter</kbd> runs the online search when its row is the one selected, and otherwise moves to the highlighted result. Pressed after a result has been taken, it brings the list back.</li><li><kbd>Escape</kbd> closes the result list, and closes the place panel.</li><li>Returning to the search bar reopens the list it was showing.</li><li>The <span class=\"tn-icon bx bx-x\"></span> button at the end of the bar empties it, which also takes a searched place, its pin and its panel off the map.</li></ul><h2>Adding a marker using the map</h2><h3>Adding a new note using the <em>Add marker</em> button</h3><ol><li><p>To create a marker, first navigate to the desired point on the map. Then press the <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the center-bottom of the map.</p></li><li><p>Once pressed, the map will enter in the insert mode, as illustrated by the notification. Additionally, a preview of the marker will be shown at the cursor position.</p><p>Simply click the point on the map where to place the marker. To cancel, press either the Escape key or press again the <em>Add marker</em> button.</p></li><li><p>Once clicked, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</p></li></ol><h3>Adding a new note using the contextual menu</h3><ol><li>Right click anywhere on the map, where to place the newly created marker (and corresponding note).</li><li>Select <em>Add a marker at this location</em> (<span class=\"tn-icon bx bx-pin\"></span>).</li><li>Once clicked on a position on the map, the marker will show up on the map and a popup will show to the right with the title already selected to be changed.</li></ol><h3>Adding an existing note from the note tree</h3><ol><li>Select the desired note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a>.</li><li>Hold the mouse on the note and drag it to the map to the desired location.</li><li>The map should be updated with the new marker.</li></ol><p>This works for:</p><ul><li>Notes that are not part of the geo map, case in which a <a href=\"#root/_help_IakOLONlIfGI\">clone</a> will be created.</li><li>Notes that are a child of the geo map but not yet positioned on the map.</li><li>Notes that are a child of the geo map and also positioned, case in which the marker will be relocated to the new position.</li></ul><aside class=\"admonition note\"><p>Dragging existing notes only works if the map is in editing mode. See the <em>Read-only</em> section for more information.</p></aside><h3>Adding a note from a place the map already shows</h3><p>When a vector map style is used, the map itself draws the shops, cafés, museums and other places around the area being viewed. Once the map is zoomed in far enough for these to be drawn, they can be clicked:</p><ol><li>Look for the places drawn in orange. This is the same color used for a place found by searching. These are the places you can click. They are drawn almost solid, while the other places on the map stay a faint grey.</li><li>Rest the mouse on one of them. Its name appears above it, and the mouse cursor changes to a pointer. The map draws these places as icons without names, so you read a name by hovering over it. If all the names were shown at once, they would crowd out the titles of your own markers.</li><li>Click it. The same panel used for a place found by searching appears. It shows the name of the place and its coordinates, and a pin is placed on the map.</li><li>Press <em>Add as marker</em> to keep it. The note is created with the name of the place as its title, and with the icon that matches the kind of place it is.</li></ol><p>Places are read from the map data that has already been downloaded, so clicking one does not send anything to the internet.</p><p>Some things to keep in mind:</p><ul><li>Places with no name in the map data, such as benches or parking spaces, show no name and cannot be clicked. Clicking them does nothing, just like clicking an empty part of the map.</li><li>The map's own markers come first. If a marker covers a place, clicking it opens the note and not the place.</li><li>This does not work with the raster (OpenStreetMap) style, because its places are part of the map image. It also does not work with the <em>Neutrino</em> style, which draws no places.</li><li>In read-only mode you can still click a place and read it, but you cannot keep it as a marker.</li></ul><h2>How the location of the markers is stored</h2><p>The location of a marker is stored in the <code>#geolocation</code> attribute of the child notes:</p><p>This value can be added manually if needed. The value of the attribute is made up of the latitude and longitude separated by a comma.</p><p>On an image map, the position is stored in <code>#mapPosition</code> instead (see <a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>).</p><h2>Repositioning markers</h2><p>Once a marker is set, it can be repositioned using one of the two ways:</p><ul><li>By right clicking the marker and selecting <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>).</li><li>By clicking the marker to open the popup and selecting the <em>Move to another location</em> (<span class=\"tn-icon bx bx-move\"></span>) button underneath the title bar.</li></ul><p>After clicking the button to move the marker, click at the desired position on the map to replace it. To cancel the operation, press Escape.</p><aside class=\"admonition note\"><p>If the map is locked for editing (see below), the map needs to be unlocked before moving the marker.</p></aside><h2>Interaction with the markers, tracks or shapes</h2><ul><li>Hovering over a marker will display a <a class=\"reference-link\" href=\"#root/_help_lgKX7r3aL30x\">Note Tooltip</a> with the content of the note it belongs to.<ul><li>Clicking on the note title in the tooltip will navigate to the note in the current view.</li></ul></li><li>Right-clicking the marker will open a contextual menu (as described below).</li><li>Clicking a marker will focus on the marker and display a dedicated popup with the details. This works regardless of whether the map is editable or not.</li></ul><h3>Popup view</h3><p>When a marker, a <a href=\"#root/_help_C2H9HK4BzwG7\">shape</a>, or track is clicked, a popup will open to the right which contains the following information:</p><ul><li>The title and icon of the marker, both editable.</li><li>An indicator for the coordinates (<span class=\"tn-icon bx bx-crosshair\"></span>); clicking it will copy the coordinates to clipboard.</li><li>A <span class=\"tn-icon bx bx-expand-alt\"></span> button to maximize the popup.</li><li>Buttons to interact with the current item:<ul><li><span class=\"tn-icon bx bx-log-in\"></span> Open the marker in the same pane, or use <span class=\"tn-icon bx bx-dots-horizontal-rounded\"></span> to open it in a new tab, split, etc.</li><li>A <span class=\"tn-icon bx bx-map-alt\"></span> button to open the location in a dedicated application (e.g. Google Maps on mobile).</li><li><span class=\"tn-icon bx bx-palette\"></span> Color picker to change the color of the marker.</li><li><span class=\"tn-icon bx bx-move\"></span> Markers can also be moved, unlike tracks or shapes (which need to be redrawn).</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note.<ul><li>Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li><li>Similarly, removing a shape will remove its <code>#geoShape</code> attribute.</li></ul></li></ul></li><li>The <a class=\"reference-link\" href=\"#root/_help_OFXdgB2nNk1F\">Promoted Attributes</a> of the marker, if any.</li><li>The note's content which can be edited directly from the panel.</li></ul><p>To dismiss the popup:</p><ul><li>Press the X button at the top-right of the popup.</li><li>In the map, press anywhere outside the popup.</li><li>Or simply press the Escape key.</li></ul><p>When a marker is clicked, the map will automatically adjust the viewport so that the marker is still visible with the popup open. The currently selected marker is shown slightly bigger.</p><p>It is possible to switch between markers by clicking on them even when the popup view is already open.</p><p>Markers can have <a class=\"reference-link\" href=\"#root/_help_hrZ1D00cLbal\">Internal (reference) links</a> between them and clicking on such a link will automatically adjust the viewport and the popup view to the new note.</p><h3>Contextual menu</h3><p>It's possible to press the right mouse button to display a contextual menu.</p><ol><li>If right-clicking an empty section of the map (not on a marker), it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li><span class=\"tn-icon bx bx-pin\"></span> Adding a new marker at that location.</li></ol></li><li>If right-clicking on a marker, it allows to:<ol><li><span class=\"tn-icon bx bx-crosshair\"></span> Displays the latitude and longitude. Clicking this option will copy them to the clipboard.</li><li><span class=\"tn-icon bx bx-map-alt\"></span> Open the location using an external application (if the operating system supports it).</li><li>Open the note in a new tab, split or window.</li><li><span class=\"tn-icon bx bx-move\"></span> Move the marker to another location.</li><li><span class=\"tn-icon bx bx-trash\"></span> Button to remove the marker from the map, which can optionally delete its corresponding note. Removing a marker without deleting the note will only remove its <code>#geolocation</code> attribute (case in which the coordinates have to be manually added back in in order to get the note to show on the map again).</li></ol></li><li>Shapes can also be right-clicked and the menu is similar to markers except they cannot be moved.</li></ol><h3>Icon and color</h3><figure class=\"image image-style-align-right image_resized\" style=\"width:47.42%;\"><img style=\"aspect-ratio:885/321;\" src=\"{{helpAssets}}/User%20Guide/Collections/3_Geo%20Map_image.png\" width=\"885\" height=\"321\"></figure><p>The markers will have the same icon as the note.</p><p>It's possible to add a custom color to a marker by assigning them a <code>#color</code> attribute such as <code>#color=green</code>.</p><p>This also applies to tracks and <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</p><aside class=\"admonition note\"><p>The color as it will be displayed on the map might be slightly tinted in order to make the text or icon more legible.</p></aside><h3>Adding the coordinates manually</h3><p>Searching for the place is usually quicker (see <em>Searching the map</em> above). The steps below remain useful for a coordinate that is already to hand, or for a place the search cannot find.</p><p>In a nutshell, create a child note and set the <code>#geolocation</code> attribute to the coordinates.</p><p>The value of the attribute is made up of the latitude and longitude separated by a comma.</p><h4>Adding from Google Maps</h4><ol><li>In Google Maps, on the web:<ol><li>Look for a desired location, right click on it and a context menu will show up.</li><li>Simply click on the first item displaying the coordinates and they will be copied to clipboard.</li></ol></li><li>In Trilium, create a child note under the map.</li><li>Then paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map (don't forget to surround the value with a <code>\"</code> character).</li></ol><h4>Adding from OpenStreetMap</h4><p>Similarly to the Google Maps approach:</p><ol><li>Go to any location on openstreetmap.org and right click to bring up the context menu. Select the <em>Show address</em> item.</li><li>The address will be visible in the top-left of the screen, in the place of the search bar. Select the coordinates and copy them into the clipboard.</li><li>Simply paste the value inside the text box into the <code>#geolocation</code> attribute of a child note of the map and then it should be displayed on the map.</li></ol><h2>Drawing shapes on the map</h2><p>See the dedicated <a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a> page.</p><h2>Using an image instead of the world map</h2><p>A geo map can be drawn over an image of your own, such as a floor plan or a fantasy map, with markers placed in the image's pixels. See <a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><h2>Adding GPS tracks (.gpx)</h2><figure class=\"image\"><img style=\"aspect-ratio:1566/1155;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Geo%20Map_image.png\" width=\"1566\" height=\"1155\"></figure><p>Trilium can display GPS tracks on the geo map, in the form of <code>.gpx</code> files.</p><p>To add a track, either:</p><ol><li>Drag & drop a <code>.gpx</code> file inside the geo map in the note tree.<ol><li>In order for the file to be recognized as a GPS track, it needs to show up as <code>application/gpx+xml</code> in the <em>File type</em> field.</li></ol></li><li>Press the <em>Add a GPS track from a GPX file</em> (<span class=\"tn-icon bx bx-trip\"></span>) button which will directly prompt for a GPX file and import it as a subnote of the collection.</li></ol><p>When going back to the map, the track should now be visible.</p><p>The starting point of the track will be displayed as a marker, with the name of the note underneath. The start marker will also respect the icon and the <code>color</code> of the note. The end marker is displayed with a distinct icon.</p><p>If the track file contains multiple tracks, they will all be displayed as well as markers. Trilium will also split a single track that happens to have non-continuous points.</p><p>If the GPX contains waypoints, they will also be displayed, including their names.</p><p>When the track is clicked, the entire route is brought into view, as well as the right popup will indicate details about the track such as distance, duration and the elevation map. This information is also displayed when clicking the <code>.gpx</code> note itself.</p><p>When clicking on the markers of a track (whether it's the start or stop builtin markers, or custom markers that are part of the track), only that marker is brought into view, as opposed to the entire route.</p><h2>Read-only mode</h2><p>When a map is <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> all editing features will be disabled such as:</p><ul><li>The <em>Add marker</em> (<span class=\"tn-icon bx bx-pin\"></span>) button at the bottom of the map.</li><li>Repositioning markers.</li><li>Editing from the contextual menu (removing locations or adding new items).</li><li>Keeping a place as a marker, whether you found it by searching or clicked it on the map. You can still search and click, and you can still look at a place and copy its coordinates.</li><li>Drawing <a href=\"#root/_help_C2H9HK4BzwG7\">shapes</a>.</li><li>The <em>Geo map properties</em> dialog; its entry is hidden from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li></ul><p>To set a map as read-only, go to <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> → <em>Editable</em> → <em>Read-only</em>.</p><h2>Configuration</h2><h3>Map Style</h3><p>The styling of the map can be adjusted in the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, under <em>Background</em> in the <em>Geo map properties</em> dialog, or manually via the <code>#map:style</code> attribute.</p><p>The geo map comes with two different types of styles:</p><ul><li>Raster styles<ul><li>For these styles the map is represented as a grid of images at different zoom levels. This is the traditional way OpenStreetMap used to work.</li><li>Zoom is slightly restricted.</li><li>Currently, the only raster theme is the original OpenStreetMap style.</li></ul></li><li>Vector styles<ul><li>Vector styles are not represented as images, but as geometrical shapes. This makes the rendering much smoother, especially when zooming and looking at the building edges, for example.</li><li>The map can be zoomed in much further.</li><li>These come in various styles that are both light (Colorful, Graybeard, Neutrino) and dark (Eclipse, Shadow).</li><li>The vector styles come from <a href=\"https://versatiles.org/\">VersaTiles</a>, a free and open-source project providing map tiles based on OpenStreetMap.</li><li>The VersaTiles layers also provide 3D building information (see below).</li></ul></li></ul><p>The default theme is Versatiles Colorful (vector).</p><h4>3D view with buildings</h4><figure class=\"image\"><img style=\"aspect-ratio:2727/1642;\" src=\"{{helpAssets}}/User%20Guide/Collections/2_Geo%20Map_image.png\" width=\"2727\" height=\"1642\"></figure><p>Trilium v0.105.0 introduces a 3D view, courtesy of MapLibre GL. To enter 3D mode, simply press the <em>3D</em> button at the bottom-right of the map or press Ctrl and drag across the map.</p><p>The buildings will only appear from zoom 14 onwards to avoid lag.</p><aside class=\"admonition note\"><p>To get 3D buildings, make sure you are using the <em>VersaTiles</em> styles which provide the building informatia via the <code>versatiles-shortbread</code> source.</p></aside><h3>Custom map style / tiles</h3><p>Starting with v0.102.0 it is possible to use custom tile sets, but only in raster format.</p><p>To use one:</p><ol><li>Open the <em>Geo map properties</em> dialog from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom tileset</em>.</li><li>In <em>Tile URL</em>, enter the address of the tile set, with <code>{z}</code>, <code>{x}</code> and <code>{y}</code> where the zoom level and the position of the tile go. For example, to use Esri.NatGeoWorldMap, enter <a href=\"https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/%7Bz%7D/%7By%7D/%7Bx%7D\"><code>https://server.arcgisonline.com/ArcGIS/rest/services/NatGeo_World_Map/MapServer/tile/{z}/{y}/{x}</code></a>. The URL is saved once you leave the field; a URL that doesn't start with <code>http://</code> or <code>https://</code>, or that lacks one of the three placeholders, is not saved. A map drawn over an image keeps its image until a URL is saved.</li><li>If the tiles are dark, turn on <em>Dark tileset</em>, which draws the marker titles in a light color so that they remain readable.</li></ol><p>Additionally:</p><ul><li>Hi-DPI tiles are supported via the <code>{r}</code> placeholder.</li><li>Servers that number their tiles by quadkey are supported via the <code>{quadkey}</code> placeholder, in place of <code>{z}</code>, <code>{x}</code> and <code>{y}</code>.</li></ul><p>To go back to a built-in style, set <em>Type</em> back to <em>Vector & Raster</em>. The tile set is switched off rather than removed: its label is renamed to <code>#disabled:map:style</code>, so setting <em>Type</em> to <em>Custom tileset</em> again brings back the same URL. A tile set inherited from a parent note or a template is overridden by the default style instead.</p><p>The tile set can also be set manually: the URL goes in the <code>#map:style</code> <a href=\"#root/_help_HI6GBBIduIgv\">label</a>, and the <code>#map:darkStyle</code> label marks it as dark. <code>#map:darkStyle</code> also overrides the built-in styles.</p><aside class=\"admonition note\"><p>For a list of tile sets, see the <a href=\"https://leaflet-extras.github.io/leaflet-providers/preview/\">Leaflet Providers preview</a> page. Select a desired tile set and just copy the URL from the <em>Plain JavaScript</em> example.</p></aside><p>Custom vector map support is planned, but not yet implemented.</p><h3>Other options</h3><p>The following options can be configured either via the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>, by clicking on the settings (<span class=\"tn-icon bx bx-cog\"></span>) button. Alternatively, each of these options also have a corresponding <a href=\"#root/_help_HI6GBBIduIgv\">label</a> that can be set manually.</p><ul><li>Scale, which illustrates the scale of the map in either kilometers or miles in the bottom-left of the map.<ul><li>The unit is determined by the <em>Formatting locale</em> option in <em>Language & Region</em>.</li></ul></li><li>The name of the markers is displayed by default underneath the pin on the map. Since v0.102.0, it is possible to hide these labels which increases the performance and decreases clutter when there are many markers on the map.</li><li>v0.105.0 also introduces a feature called <em>Group nearby markers</em> which will cluster multiple markers together at low zoom.<ul><li>The clusters display the number of items they contain. The color also changes based on the count.</li><li>Clicking on a cluster will automatically zoom in so that the individual markers that make up the cluster are now visible.</li></ul></li></ul><p>The same options are also listed under <em>General</em> in the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog, opened from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>. Its <em>Included notes</em> section sets whether archived notes are shown and the <em>Maximum nesting depth</em> (see below), and its <em>Background</em> section holds the map style, the URL of a custom tile set when <em>Type</em> is set to <em>Custom tileset</em> (see above), or, with <em>Type</em> set to <em>Custom image</em>, draws the map over an image of your own instead, as described in <a class=\"reference-link\" href=\"#root/_help_ZRDXGc0nAIh4\">Image maps</a>.</p><p>The map shows the notes of its whole subtree, not only its children. <em>Maximum nesting depth</em> (<code>#maxNestingDepth</code>) limits how deep below the map it looks: <code>0</code> shows only the children, <code>1</code> adds their children, and so on. Without a value, every level is shown.</p>",
"_help_C2H9HK4BzwG7": "<p>The following shapes can be drawn on the map: a path, an area, a rectangle or a circle.</p><p>Unlike markers, the title of the shape is not displayed directly on the map but it will be displayed when hovered.</p><p>The shape will also be drawn in the <a href=\"#root/_help_p9kXRFAkwN4o\">color of the note</a>, if set. </p><h2>Drawing a shape on the map</h2><p>To draw a shape, use the toolbar that appears in the top-center area on desktop and on the left-center on mobile and in split view.</p><p>Once a shape is drawn, it cannot be moved or modified. To do so, simply remove the shape and draw another one instead.</p><h3>Drawing a path or an area</h3><ol><li>Press the <em>Draw a path on the map</em> (<span class=\"tn-icon bx bx-vector\"></span>) or <em>Draw an area on the map</em> (<span class=\"tn-icon bx bx-shape-polygon\"></span>) button. The button stays held down while the tool is armed, and a notification describes what to do.</li><li>Click on the map once for each point. The shape is previewed as it grows.</li><li>Finish it by pressing <kbd>Enter</kbd>. A path can also be finished by clicking its last point again, and an area by clicking the corner it started from. A path needs at least two points and an area at least three.</li></ol><h3>Drawing a rectangle or a circle</h3><ol><li>Press the <em>Draw a rectangle on the map</em> (<span class=\"tn-icon bx bx-shape-square\"></span>) or <em>Draw a circle on the map</em> (<span class=\"tn-icon bx bx-shape-circle\"></span>) button.</li><li>Click once to set the first corner, or the center of the circle. Click a second time at the opposite corner, or at the distance the circle should reach.</li><li>Instead of two clicks you can drag from one to the other. This also works on mobile and other touch-based apps.</li></ol><h3>Finishing and cancelling</h3><p>To give up on a shape while drawing it, press <kbd>Escape</kbd> or press the tool's button again. Whatever has been drawn so far is discarded.</p><p>The tool is deactivated once a shape is finished, so drawing a second shape requires another button press.</p><h2>Interaction</h2><p>Once a shape is created:</p><ul><li>Clicking a shape opens the standard panel which allows changing the title, the content and with buttons to open the note or remove it.<ul><li>When clicking, a marker takes priority over the shape.</li></ul></li><li>Right-clicking a shape opens a contextual menu similar to the one for markers, which allows opening the corresponding note or removing the shape.</li><li>Typing in the map's search bar finds shapes by their title, as it does markers. Selecting one brings the whole shape into view.</li></ul><h2>How shapes are represented</h2><p>Shapes are represented quite similarly to markers, which means each shape is a note. The information about the same is stored using a <a href=\"#root/_help_HI6GBBIduIgv\">label</a> called <code>geoShape</code>.</p>",
"_help_ZRDXGc0nAIh4": "<p>An image map is a geo map drawn over an image of your own instead of a world map, such as a floor plan, a fantasy map for a tabletop game, or a diagram to annotate. Markers and shapes work as they do on a geo map, but their positions are measured on the image instead of in latitude and longitude: in the image's own pixels, or in a coordinate system of your choosing, such as the one a video game uses.</p><h2>Creating an image map</h2><ol><li>Upload the image as a note of its own, for example by dragging the file into the note tree. PNG, JPEG, WebP and GIF images are supported; SVG images are not.</li><li>Create a geo map, or open an existing one.</li><li>Open the <span class=\"tn-icon bx bx-cog\"></span><em>Geo map properties</em> dialog from the <a class=\"reference-link\" href=\"#root/_help_8YBEPzcpUgxw\">Note menu</a> or from the settings menu of the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a>.</li><li>Under <em>Background</em>, set <em>Type</em> to <em>Custom image</em>, then choose the image note in <em>Image note</em>. The list only offers image notes in a format the map can draw (PNG, JPEG, WebP or GIF), and shows all of them before anything is typed.</li></ol><p>The map then shows the image instead of the world map and opens with the whole image in view. To go back to a world map, set <em>Type</em> back to <em>Vector & Raster</em>. The image is switched off rather than removed: its relation is renamed to <code>~disabled:map:image</code>, so setting <em>Type</em> to <em>Custom image</em> again brings back the same image, with its coordinates. An image that the geo map inherits from a parent note or a template can only be switched off on the note that holds it.</p><p>The image note is stored in a <code>~map:image</code> <a href=\"#root/_help_Cq5X6iKQop6R\">relation</a> of the geo map, which can also be added by hand.</p><h2>Image size</h2><p>Images are resized when they are uploaded, so by default the image of a map is at most 2000 pixels on its longer side, which can be too coarse for a detailed map. To keep an image at a higher resolution, do one of the following before uploading it:</p><ul><li>In <a class=\"reference-link\" href=\"#root/_help_4TIF1oA4VQRO\">Options</a> → <em>Media</em>, raise <em>Max image dimensions</em> or turn off <em>Automatically compress images</em>.</li><li>Upload it through the <em>Import</em> dialog with <em>Compress images</em> unchecked.</li></ul><p>An image that was already uploaded keeps its size; upload it again after changing the settings.</p><p>The image is drawn as a single picture by the graphics card, which limits how large it can be. Images up to 4096 pixels on their longer side are safe on practically every device, and most computers handle up to 16384 pixels. On a device whose graphics card cannot hold the image, the markers and shapes still appear but the image itself does not. The <em>Geo map properties</em> dialog warns about an image larger than 4096 pixels, and about one that can't be used at all, such as an SVG image.</p><h2>Interaction</h2><p>Adding, moving and removing markers, drawing shapes, the popup view and the contextual menu work as described for the <a class=\"reference-link\" href=\"#root/_help_81SGnPGMk7Xc\">Geo Map</a>. The camera stays over the image and can zoom in up to four times past the image's own resolution.</p><p>The features that only make sense on a real map are not available on an image map:</p><ul><li>Searching the map and searching for places online.</li><li>Going to your location.</li><li>Adding GPS tracks.</li><li>Clicking the places the base map shows.</li><li>The 3D buildings.</li><li>Opening a location in an external map application.</li></ul><p>The look of the marker titles follows the image: if the image is dark, turn on <em>Dark image</em> under <em>Background</em> in the <em>Geo map properties</em> dialog, so that the titles are drawn in a light color. This sets the <code>#map:darkStyle</code> label.</p><p>The <em>Map style</em> setting doesn't apply to an image map, so it's hidden from the settings menu of the collection while the map has an image.</p><h2>Choosing the coordinate system</h2><p>By default, positions are measured in pixels of the image at its original size, from its top-left corner, with <code>x</code> growing to the right and <code>y</code> growing downwards.</p><p>To use coordinates of your own instead, open the <em>Geo map properties</em> dialog, set <em>Coordinates</em> under <em>Background</em> to <em>Custom</em>, and enter the coordinates of the image's <em>Top-left corner</em> and <em>Bottom-right corner</em>. Switching to <em>Custom</em> starts from the image's size in pixels, so the markers stay where they are until the corners are changed; for that reason, <em>Custom</em> can only be chosen once the image has loaded. All positions are then read and written in those coordinates, including the ones shown in the contextual menu and in the popup view. To go back to pixels, set <em>Coordinates</em> to <em>Image pixels</em>. Corners that the geo map inherits from a parent note or a template can only be removed on the note that holds them; entering other corners on this map overrides them.</p><p>The corners are stored in the <code>#map:imageBounds</code> label of the geo map as <code>x,y x,y</code>, with a space between the two corners, which can also be set by hand. For example:</p><ul><li>A screenshot of a game map that covers <code>x</code> from -512 to 512 and <code>y</code> from -512 to 512, with <code>y</code> growing downwards: <code>#map:imageBounds=-512,-512 512,512</code>. Coordinates copied from the game can then be pasted directly into <code>#mapPosition</code>.</li><li>A world whose <code>y</code> grows upwards, with the origin in the middle of the image: <code>#map:imageBounds=-2000,1000 2000,-1000</code>. A top-left <code>y</code> larger than the bottom-right one is what flips the axis.</li><li>A floor plan measured in meters: <code>#map:imageBounds=0,0 24,12</code>.</li></ul><p>The two axes don't have to use the same scale. A circle is always measured in the map's own units, so it appears as an ellipse when the units are stretched differently along the two axes.</p><p>Corners that share an <code>x</code> or a <code>y</code> don't span an area: the dialog doesn't save them, and a label holding them, or a value that cannot be read, is ignored and the pixels of the image are used instead.</p><h2>Coordinate rulers</h2><p>Enabling <em>Show scale</em> in the collection properties draws rulers along the edges of the image instead of a distance scale. Round values of the map's coordinates are marked with ticks along all four edges, labeled along the top and left ones, with faint grid lines across the image. The spacing follows the zoom level, and the values follow <code>#map:imageBounds</code> when it is set.</p><p>The rulers are drawn on the image itself, so they move out of view along with its edges when zooming in. The grid lines remain visible across the image.</p><h2>How the positions are stored</h2><p>Because positions are stored in different labels from the ones of a geo map, the same note can be placed both on a geo map and on an image map.</p><figure class=\"table\"><table><thead><tr><th>Label</th><th>Content</th></tr></thead><tbody><tr><td><code>#mapPosition</code></td><td>The position of a marker, as <code>x,y</code>, for example <code>#mapPosition=320,145</code>.</td></tr><tr><td><code>#mapShape</code></td><td>A shape, in the same format as <code>#geoShape</code> (see <a class=\"reference-link\" href=\"#root/_help_C2H9HK4BzwG7\">Drawing shapes</a>) but with <code>x,y</code> pairs, and a circle's radius in the map's units, for example <code>#mapShape=circle:400,300 50</code>.</td></tr></tbody></table></figure><p>The positions belong to the coordinate system, not to the image. When replacing the image with a different one, for example a higher-resolution copy, keep <code>#map:imageBounds</code> describing the area the new image covers and every marker stays in place. With <em>Image pixels</em>, the positions are pixels, so an image of a different size moves the markers relative to what the image shows; to avoid that, switch <em>Coordinates</em> to <em>Custom</em> before replacing the image, which keeps the size of the old one (<code>0,0 <width>,<height></code>) as the corners.</p><aside class=\"admonition tip\"><p>To draw freely over an image instead of placing notes on it, consider a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a>.</p></aside>",
"_help_zP3PMqaG71Ct": "<figure class=\"image\"><img style=\"aspect-ratio:1120/763;\" src=\"{{helpAssets}}/User%20Guide/Collections/Presentation_image.png\" width=\"1120\" height=\"763\"></figure><p>The Presentation view allows the creation of slideshows directly from within Trilium.</p><h3>Creating a new presentation</h3><p>Right click on an existing note in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> and select <em>Insert child note</em> → <em>Collection</em> → <em>Presentation</em>.</p><p>A presentation without slides shows, in place of the slides and the slide sidebar, a <span class=\"tn-icon bx bx-plus\"></span> <em>New slide</em> button that creates the first slide and starts editing it. The arrow beside it creates a slide of another type instead, as described below. A read-only presentation shows only a message that it has no slides. Until there is a slide, the <em>Slide sidebar</em> button is disabled and the controls below the slides are not shown.</p><h2>How it works</h2><ul><li>Each slide is a child note of the collection.</li><li>The slides are not shown in the <a class=\"reference-link\" href=\"#root/_help_oPVyFC7WL2Lp\">Note Tree</a> by default, since the slide sidebar already lists them (see <a class=\"reference-link\" href=\"#root/_help_wyaGBBQrl4i3\">Hiding the subtree</a>). To show them, open the collection's <span class=\"tn-icon bx bx-cog\"></span> settings and turn off <em>Hide child notes in tree</em>.</li><li>The order of the child notes determines the order of the slides.</li><li>Unlike traditional presentation software, slides can be laid out both horizontally and vertically (see below for more information).</li><li>Direct children will be laid out horizontally and the children of those will be laid out vertically. Children deeper than two levels of nesting are ignored.</li><li>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> collection is shown as one slide, working as it does in the note itself, so its children are not laid out as vertical slides. Other collections keep their children as vertical slides.</li><li>Slides have a fixed 16:9 shape (1280×720). The preview in the note is a scaled-down copy of what is shown in full-screen, so content that fits in the preview fits when presenting. When the window or the screen has a different shape, the slide is centered with bars around it.</li><li>A slide whose content is larger than the slide is zoomed out until it fits, text included. To keep the text large, split the content over several slides.</li></ul><h2>Interaction and navigation</h2><h3>Slide sidebar</h3><p>A sidebar to the left of the slides shows a thumbnail of every slide in the presentation's theme, with vertical slides indented under the slide they belong to. Web view, <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slides are shown as an icon.</p><ul><li>The slide being shown is outlined, and the sidebar scrolls to keep it in view.</li><li>Click a thumbnail to go to its slide.</li><li>To move a slide, drag its thumbnail; a line shows where it goes. Dragged straight up or down, a slide keeps its level:<ul><li>A top-level slide takes its vertical slides with it, and dragged over another slide's vertical slides it goes after that whole stack.</li><li>A vertical slide can go among the vertical slides of any slide. Dropped below a slide that has none, it becomes that slide's first vertical slide, and the line is indented.</li></ul></li><li>To change a slide's level, drag it to the side as well: to the right to make it a vertical slide, to the left to make it a top-level slide. The line's indent shows the level it will have.<ul><li>A slide that has vertical slides of its own can't become a vertical slide, and a <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slide can't take vertical slides.</li></ul></li><li>Slides can't be dragged in a read-only or search-based presentation, or into a note that sorts its children with <code>#sorted</code>.</li><li>Once a thumbnail is clicked, or reached with <kbd>Tab</kbd>, the sidebar takes the keyboard until you click the slides:<ul><li>Press <kbd>↑</kbd> and <kbd>↓</kbd> to go to the previous or next slide in order, vertical slides included.</li><li>Press <kbd>Home</kbd> and <kbd>End</kbd> to go to the first or last slide.</li><li>Press <kbd>Alt</kbd>+<kbd>↑</kbd> and <kbd>Alt</kbd>+<kbd>↓</kbd> to move the slide up or down at its level, past a whole stack of vertical slides. Press <kbd>Alt</kbd>+<kbd>→</kbd> to make it a vertical slide where it stands, and <kbd>Alt</kbd>+<kbd>←</kbd> to make it a top-level slide (the other way around in right-to-left languages). The same limits apply as for dragging.</li></ul></li><li>Right-click a thumbnail, or press <kbd>Shift</kbd>+<kbd>F10</kbd> or the <kbd>Menu</kbd> key on a focused one, to open its context menu. The thumbnail is outlined while the menu is open, and the slide being shown doesn't change:<ul><li><em>Edit slide</em> goes to the slide and edits it in place, as a double-click does. It's available for text, <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slides.</li><li><em>Open note</em> opens the slide's note in a new tab, split or window.</li><li><em>New slide after</em> adds an empty slide after it, at its level, and <em>New vertical slide</em> adds one at the end of its vertical slides. Each asks for the type of the slide, from the same list as the arrow beside the <em>New slide</em> button. The presentation goes to the new slide. <em>Duplicate</em> copies the slide, with its vertical slides, right after it.</li><li><em>Move up</em>, <em>Move down</em>, <em>Make vertical slide</em> and <em>Make top-level slide</em> move the slide as <kbd>Alt</kbd> and the arrow keys do. An item is disabled where the slide can't go.</li><li><em>Delete slide...</em> deletes the slide, with its vertical slides, after asking for confirmation.</li><li>A read-only presentation offers only <em>Open note</em>. A search-based presentation can't add, move or delete slides.</li></ul></li><li>To collapse the sidebar, press the <span class=\"tn-icon bx bx-sidebar\"></span> <em>Slide sidebar</em> button on the left of the toolbar above the slides, after the collection's settings. Press it again to bring the sidebar back. Each device remembers the choice for every presentation.</li><li>The sidebar is hidden when the note is too narrow to fit it.</li></ul><h3>Controls below the slides</h3><p>Below the slides are three groups of buttons.</p><h4>Moving between slides</h4><p>On the left, the <span class=\"tn-icon bx bx-chevron-left\"></span> <em>Previous slide</em> and <span class=\"tn-icon bx bx-chevron-right\"></span> <em>Next slide</em> buttons go through every slide in order, vertical slides included, as <kbd>Shift</kbd>+<kbd>Space</kbd> and <kbd>Space</kbd> do. Between them is the number of the slide being shown, out of the number of slides.</p><p>A presentation opens on the slide it showed last, also on another device after a sync, unless that slide was deleted. A read-only presentation doesn't remember its slide and opens on the one that was saved, or on the first.</p><h4>Editing</h4><p>In the middle:</p><ul><li><p><span class=\"tn-icon bx bx-plus\"></span> <em>New slide</em> button to add an empty text slide after the slide being shown, at the same level: after a slide and its vertical slides, or among the vertical slides. The presentation goes to the new slide and starts editing it in place. The <span class=\"tn-icon bx bx-chevron-down\"></span> arrow beside it adds a slide of another type instead:</p><ul><li><em>Text</em> and <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> come first, as the slides that can be edited in place; the presentation starts editing the new slide.</li><li><a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> and <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> create a collection, from the same template as a new one elsewhere, which the presentation also starts editing.</li><li><a class=\"reference-link\" href=\"#root/_help_s1aBHPd79XYj\">Mermaid Diagrams</a> create a diagram and open it in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> to write it. The slide shows the diagram once it is saved, and the <span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button opens it in Quick edit again.</li><li><a class=\"reference-link\" href=\"#root/_help_6f9hih2hXXZk\">Code</a> opens a list of the code languages enabled in the code note options, as the app's other note type menus do, ending with <em>Configure code notes...</em> to change which ones it offers. The new note opens in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> to write the code, as a Mermaid diagram does.</li><li><em>Web View</em> and <em>Spreadsheet</em> create an empty note of that type. Its content is added in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a>, with the <span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button.</li></ul><p>A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation doesn't show it, and neither does one made from a search.</p></li><li><p><span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button to edit the current slide: in place for a text, canvas, Kanban Board or Table slide, as a double-click does, and in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> for a slide of any other type, or where the slide can't be edited in place. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation doesn't show it. While a slide is edited in place, the button becomes the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button.</p></li><li><p><span class=\"tn-icon bx bx-palette\"></span> <em>Slide background</em> button to pick the background color of the current slide, or to clear it so the slide uses the theme's background. It is unavailable for web view, Kanban Board and Table slides, which cover the whole slide, and a read-only presentation doesn't show it. A gradient can still be set through the <code>#slide:background</code> label.</p></li></ul><h4>Viewing</h4><p>On the right:</p><ul><li>Press the <span class=\"tn-icon bx bx-grid-horizontal\"></span> Overview button (or the <kbd>O</kbd> key) to show a birds-eye view of the slides. Press the button again to disable it.</li><li>Press the <span class=\"tn-icon bx bx-fullscreen\"></span> <em>Start presentation</em> button (or the <kbd>F</kbd> key) to show the presentation in full-screen. Press <kbd>Esc</kbd> or the <span class=\"tn-icon bx bx-exit-fullscreen\"></span> <em>Exit fullscreen</em> button to leave it.</li></ul><p>In full-screen, the editing buttons are hidden, and the other two groups fade out while the mouse rests. Move the mouse to bring it back.</p><h3>Keyboard shortcuts</h3><p>The following keyboard shortcuts work while the presentation is the active note: after clicking the slides or the sidebar, and in full-screen. Keys pressed in another split, the note tree or a field go there instead.</p><ul><li>Press <kbd>←</kbd> and <kbd>→</kbd> (or <kbd>H</kbd> and <kbd>L</kbd>) to go to the slide on the left or on the right (horizontal).</li><li>Press <kbd>↑</kbd> and <kbd>↓</kbd> (or <kbd>K</kbd> and <kbd>J</kbd>) to go to the upward or downward slide (vertical).</li><li>Press <kbd>Space</kbd> and <kbd>Shift</kbd>+<kbd>Space</kbd> to go to the next/previous slide in order.</li><li>Press <kbd>F</kbd> to start the presentation in full-screen.</li><li>And a few more, press <kbd>?</kbd> to display a popup with all the supported keyboard combinations.</li></ul><h2>Editing a slide in place</h2><p>Double-click a slide made from a text note to edit it directly on the slide, in the presentation's theme. A dashed outline marks the slide being edited, and the formatting toolbar appears next to the selected text. Changes are saved as you type, as in any text note, and a slide that grows past the edge of the slide is zoomed out to fit.</p><p>To finish editing, press <kbd>Esc</kbd>, press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button below the slides or go to another slide. Starting the presentation in full-screen also finishes editing, and slides can't be edited in full-screen.</p><p>A <a class=\"reference-link\" href=\"#root/_help_CtBQqbwXDx1w\">Kanban Board</a> or <a class=\"reference-link\" href=\"#root/_help_2FvYrpmOXm29\">Table</a> slide is read-only until it is edited, so that a card or a cell can't be changed by accident while presenting, and clicking a card or a row opens nothing. Double-click it to edit it on the slide as in its note, then press the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button or go to another slide to finish. The bar above the collection has no view type switcher on a slide, and shows the <span class=\"tn-icon bx bx-cog\"></span> settings only while the slide is edited.</p><p>Double-click a <a class=\"reference-link\" href=\"#root/_help_grjYqerjn243\">Canvas</a> slide to draw on it in place. The canvas editor covers the presentation, with the same tools as in the canvas note, and opens on the drawing at the size and place that the slide shows it. The drawing is saved as you go. Press <kbd>Esc</kbd> or the <span class=\"tn-icon bx bx-check\"></span> <em>Finish editing</em> button to finish.</p><p>Slides of other note types, such as diagrams, open in <a class=\"reference-link\" href=\"#root/_help_ZjLYv08Rp3qC\">Quick edit</a> from the <span class=\"tn-icon bx bx-edit\"></span> <em>Edit this slide</em> button. A <a href=\"#root/_help_CoFPLs3dRlXc\">read-only</a> presentation can't be edited in place, and neither can a slide whose own note is read-only.</p><h2>Vertical slides and nesting</h2><p>Unlike traditional presentation software such as Microsoft PowerPoint, the slides in Trilium can be laid out horizontally or vertically in order to create depth or better organize the slides by topic.</p><p>This horizontal/vertical organization affects transitions (especially on the “slide” transition), however it is most noticeable in navigation.</p><ul><li>Pressing <kbd>←</kbd> and <kbd>→</kbd> will navigate through slides horizontally, thus skipping vertical notes under the current slide. This is useful to skip entire chapters/related slides.</li><li>Pressing <kbd>↑</kbd> and <kbd>↓</kbd> will navigate through the vertical slides at the current level.</li><li>Pressing <kbd>Space</kbd> and <kbd>Shift</kbd> + <kbd>Space</kbd> will go to the next/previous slide in order, regardless of the direction. This is generally the key combination to use when presenting.</li><li>The <em>Previous slide</em> and <em>Next slide</em> buttons below the slides go in order, as <kbd>Space</kbd> and <kbd>Shift</kbd>+<kbd>Space</kbd> do.</li></ul><figure class=\"image image-style-align-right image_resized\" style=\"width:55.57%;\"><img style=\"aspect-ratio:890/569;\" src=\"{{helpAssets}}/User%20Guide/Collections/1_Presentation_image.png\" width=\"890\" height=\"569\"></figure><p>All direct children of the collection will be laid out horizontally. If a direct child also has children, those children will be placed as vertical slides.</p><p>In the following example, the note structure is as follows:</p><ul><li>Presentation collection<ul><li>Trilium Notes (demo page)</li><li>“Introduction” slide<ul><li>“The challenge of personal knowledge management”</li><li>“Note-taking structures”</li></ul></li><li>“Demo & Feature highlights” slide<ul><li>“Really fast installation process”</li><li>Video slide</li></ul></li></ul></li></ul><h2>Customization</h2><p>At collection level, it's possible to adjust:</p><ul><li>The theme of the entire presentation to one of the predefined themes by going to the <a class=\"reference-link\" href=\"#root/_help_CssoWBu8I7jF\">Collection Properties</a> and looking for the <em>Theme</em> option.</li><li>It's currently not possible to create custom themes, although it is planned.</li><li>Note that it is note possible to alter the CSS via <a class=\"reference-link\" href=\"#root/_help_AlhDUqhENtH7\">Custom app-wide CSS</a> because the slides are rendered isolated (in a shadow DOM).</li></ul><p>At slide level:</p><ul><li>To change the background color of a slide, go to it and use the <span class=\"tn-icon bx bx-palette\"></span> <em>Slide background</em> button in the toolbar, or set <code>#slide:background</code> on its note to a hex color.</li><li>More cFile truncated at 1 MB.