Obsidian

Obsidian 插件模板变量完全指南

笔记同步助手 · ·Obsidian 教程
Obsidian模板变量教程知识管理自定义

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-17
  • yyyy年MM月dd日 → 2026年01月17日
  • yyyyMMdd → 20260117

常用时间格式：

插件没有 {{{hourSaved}}}、{{{minuteSaved}}} 这类单独的时间变量 —— 拆分变量只到「年 / 月 / 日」。要显示小时、分钟、秒，统一用 formatDate 配下面这些格式符（以 15:07:09 为例）：

格式符结果说明
HH / H15 / 1524 小时制，HH 补零
hh / h03 / 312 小时制
mm / m07 / 7分钟
ss / s09 / 9秒
a下午上午 / 下午
cccc星期六星期几
X1768662429时间戳（秒）

组合起来就是 HH:mm:ss → 15:07:09、HH-mm → 15-07、a h点mm分 → 下午 3点07分。

💡 实用示例

示例 1：按日期组织文件名

模板：

{{{yearSaved}}}-{{{monthSaved}}}-{{{daySaved}}}-{{{title}}}

结果：

2026-01-17-Obsidian插件使用指南

这种命名方式可以让文件自动按时间排序，方便查找历史文章。

示例 2：按年月组织文件夹

模板：

{{{yearSaved}}}/{{{monthSaved}}}

结果：

2026/01

文章会自动保存到对应年月的文件夹中，形成清晰的时间归档结构。

示例 3：自定义日期格式

模板：

{{#formatDate}}{{dateSaved}},yyyy年MM月dd日{{/formatDate}}

结果：

2026年01月17日

适合在文章开头显示中文格式的保存日期。

示例 4：正文里显示精确到秒的保存时间

模板：

> 保存于 {{#formatDate}}{{dateSaved}},HH:mm:ss{{/formatDate}}

结果：

> 保存于 15:07:09

放在文章开头，一眼就能看出这篇是什么时候存进来的。同一天保存的文章，排查顺序时特别有用。

示例 5：文件名带时间，避免同一天重名

模板：

{{{title}}}-{{#formatDate}}{{savedAt}},HH-mm-ss{{/formatDate}}

结果：

Obsidian插件使用指南-15-07-09

同一天保存到多篇同名文章时，带上时分秒就不会互相覆盖。这里有两个细节：

  • 文件名里写 - 不要写 : —— 冒号是文件名非法字符，插件会自动替换成 -，直接写 - 结果更可控。
  • 用 {{savedAt}} 而不是 {{dateSaved}} —— 原因见下面的示例 6 之后那段说明。

示例 6：按小时分桶归档文件夹

模板：

{{{yearSaved}}}/{{{monthSaved}}}/{{{daySaved}}}/{{#formatDate}}{{savedAt}},HH{{/formatDate}}时

结果：

2026/01/17/15时

一天保存量很大时，在「日」下面再按小时分一层，比一个文件夹塞几百篇好翻得多。

⚠️ 取时间时最容易踩的坑：{{dateSaved}} 可能已经没有时间了

{{dateSaved}} 拿到的是已经按设置格式化过的字符串，formatDate 会把它重新解析一遍。所以它在不同模板里能不能取到时间，取决于对应的日期格式设置：

  • 文章模板 / 前置元数据模板：{{dateSaved}} 跟着「保存日期格式」走，默认 yyyy-MM-dd HH:mm:ss，自带时间，所以示例 4 那样写没问题。
  • 文件夹模板 / 文件名模板：{{dateSaved}} 跟着「文章文件夹日期格式」「文章文件名日期格式」走，默认 yyyy-MM-dd，时间已经被丢掉了 —— 这时再去取 HH:mm 只会拿到 00:00。

因此在文件夹 / 文件名模板里取时间，请改用原始时间变量 {{savedAt}}：它是完整的原始时间，不受任何日期格式设置影响（示例 5、示例 6 就是这么写的）。

另外两点：formatDate 按第一个逗号切分变量和格式，所以格式串里不能再出现逗号；想让某段文字原样输出、不被当成格式符，用单引号包起来，例如 {{#formatDate}}{{savedAt}},'保存于' HH:mm{{/formatDate}} → 保存于 15:07。

🎯 应用场景

模板变量可以在插件的多个设置中使用：

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 插件的强大功能，通过合理使用这些变量，你可以：

  • 建立有序的文件组织结构
  • 自动化文件命名和归档
  • 创建个性化的文章展示格式
  • 提高知识管理效率

建议你根据自己的使用习惯，尝试不同的模板配置，找到最适合自己的知识管理方式。

开始使用

如果你还没有安装笔记同步助手插件，扫码关注「笔记同步助手」服务号，获取插件下载和使用指南。

更多使用技巧和更新信息，请关注《笔记同步助手》服务号。