Obsidian 插件模板变量完全指南
使用笔记同步助手 Obsidian 插件时，你可以通过模板变量来自定义文件的保存方式和显示格式。本文将详细介绍所有可用的模板变量及其使用方法。
什么是模板变量
模板变量是一种占位符，在保存文章时会被替换为实际的内容。通过使用模板变量，你可以：
- 自动生成有规律的文件名
- 按日期或分类组织文件夹结构
- 自定义文章的显示格式
- 创建结构化的元数据
📅 日期时间变量
日期时间变量可以帮助你按时间组织笔记：
{{{dateSaved}}}- 保存时间（完整格式）{{{yearSaved}}}- 保存日期的年份{{{monthSaved}}}- 保存日期的月份{{{daySaved}}}- 保存日期的日
使用场景： 按日期归档文章，创建时间线式的知识库。
📄 文章基本信息
这些变量包含文章的核心信息：
{{{id}}}- 文章ID{{{title}}}- 文章标题{{{author}}}- 作者{{{siteName}}}- 网站名称{{{originalUrl}}}- 原文链接
使用场景： 在文章开头显示来源信息，方便追溯原文。
📝 内容与元数据
用于访问文章的详细内容和状态：
{{{content}}}- 文章内容{{{labels}}}- 标签{{{type}}}- 内容类型（ARTICLE, FILE 等）{{{state}}}- 状态（INBOX, READING, COMPLETED, ARCHIVED）{{{wordsCount}}}- 字数
使用场景： 创建自定义的文章模板，添加阅读状态标记。
🔧 自定义函数
模板系统还提供了一些实用的文本处理函数：
文本转换函数
{{#lowerCase}}text{{/lowerCase}}- 将文本转换为小写{{#upperCase}}text{{/upperCase}}- 将文本转换为大写{{#upperCaseFirst}}text{{/upperCaseFirst}}- 将首字母转换为大写
示例：
{{#lowerCase}}{{{title}}}{{/lowerCase}}如果标题是”技术文章”，结果为”技术文章”（小写）
日期格式化函数
{{#formatDate}}dateSaved, yyyy-MM-dd{{/formatDate}} - 自定义日期格式
常用格式：
yyyy-MM-dd→ 2026-01-17yyyy年MM月dd日→ 2026年01月17日yyyyMMdd→ 20260117
💡 实用示例
示例 1：按日期组织文件名
模板：
{{{yearSaved}}}-{{{monthSaved}}}-{{{daySaved}}}-{{{title}}}结果：
2026-01-17-Obsidian插件使用指南这种命名方式可以让文件自动按时间排序，方便查找历史文章。
示例 2：按年月组织文件夹
模板：
{{{yearSaved}}}/{{{monthSaved}}}结果：
2026/01文章会自动保存到对应年月的文件夹中，形成清晰的时间归档结构。
示例 3：自定义日期格式
模板：
{{#formatDate}}dateSaved, yyyy年MM月dd日{{/formatDate}}结果：
2026年01月17日适合在文章开头显示中文格式的保存日期。
🎯 应用场景
模板变量可以在插件的多个设置中使用：
1. 文件夹路径设置
在”文件夹”设置中使用变量来动态组织文件结构。
推荐配置：
{{{yearSaved}}}/{{{monthSaved}}}或按网站分类：
{{{siteName}}}/{{{yearSaved}}}2. 文件名设置
在”文件名”设置中使用变量来自动命名文件。
推荐配置：
{{{yearSaved}}}-{{{monthSaved}}}-{{{daySaved}}}-{{{title}}}3. 文章模板设置
在”文章模板”设置中使用变量来自定义文章内容的显示格式。
示例模板：
# {{{title}}}
> 作者：{{{author}}}
> 来源：{{{siteName}}}
> 链接：{{{originalUrl}}}
> 保存时间：{{#formatDate}}dateSaved, yyyy-MM-dd{{/formatDate}}
{{{content}}}4. 前置元数据模板设置
在”前置元数据模板”设置中使用变量来自定义 YAML 格式的元数据。
示例模板：
---
title: {{{title}}}
author: {{{author}}}
source: {{{siteName}}}
url: {{{originalUrl}}}
saved: {{#formatDate}}dateSaved, yyyy-MM-dd{{/formatDate}}
tags: [{{{labels}}}]
---5. 助手消息模板设置
在”助手消息模板”设置中使用变量来自定义企微消息的显示格式。
示例模板：
已保存文章：{{{title}}}
来源：{{{siteName}}}
字数：{{{wordsCount}}}⚠️ 注意事项
在使用模板变量时，需要注意以下几点：
1. 大括号的使用
- 三个大括号
{{{variable}}}- 不转义 HTML，保留原始内容 - 两个大括号
{{variable}}- 转义 HTML，防止 HTML 标签被解析
建议： 大多数情况下使用三个大括号，除非你需要显示 HTML 代码本身。
2. 日期格式规范
日期格式遵循标准的日期格式化规范：
yyyy- 四位年份MM- 两位月份（01-12）dd- 两位日期（01-31）HH- 24小时制小时mm- 分钟ss- 秒
3. 函数嵌套使用
自定义函数可以嵌套使用，实现更复杂的文本处理：
{{#upperCase}}{{#formatDate}}dateSaved, yyyy-MM-dd{{/formatDate}}{{/upperCase}}4. 变量不存在时的处理
如果某个变量在当前文章中不存在（如某些文章没有作者信息），该变量会被替换为空字符串，不会显示任何内容。
🎓 总结
模板变量是笔记同步助手 Obsidian 插件的强大功能，通过合理使用这些变量，你可以：
- 建立有序的文件组织结构
- 自动化文件命名和归档
- 创建个性化的文章展示格式
- 提高知识管理效率
建议你根据自己的使用习惯，尝试不同的模板配置，找到最适合自己的知识管理方式。
开始使用
如果你还没有安装笔记同步助手插件，扫码关注「笔记同步助手」服务号，获取插件下载和使用指南。
更多使用技巧和更新信息，请关注《笔记同步助手》服务号。
