Obsidian 模板从入门到实战5 个技巧让 Templater 替你自动填好一切【免费下载链接】TemplaterA template plugin for obsidian项目地址: https://gitcode.com/gh_mirrors/te/Templater每天新建笔记时你是不是还在重复这三步先打一遍当天的日期再手工粘贴固定的版式最后老老实实敲标题如果答案是一连串的对那这篇 Templater 教程正是为你准备的。Templater 是 Obsidian 生态里最流行的动态模板插件它把填日期、问信息、拼结构这类重复劳动打包成一条条快捷指令你只需轻点一次笔记的骨架就自动长出来。接下来我会带你从零上手并附上 5 个拿来即用的实战技巧。一、先别急着复制粘贴——你真正缺的是动态模板先想一个场景你每天都要写工作日志格式永远是日期 三件要事 一条反思。最笨的办法是每天新建空白笔记然后复制昨天的文件改日期。麻烦不说还容易改错格式。稍聪明一点的办法是做一个静态模板文件但日期还是得手输字段也永远是一潭死水。问题的根源在于模板是死的而你要的内容是活的。Templater 要解决的正是活字。它允许你在模板里埋下一些特殊标签Obsidian 在执行模板的那一刻自动把日期、星期、文件名甚至你刚刚输入的内容算出来填进笔记里。换句话说模板从一张复印纸变成了一条可交互的自动化流水线。二、Templater 是什么一句话认识它用一句话概括Templater 是运行在 Obsidian 里的模板增强引擎支持在模板中插入动态内容、执行 JavaScript 代码还可以弹出输入框询问你的意见。围绕它新手最常问三个问题我在这里一并回答它能解决什么问题自动写入日期时间、读取当前文件名和属性、弹窗收集信息、用代码生成复杂结构甚至执行系统命令。为什么值得用因为它把手动变成了自动。设置一次长期受益它不仅能插入内容还能根据条件决定笔记长什么样。难不难学入门只需要记一种标签格式五分钟就能跑通第一个模板进阶部分可以边用边学。下面这张截图是 Templater 的模板管理界面每个模板由名称 内容两部分组成支持直接写系统命令来生成动态文本非常灵活三、三步上手Templater 安装配置与第一个模板第 1 步安装并重启打开 Obsidian 的设置 → 第三方插件 → 社区插件搜索Templater点击安装并启用。装完建议重启一次 Obsidian确保插件正常加载。想从源码自行构建的开发者也可以执行git clone https://gitcode.com/gh_mirrors/te/Templater拉取仓库。第 2 步两处关键配置进入 Templater 的设置页优先确认两个选项Template folder location模板文件夹指定一个文件夹存放模板文件Obsidian 会从这里读取可用模板建议设为Templates。Automatic jump to cursor自动跳转到光标开启后模板执行完毕会自动跳到tp.file.cursor()标记的位置省去手动滚动的步骤。第 3 步写下第一个动态模板新建一个名为今日开场的模板文件内容只需一行今天是 % tp.date.now(YYYY-MM-DD dddd) %祝你拥有高效的一天。在任意笔记中使用插入模板命令选中它Obsidian 会立刻把它替换成今天是 2026-08-18 Tuesday祝你拥有高效的一天。这样一行文字。恭喜你的第一条动态模板已经跑通了。顺带解释一下语法%和%是命令的开关里面写的是 Templater 的表达式如果改成%*开头则是执行 JavaScript 代码块默认不输出任何内容适合写逻辑。想输出点什么就把内容追加到tR变量上例如%* tR 你好 %。四、实战演练三个可直接套用的场景模板掌握了基础语法后我们直接进入实战。下面三个模板分别覆盖每日记录、学习输入、工作总结三种高频场景你可以在模板文件夹里直接复制使用。案例 1每日日记——一分钟生成带日期的流水账场景需求每天早晨快速开启一篇带日期、星期、天气和待办骨架的日记不用再手敲标题。%* // 取当天日期和星期拼出标题 const today tp.date.now(YYYY-MM-DD); const weekDay tp.date.now(dddd); tR # ${today} ${weekDay}\n\n; % ## ️ 今日概况 天气% await tp.system.prompt(今天天气如何, 晴) % ## ✅ 三件要事 - [ ] - [ ] - [ ] ## 一句话反思 % await tp.system.prompt(今天最想记住的一件事) %使用方法每次想写日记插入这个模板依次回答两个弹窗即可。标题自动带日期星期正文骨架一次成型。案例 2课程学习笔记——收集信息并自动生成标签场景需求上完一节课想快速记下课程名、章节和疑问并自动生成可检索的标签。%* const courseName await tp.system.prompt(输入课程名称如线性代数); const chapterName await tp.system.prompt(输入本章标题); tR --- 课程: ${courseName} 章节: ${chapterName} 记录日期: ${tp.date.now(YYYY-MM-DD)} 状态: 待复习 --- ; % # % tp.file.title % ## 本节目标 - ## 核心概念 - ## ❓ 未解决问题 - [ ] %* // 用章节名生成标签空格替换为连字符 const tag chapterName.replace(/\s/g, -); tR \n## ️ 标签\n#课程/${courseName} #章节/${tag}; %使用方法插入模板后把弹窗当成填空向导回答完课程名和章节标题、属性、标签全部自动生成笔记自带检索入口。案例 3周报总结——自动计算本周范围与所属项目场景需求每周五写周报希望标题自动带上本周的起止日期并能从下拉列表选择项目归属。%* // 取本周一和本周日的日期 const monday tp.date.weekday(YYYY-MM-DD, 1); const sunday tp.date.weekday(YYYY-MM-DD, 7); // 弹出一个下拉选择框让用户选项目 const project await tp.system.suggester( [产品项目, 前端重构, 数据看板], [产品项目, 前端重构, 数据看板] ); tR # 周报${monday} ~ ${sunday}\n\n; tR 所属项目${project}\n\n; % ## ✅ 本周完成 - [ ] ## 下周计划 - [ ] ## ⚠️ 风险与求助 -使用方法插入模板后从下拉框点选项目标题自动变成周报2026-08-17 ~ 2026-08-23全程零手输日期。五、问题速查高频报错与解决对策初学阶段最常见的坑基本都集中在下面这张表里遇到报错先对照排查现象原因对策弹窗变量拿到的是undefinedprompt、suggester是异步函数漏写了await在调用前加上await如const x await tp.system.prompt(...)想输出内容却一片空白用了%*执行命令它默认不输出把要输出的内容追加到tRtR 内容简单表达式直接用了%*两类命令用反了纯输出用% tp.date.now() %写逻辑用%* ... %上一个命令块的变量取不到每个%* %是独立作用域变量不跨块共享在同一个代码块内完成定义与使用动态命令% ... %不刷新动态命令只在预览时执行一次且结果会被缓存关闭笔记重新打开即可刷新频繁变动的信息慎用%弹窗被取消后流程中断取消时prompt返回null用if (name) { ... }判断后再拼接内容额外提醒两点动态命令%每预览一次就执行一次笔记里不要堆太多否则拖慢渲染模板里的字符串注意引号配对尤其是拼接中文和特殊字符时建议统一用反引号做模板字符串。六、更进一步官方文档与进阶路径跑通上面的案例后你已经具备了自己写模板的能力。想继续深入可以从这几个方向发力系统学习语法先读 docs/src/syntax.md掌握函数调用的参数规则再看 docs/src/commands/overview.md 了解插值命令、执行命令和动态命令的区别。逐个熟悉内置模块Templater 的全部内置功能都挂在tp对象下按模块组织。建议重点看这几个日期模块 docs/src/internal-functions/internal-modules/date-module.md文件模块 docs/src/internal-functions/internal-modules/file-module.md系统模块 docs/src/internal-functions/internal-modules/system-module.md全部模块索引 docs/src/internal-functions/overview.md配置自动化触发阅读 docs/src/settings.md学会用文件夹模板正则匹配启动模板让模板自动生效配合日记插件实现新建即套用。尝试用户函数当模板越来越长时把重复逻辑抽成独立函数参考 docs/src/user-functions/overview.md代码量能大幅减少。参与共建Templater 是开源项目欢迎阅读 CONTRIBUTING.md 和源码目录src/core/functions/动手添加你自己的内置函数。动起手来你的笔记系统会从每天复制粘贴进化为一次配置、自动产出。先从每日日记模板开始替换掉你手敲日期的那一步你会立刻感受到动态模板的魔力。之后每多掌握一个函数就多解放一次双手——祝你早日搭建出属于自己的模板库。【免费下载链接】TemplaterA template plugin for obsidian项目地址: https://gitcode.com/gh_mirrors/te/Templater创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考