Obsidian模板变量有哪些常用类型？

Question

在使用 Obsidian 创建模板时，常见的疑问是：Obsidian 模板变量支持哪些常用类型？用户常困惑于如何正确使用如 `{{title}}`、`{{date}}`、`{{time}}`、`{{tag}}` 等内置变量，以及是否支持自定义变量或条件判断。例如，能否通过 `{{if}}` 语句实现动态内容插入？又如，`{{prompt}}` 变量如何接收用户输入并赋值？此外，日期格式化变量如 `{{date:YYYY-MM-DD}}` 是否支持多种格式？了解这些变量的类型与语法对提升模板自动化效率至关重要。

Answer 1

1. Obsidian 模板变量基础类型与语法

在使用 Obsidian 创建模板时，了解其支持的变量类型是实现自动化内容生成的第一步。Obsidian 原生支持多种内置变量，这些变量通过双大括号 {{ }} 语法调用。

• {{title}}：自动插入当前笔记的文件名（不含扩展名），常用于标题行或元数据区域。
• {{date}}：插入系统当前日期，默认格式为 YYYY-MM-DD。
• {{time}}：插入当前时间，格式通常为 HH:mm。
• {{tag}}：该变量本身不直接输出标签，需配合 Dataview 或 Templater 插件才能动态提取笔记中的标签信息。

值得注意的是，原生 Obsidian 的模板功能较为基础，仅支持静态变量替换，不包含逻辑控制语句如条件判断或循环结构。

2. 日期与时间格式化：灵活性与扩展性分析

虽然默认的 {{date}} 和 {{time}} 提供了基本的时间戳能力，但实际工作中往往需要更精细的格式控制。Obsidian 支持通过冒号后接格式字符串的方式自定义输出样式。

变量写法	示例输出	说明
{{date:YYYY-MM-DD}}	2025-04-05	标准 ISO 日期格式
{{date:DD/MM/YYYY}}	05/04/2025	欧洲常用格式
{{time:HH-mm-ss}}	14-30-22	适合命名快照或日志文件
{{date:dddd, MMMM Do YYYY}}	Saturday, April 5th 2025	自然语言风格

这种格式化机制基于 Moment.js 的语法规范，因此开发者可以复用已有的前端知识进行快速迁移和调试。

3. 用户交互与动态赋值：{{prompt}} 的工作机制

为了提升模板的灵活性，Obsidian 提供了 {{prompt}} 变量来实现运行时用户输入。其完整语法为：{{prompt:variable_name:default_value}}。

{{prompt:project_name:My Project}} {{prompt:task_priority:High}}

当应用模板时，Obsidian 会弹出对话框，允许用户为 project_name 和 task_priority 输入具体值。若用户未修改，则使用默认值填充。这一机制特别适用于创建任务看板、会议纪要或项目初始化文档等场景。

此外，结合社区插件如 Templater，可进一步将 prompt 结果存储为元数据字段或传递给 JavaScript 脚本进行后续处理。

4. 条件判断与逻辑控制：从原生限制到插件增强

原生 Obsidian 不支持 {{if}} 类似的条件语法。例如，以下代码无法正常工作：

{{if:{{tag}} contains "#meeting"}} # 会议纪要模板内容 {{endif}}

然而，通过安装 Templater 插件，用户可以获得完整的逻辑控制能力。Templater 使用 JavaScript 引擎驱动模板渲染，支持真正的条件判断、循环和异步操作。

`={{
  const tag = tp.frontmatter["tags"];
  if (tag && tag.includes("meeting")) {
    return "## 决议事项\n\n- \n\n## 待办事项\n\n- ";
  } else {
    return "## 详细内容\n\n";
  }
}}`

上述代码展示了如何根据 frontmatter 中的标签动态生成不同结构的内容区块，极大提升了模板的智能化水平。

5. 自定义变量与上下文继承机制

除了使用内置变量外，高级用户可通过 Templater 实现变量声明与作用域管理。例如：

`={tp.variables["author"] = "Alice Chen"}`
`={tp.variables["author"]}`

此特性允许在模板中跨段落引用计算结果或缓存中间状态。更进一步地，Templater 支持“模板参数”功能，允许外部模板调用另一个模板并传入参数对象，形成模块化的模板架构。

结合 DataviewJS，还可以从数据库中查询最新记录作为变量值，实现真正意义上的动态知识注入。

6. 高级集成与流程可视化：构建智能模板系统

对于具备五年以上经验的 IT 从业者而言，Obsidian 不仅是笔记工具，更是个人知识操作系统（PKM）。通过整合多个插件，可构建如下自动化流程：

graph TD A[触发模板创建] --> B{检查上下文} B -->|含 #meeting| C[加载会议模板] B -->|含 #bug| D[加载缺陷报告模板] C --> E[调用 prompt 获取参会人] D --> F[自动填充 Jira 链接] E --> G[插入动态时间戳] F --> G G --> H[保存并链接至相关项目]

该流程体现了现代 DevOps 思维在个人生产力工具中的映射：事件驱动、条件分支、外部系统集成。此类设计不仅提高效率，也为团队协作提供了标准化入口。