Templater插件中创建新文件时Frontmatter消失问题的技术解析

在Obsidian的Templater插件使用过程中，开发者可能会遇到一个典型问题：当通过"Templater: Create..."命令创建新文件时，预先定义的Frontmatter内容会意外消失。这种现象看似是插件bug，实则涉及对Templater工作流程的深入理解。

问题本质分析

该问题的核心在于对tp.file.create_new()方法的错误使用方式。当用户在模板中同时使用命令创建和手动创建两种方式时，实际上会生成两个文件实例：

1. 命令执行阶段：Templater首先创建并打开一个新文件作为执行上下文
2. 脚本执行阶段：create_new()方法在后台创建第二个文件
3. 显示冲突阶段：脚本强制打开第二个文件（含Frontmatter），但命令执行完毕后会回显第一个空文件

正确的实现方案

要实现单文件创建并保留Frontmatter的正确做法是：

---
created: <% moment().format("YYYY.MM.DD HH:mm") %>
modified: <% moment().format("YYYY.MM.DD HH:mm") %>
tags: []
---

<%* 
// 此处可添加其他模板逻辑
%>

这种实现方式避免了文件创建冲突，因为：

• 仅通过命令创建单个文件
• Frontmatter作为模板内容直接写入
• 保持了Templater的标准工作流程

高级应用建议

对于需要复杂初始化的场景，建议采用以下模式：

1. 使用标准模板语法定义静态Frontmatter
2. 通过脚本块动态修改属性
3. 利用Templater钩子执行后续操作

示例：

---
created: <% moment().format("YYYY.MM.DD HH:mm") %>
modified: <% moment().format("YYYY.MM.DD HH:mm") %>
tags: [<%* tp.file.tags %>]
---

<%*
// 动态内容初始化
const projectName = await tp.system.prompt("项目名称");
await tp.file.rename(`项目-${projectName}`);
%>

总结

理解Templater的文件创建机制对于避免这类问题至关重要。开发者应当区分"模板内容"和"创建行为"的界限，避免在模板中重复创建文件。正确的做法是将所有初始化内容（包括Frontmatter）作为模板本身的一部分，而非通过脚本创建。这种模式不仅解决了Frontmatter消失问题，也使模板逻辑更加清晰可维护。