Joplin Templates 插件使用手册

笔记或待办添加标签 **template**即可成为可用模板。
模板可以放在任意笔记本中，不一定要放在名为 "Templates" 的文件夹里，只要打上 template 标签即可被插件识别。
自定义日期助手 ({{#custom_datetime}})能够在模板内完全自定义日期和时间的显示格式。

Joplin Templates 插件使用手册

一、插件简介

Joplin Templates 插件是 Joplin 官方出品的模板管理工具，允许用户在 Joplin 中创建、管理和使用模板，快速生成新笔记和待办事项。该插件采用 Handlebars.js 作为底层模板引擎，支持内置变量自动填充、自定义变量交互输入以及特殊变量控制标题/标签/目标笔记本等功能。

二、安装插件

启动 Joplin 应用
导航至 工具 → 选项 → 插件
在插件市场中搜索 Templates
点击 安装插件
重启 Joplin 以激活插件

旧版模板迁移：如果您之前使用过旧版模板功能，安装插件后所有旧模板会自动导入到名为 Imported Templates - dd/mm/yyyy 的笔记本中。原有的 .md 模板文件会被重命名为 .md.old，确认导入无误后可以安全删除。

三、创建模板

创建模板非常简单，只需以下步骤：

在任意笔记本中 新建一个笔记 或 待办事项
编辑其内容作为模板（可包含变量、格式等）
为该笔记或待办添加标签 template
保存即可——它现在已经成为可用的模板了

注意：模板可以放在任意笔记本中，不一定要放在名为 "Templates" 的文件夹里，只要打上 template 标签即可被插件识别。

四、使用模板

4.1 通过菜单使用

进入 工具 → 模板
选择需要的模板，点击 创建新笔记 或 创建新待办事项

4.2 在新建时使用

新建笔记/待办时，可以直接通过指定模板快速生成内容

4.3 设置默认模板

可以在插件选项中设定默认模板，并为常用模板分配快捷键，以便快速创建特定类型的笔记或待办事项。

五、模板变量详解

模板变量是 Templates 插件的核心功能，分为三类：内置变量、自定义变量和特殊变量。

5.1 内置变量（自动填充）

内置变量在创建新笔记时会自动填充，无需用户交互：

变量	说明	示例输出
`{{date}}`	当前日期	2019-01-01
`{{time}}`	当前时间	13:00
`{{datetime}}`	当前日期和时间	01/01/19 1:00 PM
`{{#custom_datetime}}M d{{/custom_datetime}}`	自定义格式的日期时间（使用 moment.js 格式）	Jan 1
`{{bowm}}`	本周开始日期（周一为起始日）
`{{bows}}`	本周开始日期（周日为起始日）

注意：所有日期的格式均基于 Joplin 设置中的 常规 > 日期格式 设定。
自定义格式详见文末。

模板示例：

# 会议记录

日期：{{date}}
时间：{{time}}

## 会议内容

## 行动计划

5.2 自定义变量（交互输入）

自定义变量会在使用模板时弹出对话框，提示用户输入值。

支持的变量类型：

类型	语法示例	效果
文本	`name: text`	弹出文本输入框
数字	`count: number`	弹出数字输入框
布尔值	`show_summary: boolean`	弹出复选框
日期	`meeting_date: date`	弹出日期选择器
时间	`meeting_time: time`	弹出时间选择器
下拉选项	`color: dropdown(Red, Yellow, Green)`	弹出下拉选择框

模板示例：

name: text
color: dropdown(Red, Yellow, Green)

你好，{{name}}。你最喜欢的颜色是{{color}}。

本笔记创建于{{datetime}}。

使用该模板时，会依次弹出询问：

请输入 name 的值 → 输入"张三"
请选择 color 的值 → 选择 "Red"

最终生成的笔记内容为：

你好，张三。你最喜欢的颜色是Red。

本笔记创建于2026-01-08 14:30。

变量命名规范：

不能使用空格和特殊字符（如 @ , # + ( ) 等）
可以使用下划线 _
若自定义变量与内置变量同名，自定义变量的值将优先使用

自定义标签（高级用法）：

可以为每个自定义变量设置标签，在输入对话框中显示更友好的提示文本，而不是变量名本身：

project: label: Select a project type: dropdown(project 1, project 2, project 3)
show_summary: label: Add summary in note? type: boolean

5.3 特殊变量（控制笔记属性）

变量	作用
`template_title`	设置新笔记的标题
`template_tags`	预设创建时应用的标签
`template_notebook`	指定目标笔记本 ID

模板示例：

template_title: {{#custom_datetime}}YYYY-MM-DD{{/custom_datetime}} 日报
template_tags: 日报,工作总结

## 今日完成
## 明日计划

六、进阶技巧

6.1 存储模式

插件支持两种模板管理模式：

标签模式：通过 template 标签识别模板（推荐）
笔记本模式：将所有模板存放在名为 "Templates" 的特定笔记本中

6.2 使用 Handlebars 高级语法

由于插件内部使用 Handlebars.js 编译模板，您可以使用其高级特性，如条件语句和循环等。

6.3 演示模板

首次使用插件的用户，可以参考官方提供的 完整功能演示模板（Complete Feature Demonstration Template），其中包含了所有功能的示例和预期输出，是快速上手的最佳学习材料。

七、常见问题及解决方案

Q1：安装插件后找不到模板选项？

解决：确保已重启 Joplin 以激活插件。如果仍不可见，请检查插件是否已成功安装（工具 → 选项 → 插件 → 已安装列表）。

Q2：自定义变量不弹出输入框？

可能原因：

变量定义语法不正确
变量名包含空格或特殊字符
检查变量定义是否位于模板内容顶部

解决：确保使用正确的语法格式，如 name: text，且变量名只使用字母、数字和下划线。

Q3：旧版模板如何迁移？

安装 Templates 插件后，旧版模板会自动导入。它们会出现在 Imported Templates - dd/mm/yyyy 笔记本中。确认导入正确后，可以删除原 .md.old 文件。

Q4：模板变量替换后内容不更新？

可能原因：变量名称拼写错误，或未使用正确的双花括号语法 {{variable}}。

Q5：手机版是否支持模板插件？

目前已有社区开发者为手机版提供了支持，可以在移动设备上使用来自桌面的现有模板。

八、从源码安装（开发者）

如果您需要从源码构建安装：

克隆项目：git clone https://github.com/joplin/plugin-templates.git
安装依赖：cd plugin-templates && npm install
构建插件：npm run build
在 Joplin 中通过插件市场搜索安装

九、资源链接

插件 GitHub 仓库：https://github.com/joplin/plugin-templates
完整功能演示模板：https://raw.githubusercontent.com/joplin/plugin-templates/HEAD/DEMO_TEMPLATE.md
Joplin 官网：https://joplinapp.org

十、总结

Joplin Templates 插件极大地提升了笔记创建的效率。通过创建模板并结合内置变量、自定义变量和特殊变量，您可以轻松生成标准化的会议记录、日报、周报、项目报告等各种类型的笔记，告别重复性的格式设置和内容填写，让创作过程更加高效流畅。

在 Joplin Templates 插件中，自定义日期/时间的核心是使用 {{#custom_datetime}} 块级助手。其基本语法是 {{#custom_datetime}}所需格式{{/custom_datetime}}，例如 {{#custom_datetime}}YYYY-MM-DD HH:mm:ss{{/custom_datetime}}。

⚠️ 它和内置变量的区别

首先需要明确一个关键点，它与 {{date}}、{{time}}、{{datetime}} 这些内置变量不同：

内置变量 ({{date}} 等)：会自动填充当前时间，但格式是固定的，遵循你在 Joplin 设置中配置的日期格式，无法在模板中自定义。
自定义日期助手 ({{#custom_datetime}})：能够让你在模板内完全自定义日期和时间的显示格式。

📝 如何使用 `custom_datetime`

这个块级助手使用 moment.js 的格式化规则来定义输出。你只需要在 {{#custom_datetime}} 和 {{/custom_datetime}} 之间写入你想要的格式代码即可。

基本语法：

{{#custom_datetime}}格式代码{{/custom_datetime}}

实际应用示例：

格式代码	输出示例 (以2026年4月8日 14:05:30为例)
`YYYY-MM-DD HH:mm:ss`	2026-04-08 14:05:30
`YYYY年MM月DD日`	2026年04月08日
`M/D`	4/8
`dddd, MMMM Do YYYY`	Wednesday, April 8th 2026
`MMMM YYYY, h:mm:ss a`	April 2026, 2:05:30 pm

🧩 常用 Moment.js 格式代码

要灵活使用，你需要了解一些常用的 moment.js 格式代码：

年份
- YYYY：四位年份 (2026)
- YY：两位年份 (26)
月份
- MM：两位数字月份 (04)
- M：一位或两位数字月份 (4)
- MMMM：完整月份英文 (April)
- MMM：缩写月份英文 (Apr)
日期
- DD：两位数字日期 (08)
- D：一位或两位数字日期 (8)
- Do：带序数词日期 (8th)
星期
- dddd：完整星期英文 (Wednesday)
- ddd：缩写星期英文 (Wed)
时间
- HH：24小时制，两位数字 (14)
- hh：12小时制，两位数字 (02)
- mm：分钟，两位数字 (05)
- ss：秒钟，两位数字 (30)
- a：上午/下午标记 (pm)

💡 典型应用场景

场景一：日记模板
你可以创建一个日记模板，自动生成以日期为标题的笔记。

template_title: {{#custom_datetime}}YYYY-MM-DD{{/custom_datetime}} 日记
template_tags: 日记,个人

# {{#custom_datetime}}dddd, MMMM Do YYYY{{/custom_datetime}}

## 心情

## 今日要点

## 待办事项

场景二：会议记录
在会议记录中，生成更符合本地习惯的日期格式。

# 会议记录 - {{#custom_datetime}}YYYY年MM月DD日 HH:mm{{/custom_datetime}}

## 主题

场景三：结合自定义变量
你可以将自定义日期助手与 custom variables 结合，让用户手动输入日期，并输出自定义格式。

meeting_date: date

# 会议记录 - {{meeting_date}}

重要提示：{{#custom_datetime}} 只能格式化当前时间。对于 date 类型的自定义变量，其输出的格式在插件的当前版本中是固定的（通常是 ISO 格式 YYYY-MM-DD），暂时还无法通过 {{#custom_datetime}} 进行二次格式化。