内容
# 三叶草演示插件
[](https://github.com/Stefan-Schmidbauer/trilium-presenter-plugin/releases/latest)
[](LICENSE)
[](https://triliumnotes.org)
[](mcp/README.md)
将任何三叶草笔记 превратить为全屏演示文稿 - 直接从三叶草中，一键操作。
## 功能特点
- **一键演示**：从任何具有子笔记的笔记开始
- **Markdown 幻灯片**：支持 Pandoc 兼容的语法（列、演讲者笔记、代码块）
- **深度优先遍历**：组织幻灯片为子主题，它们会自动展开
- **演讲者模式**：具有演讲者笔记和幻灯片列表，通过 BroadcastChannel 同步
- **讲义/PDF 导出**：每张幻灯片一页
- **主题系统**：CSS + SVG 背景作为三叶草笔记，按演示文稿可选
- **幻灯片模板**：11 种现成的布局用于快速创建幻灯片
- **键盘和鼠标导航**：带有进度条
- **可配置语言**：通过 `#presenterLang` 标签
- **AI 幻灯片创作**：一个 [MCP 服务器](#mcp服务器-ai-幻灯片创作) 让 AI 助手直接在三叶草中创建和管理演示文稿
## 安装
1. 从 [最新版本](../../releases/latest) 下载 `trilium-presenter-plugin.zip`
2. 在三叶草中，右键单击树中的任意笔记并选择 **导入到笔记**
3. 选择下载的 `.zip` 文件
4. 三叶草默认禁用导入的部件 - 打开导入的 "三叶草演示" 树中的 **部件** 笔记，找到 `#disabled:widget` 属性并将其重命名为 `#widget`
5. 重新加载三叶草（Ctrl+R）- **三叶草演示** 部件出现在右侧面板中
## 快速入门
**最快的方式**：导航到导入的 **示例演示** 笔记并单击 **演示** - 它将带您了解所有功能，包括 Markdown 语法、列、图像和主/克隆工作流程。
**从头开始**:
1. 创建一个笔记并添加子笔记 - 每个子笔记都变成一张幻灯片
2. 将子笔记类型设置为 **代码**，语言为 **Markdown** (`text/x-markdown`)
3. 导航到您的演示文稿笔记并在右侧面板中单击 **演示**
## MCP 服务器（AI 幻灯片创作）
让 AI 助手构建您的演示文稿。 [`mcp/`](mcp/) 文件夹提供了一个模型上下文协议服务器，通过 ETAPI 直接在三叶草中创建和管理演示文稿 - 询问 Claude 类似 *"创建 5 张幻灯片介绍我们的 Q3 路线图"*，幻灯片就会出现在您的笔记树中，准备好演示。
AI 遵循的幻灯片格式从 **幻灯片格式** 文档笔记（标签 `#presenterSlideFormat`）实时加载 - 因此一个笔记是幻灯片创建规则的单一来源，由人类和 AI 共享（以前它硬编码在服务器中）。有关设置，请参见 [mcp/README.md](mcp/README.md)。
## 幻灯片组织
幻灯片通过 **深度优先先序遍历** 收集：
```
我的演示文稿
标题幻灯片 -> 幻灯片 1
介绍 -> 幻灯片 2
深入了解 -> 幻灯片 3（章节分隔符）
详细信息 A -> 幻灯片 4
详细信息 B -> 幻灯片 5
结论 -> 幻灯片 6
```
容器笔记（`text/html` 类型）将被跳过，但其子笔记将被包括在内。这允许您使用文件夹组织幻灯片而不会创建空幻灯片。
## 模式
| 按钮 | 描述 |
|--------|-------------|
| **演示** | 在新窗口中全屏演示文稿 |
| **演讲者模式** | 演讲者视图，包含笔记、幻灯片列表和 BroadcastChannel 同步 |
| **讲义（PDF）** | 打印优化视图，每张幻灯片一页，自动打开打印对话框 |
| **显示幻灯片** | 预览单个 Markdown 幻灯片，带有主题（在单个幻灯片笔记上可见） |
## 主题
在演示前从下拉菜单中选择主题。主题是三叶草笔记，带有 `#presenterTheme` 标签，包含 CSS 子笔记（基准、标题幻灯片、内容幻灯片）和可选的 SVG 背景附件。
包含的主题：**默认**（浅色）和 **深色**。
## 幻灯片类型
第一张幻灯片默认为 `title` 布局，其他默认为 `content`。使用 `#slideType` 标签覆盖：
- `#slideType=title` -- 标题幻灯片样式
- `#slideType=content` -- 内容幻灯片样式
- 自定义类型：通过向主题添加匹配的 CSS 笔记
## 配置
| 标签 | 描述 | 默认值 |
|-------|-------------|---------|
| `#presenterLang` | HTML lang 属性 | `zh` |
| `#slideType` | 幻灯片布局类型 | 自动 |
| `#presenterTheme` | 将笔记标记为主题 | -- |
## 文档
参见 [docs/](docs/) 文件夹：
- [入门](docs/getting-started.md)
- [幻灯片内容](docs/slide-content.md) -- 完整的 Markdown 和 Pandoc 语法参考
- [幻灯片格式](docs/slide-format.md) -- 紧凑的格式参考（也驱动 MCP 服务器）
- [主题](docs/themes.md) -- 创建自定义主题
- [内容组织](docs/content-organization.md) -- 基于克隆的幻灯片库工作流程
- [MCP 服务器](docs/mcp.md) -- AI 幻灯片创作概述（[设置](mcp/README.md)）
- [关于](docs/about.md) -- 作者、许可证和链接
## 作者
**Stefan Schmidbauer** -- [GitHub](https://github.com/Stefan-Schmidbauer)
与 [Claude Code](https://claude.ai/claude-code) 合作编写。
## 许可证
MIT -- 见 [LICENSE](LICENSE)
