Trilium Notes for VS Code

Browse, search, and edit your Trilium Notes directly inside VS Code using the ETAPI REST API.

Welcome

This extension is built for people who already live in VS Code and want their Trilium Notes workflow in the same place.

Use it to:

• Browse your full Trilium note tree in the sidebar.
• Edit text notes in a rich CKEditor-powered WYSIWYG editor.
• Edit Mermaid diagrams in a built-in WYSIWYG editor with live preview, auto-save, breadcrumbs, and optional raw .mmd source access.
• Edit Excalidraw canvas notes in a built-in local editor with auto-save, breadcrumbs, and optional raw .excalidraw JSON access.
• Open mind-map notes in an interactive MindElixir editor with a theme-aware node-menu, breadcrumbs, and optional raw JSON access.
• Search notes quickly, manage attributes and attachments, and review revisions.
• Resolve upstream edit conflicts with a built-in compare flow (Theirs vs Ours).
• Clone, move, and export notes without leaving VS Code.

If you want a fast setup, you can be connected in about a minute.

Quick Start

1. Install the extension.
2. Open the Trilium Notes view in the Activity Bar.
3. Run Trilium: Connect to Trilium Server.
4. Enter your server URL and ETAPI token.
5. Open a note and start editing.

Why It Feels Native

• Keyboard-first workflows using normal VS Code commands and save behavior.
• Text-note editing now keeps native unsaved-close protection, so unresolved changes are not silently lost.
• Mermaid, Canvas, and Mind Map notes open in native built-in editors instead of depending on third-party VS Code preview extensions.
• Shared breadcrumb, reveal-in-tree, and open-parent actions make special note types behave more like normal editor tabs.
• Theme-aware editor styling so notes blend with your current color theme.
• Secure token storage through VS Code secret storage.
• Deep command coverage for daily note management.

Read Next

• New here: start with Getting Started
• Want capabilities overview: Features
• Looking for commands and settings: Reference
• Using Copilot or scripts: Automation
• Curious what is planned: Roadmap
• Attribution and license details: Credits

Documentation

• Getting Started
• Features
• Reference
• Automation
• Roadmap
• Credits

Screenshot Gallery

Note tree: Browse notes with type icons and visual cues.	Attributes sidebar: Edit labels, relations, and attachments inline.
WYSIWYG editor: Edit Trilium text notes with rich formatting.	Search: Jump to notes quickly with live results.
Revisions and diff: Open previous revisions and compare changes safely.

Requirements

• VS Code 1.118 or later
• Desktop VS Code (not web/Codespaces)
• A reachable Trilium Notes server with ETAPI enabled

Community and Feedback

Issues, bug reports, and feature ideas are welcome in this repository. If something feels clunky in daily use, open an issue and describe your workflow.

License

GNU Affero General Public License v3.0 or later. See LICENSE.