Trilium WP is a WordPress plugin developed by SatoshiWP, currently in closed beta. This article is a comprehensive overview of what Trilium WP can do for you.
I. A Bridge Between Two Worlds
In an age of information overload, effective knowledge management has never been more critical. Trilium Notes, a powerful open-source personal knowledge management tool, has earned a loyal following among knowledge workers for its flexible hierarchical note structure and rich organizational capabilities. It offers a mind-map-like approach to organizing notes, enabling users to build complex yet orderly personal knowledge systems. However, all that valuable knowledge typically stays locked in a private environment — difficult to share with a wider audience.
WordPress, the world’s most popular content management system, excels at publishing and presenting content. Its plugin ecosystem and flexible theming make it suitable for virtually any content display need. Yet WordPress has its own limitations when it comes to deep knowledge organization — its content structure is relatively flat, making it hard to express complex knowledge hierarchies and interconnections.
💡 Trilium WP was born to bridge these two powerful systems. With this plugin, users can bring the carefully organized knowledge structures from Trilium Notes directly into WordPress — fully intact. It preserves Trilium’s deep organizational power while leveraging WordPress’s superior presentation and sharing capabilities, creating a 1 + 1 > 2 synergy.
II. Core Philosophy & Feature Overview
The core philosophy behind Trilium WP is “high-fidelity display” — faithfully preserving the structure, formatting, and relationships of notes from Trilium Notes while integrating them naturally into the WordPress interface. This fidelity goes beyond visual presentation; it’s about transmitting the integrity of the knowledge structure itself. Your knowledge system appears before readers exactly as you built it — no distortion, no oversimplification.
The plugin connects to a Trilium server via the ETAPI interface. ETAPI is Trilium’s extended API, which allows third-party applications to access Trilium data in a controlled manner. This approach ensures data security while enabling real-time content updates.
Trilium WP doesn’t just display individual notes — it builds complete knowledge base systems. It faithfully preserves hierarchical relationships between notes, internal links, and attribute labels — the core elements that form the skeleton of any knowledge system. Through this holistic presentation, readers can grasp the big picture of a knowledge structure rather than encountering isolated fragments of information.
📌 6 Shortcodes for Flexible Embedding
Trilium WP v1.6.2 offers 6 functional shortcodes that let users embed Trilium content into WordPress pages or posts with clean, intuitive syntax — easy enough for anyone to pick up, even with minimal WordPress experience:
| Shortcode | Description |
|---|---|
[trilium_note] | 📄 Display a single note |
[trilium_kb] | 📚 Build a full interactive knowledge base page |
[trilium_search] | 🔍 Embed Trilium search functionality |
[trilium_browser] | 🗂️ Browse the Trilium note tree |
[trilium_related_notes] | 🔗 Display a list of related notes |
[trilium_recent] | 🕐 Show recently updated notes |
For more advanced display needs, the plugin supports creating dedicated knowledge base pages that present fully structured content collections, offering readers an immersive knowledge exploration experience.
III. Intelligent Content Rendering System
Trilium WP employs a modular content processor system that delivers optimal display results based on note type. This “content-type-aware” design philosophy ensures that different types of knowledge content are rendered in the most appropriate way. Each content type has a dedicated processor responsible for parsing and rendering, resulting in output that is both polished and functional — the plugin currently supports rendering up to 16 note types.
📝 Text Notes
Full support for Markdown formatting, tables, and nested lists, preserving all formatting details including emphasis, block quotes, and heading hierarchies. Typography is carefully tuned — paragraph spacing, line height, font size, and other details are all optimized for comfortable long-form reading while maintaining visual harmony with the active WordPress theme.
💻 Code Notes
Code notes are a vital part of technical content sharing. Trilium WP provides professional syntax highlighting and formatting, recognizing different programming languages and applying the appropriate highlight rules. Code blocks are clean and minimal, with horizontal scrolling support to avoid unnecessary line wrapping for long lines. These details bring technical documentation display up to a professional standard.
🖼️ Image Notes
Images are an essential medium for knowledge presentation. Trilium WP displays images from Trilium through a secure proxy mechanism — ensuring proper rendering while protecting the Trilium server from direct exposure of internal resources. Image display is fully responsive, delivering a quality visual experience across devices.
📊 Special Types
The plugin also intelligently handles Trilium-specific note types such as relation maps and search notes. While these special types can’t fully replicate their interactive functionality in a web environment, the plugin preserves their informational value as much as possible, presenting core content through alternative approaches. This adaptive rendering ensures that all types of knowledge find an appropriate form of expression on the WordPress platform.
IV. Full-Featured Knowledge Base System
The knowledge base feature is a major highlight of Trilium WP. Through this feature, users can present a complete Trilium note structure as a fully interactive online knowledge base — not just a simple content collection, but an organic knowledge ecosystem that preserves hierarchical relationships and logical connections between knowledge points.
🌳 Split-Panel Navigation
The knowledge base interface uses a classic split-panel layout. The navigation tree on the left preserves the original hierarchy, allowing users to easily browse and expand different branches. This tree structure intuitively displays how knowledge is organized, helping readers understand parent-child relationships between content. The navigation tree supports dynamic expand and collapse, keeping even large knowledge bases with hundreds of nodes clean and manageable.
🧭 Breadcrumb Path Navigation
When a user clicks on a note, the content area displays that note’s full details. At the same time, a breadcrumb trail at the top shows the complete path to the current location, so users always know exactly where they are within the knowledge structure. This path awareness is essential for deep learning — it helps readers place the current content within its broader knowledge context, creating a coherent cognitive experience.
🃏 Child Note Cards
If the current note has child notes, they’re displayed as neatly arranged cards at the bottom. Each card shows the child note’s title and type information, providing an entry point for further exploration. This design encourages readers to follow the threads of knowledge deeper, discovering related concepts and perspectives, and building a complete knowledge network.
📱 Responsive & Adaptive
The entire knowledge base interface uses responsive design, automatically adjusting its layout based on screen size. On mobile devices and other small screens, the interface reorganizes itself and provides a sidebar toggle to maximize content display space. This adaptability ensures a quality user experience across all devices, meeting the diverse reading habits of today’s audiences.
V. Powerful & Precise Search
Trilium itself features a powerful structured search system, and Trilium WP preserves this capability in full. Unlike simple full-text search, Trilium’s search system supports complex query conditions and structured filtering, enabling pinpoint accuracy when locating information. This advanced search capability is especially valuable for large knowledge bases — it lets users cut through dense information forests and find exactly the knowledge fragments they need.
🔎 Advanced Search Capabilities
- ✅ Supports combined queries using labels, attribute values, content keywords, and more
- ✅ Supports scoped search, restricting results to specific knowledge base branches to avoid irrelevant noise
- ✅ Search results are displayed as cards with titles, modification dates, and other key metadata for quick relevance assessment
- ✅ Built-in search syntax help documentation with detailed rules and practical examples, so even first-time users can get up to speed quickly
🔍 For example: you can search for notes labeled “important” that were created within the last month, or find content containing specific keywords that belong to a particular category — progressively narrowing your scope to zero in on exactly what you need.
VI. User-Centered Interface Design
Trilium WP follows the principle of “clean, intuitive, and responsive” in its interface design. The goal is to make complex functionality easy to understand and use, minimizing cognitive load. The entire plugin avoids over-engineering and unnecessary ornamentation, focusing instead on clear content presentation and smooth functionality.
🎨 Visual Style Integration
The plugin’s visual style is clean and consistent, coexisting harmoniously with any WordPress theme. It uses a neutral color palette to avoid clashing with theme colors, and follows the host theme’s typographic conventions to maintain visual consistency. It also includes deep optimizations for popular themes like BuddyBoss, ensuring that the knowledge base integrates naturally into any WordPress site as an organic part of the overall design.
🌓 Smart Light/Dark Mode
The plugin intelligently adapts to light and dark modes, automatically switching based on the user’s system preferences or WordPress theme settings. In dark mode, the interface shifts to a color scheme suited for nighttime reading, reducing eye strain from screen brightness. This adaptive capability ensures a comfortable visual experience across different environments and personal preferences.
👆 Refined Interaction Experience
Every interactive element is carefully crafted with solid support for both mouse and touch input. Buttons, links, and controls are appropriately sized for accurate operation on touch devices. State feedback is clear and immediate — every user action receives timely visual confirmation. These details collectively create a smooth, natural interaction experience that lets users focus on the content itself.
⚡ Intelligent Caching System
On the performance side, the plugin implements a versioned caching mechanism built on WordPress Transients, reducing the frequency of requests to the Trilium server. The cache automatically refreshes content at configurable intervals, striking a balance between near-real-time freshness and significantly reduced server load. This balanced design ensures reasonably fresh content while providing a fluid, stable user experience — even when network connectivity is unreliable.
VII. The Trilium WP Plugin Ecosystem
Trilium WP isn’t just a standalone plugin — it’s evolving into a complete plugin ecosystem. The main plugin provides core note display and knowledge base capabilities, while a growing family of sub-plugins extends its reach. The three sub-plugins introduced here expand editing, syncing, and multi-instance connectivity, forming a complete loop from display → edit → sync → multi-source.
☘️ Trilium WP (Main Plugin)
The core bridge connecting Trilium Notes and WordPress. Establishes a secure connection via the ETAPI interface, providing full-featured note display, knowledge base construction, and structured search.
- 6 functional shortcodes covering note display, knowledge base, search, browsing, and more
- v2 API layer supporting bidirectional operations: create, update, delete, and clone notes
- Intelligent rendering of 16 note types, including secure image/PDF proxying
- Comprehensive security framework: nonce verification, XSS protection, SQL injection prevention
- Versioned caching system + dark mode + BuddyBoss theme optimization
✏️ Trilium Editor (Sub-Plugin)
Full Trilium note editing capability right on the WordPress frontend. No need to switch back to the Trilium app — create, read, update, and delete knowledge content directly on the web.
- Rich text editor based on
contentEditable, supporting bold/italic/strikethrough/lists/checkboxes - Tree navigation + breadcrumb navigation + note search for seamless knowledge browsing
- Double-click to edit titles,
Ctrl+Sto quick-save, create and delete notes - Dual-layer permission system: view permissions (main plugin) + edit permissions (configurable: all logged-in users → admins only)
- 5-layer security stack: Nonce ➜ Permissions ➜
root_idsubtree scope validation ➜ Content filtering ➜ ETAPI token authentication - Emoji-safe title sanitization + permissive HTML filtering
- v1.1.0 native support for the
instanceattribute for multi-instance editing
🔄 Trilium Post Sync (Sub-Plugin)
Bidirectional synchronization between Trilium Notes and WordPress posts — knowledge base notes are automatically published as posts, and WordPress posts can be written back to Trilium.
- Two-way sync: Trilium → WordPress (publish notes as posts) / WordPress → Trilium (write posts back as notes)
- Supports both scheduled auto-sync (configurable frequency) and manual sync
- v2.0 adds: per-configuration independent sync buttons, separated bidirectional sync controls
- Resume-from-checkpoint mechanism + custom post type support
- Database stability safeguards: automatic table detection/repair, mapping relationship rebuild
- v1.6 added duplicate title detection, streamlined sync content (body only, no extraneous metadata)
- Deep integration with the main plugin: smart dependency detection + shortcode forwarding
🌐 Trilium Multi-Instance (Sub-Plugin)
Connect a single WordPress site to multiple Trilium servers simultaneously, enabling unified display and management of multiple knowledge sources. Built on a zero-intrusion architecture — just 4 filter hook patches to integrate with the main plugin.
- Dynamic routing architecture based on the
trilium_connection_paramsfilter hook - Only 4 filter hook patches (~20 lines of code) for zero-intrusion integration with the main plugin
- All 6 main plugin shortcodes + the Editor shortcode support the
instanceattribute - Dual-layer AJAX interception: PHP layer (priority-1 pre-intercept + output buffering) and JS layer (
jQuery.ajaxPrefilter) - Context stack management to prevent cross-contamination from nested multi-instance calls on the same page
- v1.2.0 covers all 8 Editor AJAX operations for complete cross-sub-plugin collaboration
VIII. AI-Powered: Trilium AI Chat
As AI technology continues to advance, SatoshiWP is actively exploring the integration of intelligent features into the knowledge base system. Trilium AI Chat is an AI extension plugin for Trilium WP, also currently in closed beta.
🧠 Core Capabilities
This plugin deeply integrates AI chat functionality with the Trilium Notes knowledge base, allowing users to interact with their personal knowledge base through natural language directly within the WordPress environment:
/trilium search— 🔍 Quickly search for keywords across the Trilium note library, with results returned as a list/trilium get— 📄 Retrieve the full content of a specific note/trilium analyze— 🧬 AI-powered deep analysis of a specific note, extracting key insights and generating structured findings/trilium research— 📊 The flagship feature! Combines search + analysis into one, generating comprehensive research reports
📚 Academic Literature Review
Designed for academic professionals, this feature automatically analyzes scholarly articles stored in Trilium, generating structured reviews that cover research questions, methodology, findings, and limitations.
📋 Processing History Tracking
Full processing history for every document — view the processing status, timestamp, and results for each article, with one-click retry for any failures.
Additionally, in 2025 the Trilium community introduced MCP (Model Context Protocol) server integration, allowing AI assistants to directly read and write Trilium notes — meaning your personal knowledge base is no longer a passive storage repository, but a “living” system that actively collaborates with AI.
IX. Real-World Use Cases
Trilium WP’s versatility makes it well-suited for a wide range of knowledge-sharing scenarios. It’s not just an ideal tool for personal knowledge display — it’s equally at home for team collaboration and professional content publishing.
🎓 Education
Teachers can build structured course resource libraries, organizing syllabi, lecture notes, exercises, and supplementary materials into a cohesive whole. Students can easily find the learning resources they need through clear navigational structures, and understand the connections between different concepts. This organizational approach is especially well-suited for systematic disciplines like computer science, medicine, economics, finance, or law — helping students build comprehensive knowledge frameworks rather than memorizing isolated facts.
🏢 Enterprise Documentation Centers
Technical teams can create professional product documentation hubs, organizing API docs, user guides, and FAQs into a unified, structured resource for customers and partners. This kind of structured documentation center dramatically reduces the learning curve and improves product usability. Internally, organizations can also leverage Trilium WP to build complete knowledge management systems — capturing and sharing team expertise, best practices, and institutional knowledge to foster organizational learning and knowledge continuity.
🔬 Academic Research Publishing
Researchers can present complex research projects in a structured format, showcasing the logical relationships between research questions, methods, findings, and conclusions. Through the knowledge base’s hierarchical structure, readers can understand the overall framework and how different parts relate to each other. This presentation style is particularly effective for interdisciplinary research and long-term projects, helping readers see the big picture and understand how each component contributes to answering the core research questions.
🌱 Digital Gardens
Bloggers and content creators can use Trilium WP to organize scattered notes and ideas into a public “digital garden.” Unlike traditional blogs organized by timeline, a digital garden is organized around themes and concepts, revealing the trajectory of a creator’s evolving thinking. Visitors can explore different topic branches freely based on their interests, discovering unique perspectives and thought processes. This open approach to knowledge sharing is gaining growing recognition — it encourages deep thinking and sustained accumulation, standing in stark contrast to the fast-food style of content consumption.
X. Trilium Notes Ecosystem Updates
As the upstream project behind Trilium WP, the Trilium Notes ecosystem continues to thrive. Keeping up with the latest Trilium developments helps us understand where Trilium WP is headed.
📅 Development Timeline
| Date | Milestone |
|---|---|
| Dec 2017 | Zadam publicly releases Trilium Notes for the first time, opening a new chapter in open-source knowledge management |
| Jan 2024 | Zadam announces Trilium Notes is entering maintenance mode; the TriliumNext community fork launches the same month, picking up the torch |
| 2025 | Zadam officially transfers the original repository to the TriliumNext team; the community ships an MCP server, enabling AI assistants to read and write notes directly |
| Dec 2025 | v0.101.0 released — a comprehensive UI modernization that transforms the experience |
| Jan 2026 | v0.101.3 released — brand returns to “Trilium Notes,” introduces the Trilium.Rocks default theme, and patches CVE-2025-58754 |
🏗️ Trilium Ecosystem Highlights
- 🔐 Local-first: All data stored on the user’s own device, with support for end-to-end encryption (per-note AES encryption)
- 🧬 Note cloning: A single note can appear under multiple parent nodes while staying in sync — true “one note, many references”
- ⏳ Version history: Every note automatically maintains a version history, viewable and restorable at any time
- 🛠️ Scripting: Each note can contain JavaScript code that operates on other notes, with full Node.js API access
- 🤖 AI integration: The MCP server enables AI assistants to interact directly with the knowledge base, and SatoshiWP’s Trilium AI plugin is a standout example
XI. Looking Ahead
While Trilium WP already offers a rich feature set, the continuous evolution of technology and user needs opens up vast room for growth. We have many exciting plans for future releases — new features that will further strengthen the plugin’s capabilities and create even richer knowledge-sharing experiences.
In upcoming versions, we’ll be implementing more efficient caching strategies and on-demand loading techniques, enabling the knowledge base to smoothly handle ever-larger content collections while maintaining the right balance between response speed and resource consumption.
As AI technology continues to evolve, Trilium AI Chat will receive further upgrades. Plans include introducing deep Q&A capabilities based on content analysis, allowing users to interact with their knowledge base through even more natural conversations — getting precise answers and structured knowledge insights.
XII. Start Your Knowledge-Sharing Journey
Trilium WP gives knowledge workers a powerful tool that makes transforming a private knowledge base into a public knowledge resource simple and elegant. It builds a bridge from personal accumulation to public sharing, helping valuable ideas and information reach a wider world.
🚀 Get Started in Three Steps
- Build your Trilium note library — Take the time to think about how your knowledge should be organized. Establish clear hierarchies and relationship structures. Make good use of labels, attributes, and internal links — they’ll become the critical connective tissue of your knowledge network. A thoughtfully designed knowledge structure isn’t just easier for you to use; it also helps readers better understand and absorb the content.
- Install and configure Trilium WP — After installation, connect to your Trilium server’s ETAPI interface by entering the API URL and access token to establish a secure communication channel. The plugin’s intuitive admin interface makes configuration straightforward — no complex technical steps required.
- Publish your knowledge — Use shortcodes or dedicated knowledge base pages to display Trilium content on your WordPress site. Extend with sub-plugins as needed for editing, syncing, or multi-source connectivity.
🌿 In today’s age of fragmented information, this kind of structured knowledge sharing is more precious than ever — it doesn’t just convey information; it conveys ways of thinking and the interconnected threads of knowledge. Trilium WP will be your trusted companion, helping the tree of your ideas take root in broader soil and flourish.