300 lines
9.8 KiB
Markdown
300 lines
9.8 KiB
Markdown
#临时/备忘
|
||
|
||
#状态/待处理
|
||
|
||
---
|
||
## 一句话描述
|
||
|
||
[__整理归纳______]
|
||
|
||
### 分解步骤
|
||
|
||
1. [________]
|
||
2. [________]
|
||
3. [________]
|
||
|
||
|
||
---
|
||
|
||
|
||
## 一句话描述
|
||
|
||
[________]
|
||
|
||
## 一句话描述
|
||
|
||
Obsidian 的 Templater 插件是帮你一键生成固定格式笔记的懒人神器，新手不用写复杂代码，靠简单指令就能搞定日记、读书笔记等日常笔记模板，快速上手出成果。
|
||
|
||
|
||
|
||
|
||
|
||
## ✨ 二、模板嵌套 专属语法区（你重点要的，置顶！）
|
||
|
||
> 优先级最高，新手最常用，所有嵌套需求都靠这部分，**这是核心中的核心**
|
||
|
||
### ✅ 核心嵌套语法（唯一，背下来）
|
||
|
||
`<% tp.file.include("[[子模板名称]]") %>`
|
||
|
||
▸ 效果：在当前模板中，原封不动插入「子模板」的全部内容
|
||
|
||
▸ 新手提示：模板名**一字不差**（含空格 / 标点），比如`[[习惯打卡模板]]`、`[[书籍信息模板]]`
|
||
|
||
### ✅ 多模板嵌套（想加几个加几个）
|
||
|
||
```plaintext
|
||
<% tp.file.include("[[子模板1]]") %>
|
||
<% tp.file.include("[[子模板2]]") %>
|
||
```
|
||
|
||
▸ 效果：在主模板里同时插入多个子模板，比如「日记 + 打卡 + 复盘」一起生成
|
||
|
||
### ✅ 嵌套 + 变量组合（最实用写法，直接复制）
|
||
|
||
plaintext
|
||
|
||
```plaintext
|
||
# <% tp.date.now("YYYY-MM-DD") %> 每日记录
|
||
<% tp.file.include("[[习惯打卡模板]]") %>
|
||
今日感悟：<% tp.cursor() %>
|
||
```
|
||
|
||
▸ 效果：自动日期 + 嵌套打卡 + 光标定位，一步到位生成完整笔记
|
||
|
||
---
|
||
|
||
## ✨ 三、高频日期 & 时间变量（使用率 99%，必记！）
|
||
|
||
日常写日记、读书笔记、计划最常用，格式可直接改，按需复制，不用记格式规则
|
||
|
||
### ✔️ 基础常用（优先记这 3 个）
|
||
|
||
`<% tp.date.now("YYYY-MM-DD") %>` → 自动生成【当天日期】 例：2026-01-15
|
||
|
||
`<% tp.date.now("YYYY年MM月DD日") %>` → 中文日期格式 例：2026 年 01 月 15 日
|
||
|
||
`<% tp.date.now("HH:mm") %>` → 自动生成【当前时间】 例：20:30
|
||
|
||
### ✔️ 进阶日期（够用就行，不用多记）
|
||
|
||
`<% tp.date.now("YYYY-MM-DD HH:mm") %>` → 日期 + 时间 例：2026-01-15 20:30
|
||
|
||
`<% tp.date.now("YYYY-MM-DD 周DD") %>` → 日期 + 星期 例：2026-01-15 周四
|
||
|
||
`<% tp.date.yesterday("YYYY-MM-DD") %>` → 昨天的日期
|
||
|
||
`<% tp.date.tomorrow("YYYY-MM-DD") %>` → 明天的日期
|
||
|
||
`<% tp.date.now("WW") %>` → 本年第几周 例：02
|
||
|
||
`<% tp.date.now("MM") %>` → 当月月份 例：01
|
||
|
||
### ✔️ 新手小技巧
|
||
|
||
日期里的符号可自定义：比如想写「26.01.15」，就写成 `<% tp.date.now("YY.MM.DD") %>`
|
||
|
||
---
|
||
|
||
## ✨ 四、光标 & 输入交互类语法（新手刚需，超好用）
|
||
|
||
让你的模板「更智能」，不用手动点光标、不用手动改标题，懒人必备，全部高频！
|
||
|
||
`<% tp.cursor() %>` → 生成模板后，光标**自动定位到这个位置**，直接打字不用点
|
||
|
||
`<% tp.system.prompt("请输入内容") %>` → 调用模板时，弹出输入框，输入的内容会自动填充
|
||
|
||
▶ 示例：`# <% tp.system.prompt("输入书名：") %> 读书笔记` → 弹窗填书名，自动生成标题
|
||
|
||
`<% tp.system.suggester(["选项1","选项2"],["选项1","选项2"]) %>` → 弹窗选择内容（比如选天气）
|
||
|
||
▶ 示例：`天气：<% tp.system.suggester(["晴","雨","阴","雪"],["晴","雨","阴","雪"]) %>`
|
||
|
||
---
|
||
|
||
## ✨ 五、文件 / 标题相关语法（读书笔记 / 项目笔记必备）
|
||
|
||
不用手动改标题、不用手动建链接，适合做系统化笔记，新手记 2 个高频的就够
|
||
|
||
`<% tp.file.title %>` → 自动获取「当前笔记的标题」，适合读书笔记 / 项目笔记
|
||
|
||
`<% tp.file.rename( tp.system.prompt("请输入新标题") ) %>` → 调用模板时，直接重命名笔记
|
||
|
||
<%* tp.file.rename( tp.date.now("YYYYMMDD") + " - " + await tp.system.prompt("✅ 请输入笔记标题：") ) %>→ 调用模板时，直接重命名笔记为组合内容
|
||
|
||
|
||
`[[<% tp.file.title %>]]` → 自动生成当前笔记的内部链接，方便跳转
|
||
|
||
|
||
>`<%* %>` 属于异步执行
|
||
|
||
## ✅ 六、【加餐】3 个「重命名高频实用写法」（直接复制，日常最常用，覆盖 90% 场景）
|
||
|
||
都是你刚需的场景，全部是「异步 + 重命名 + 日期 + 弹窗」的完美组合，**直接复制到你的模板里就能用**，不用改任何东西：
|
||
|
||
### ✔️ 写法 1：日记专用 → 日期 + 自定义标题 （你的需求）
|
||
|
||
js
|
||
|
||
```js
|
||
<%* tp.file.rename( tp.date.now("YYYYMMDD") + " - " + await tp.system.prompt("请输入日记标题：") ) %>
|
||
```
|
||
|
||
✅ 效果：`20260115 - 周四感悟`
|
||
|
||
### ✔️ 写法 2：读书笔记专用 → 日期 + 书名（弹窗输入）
|
||
|
||
js
|
||
|
||
```js
|
||
<%* tp.file.rename( tp.date.now("YYYY-MM-DD") + " 读书笔记 - " + await tp.system.prompt("请输入书籍名称：") ) %>
|
||
```
|
||
|
||
✅ 效果：`2026-01-15 读书笔记 - 被讨厌的勇气`
|
||
|
||
### ✔️ 写法 3：极简无固定文字 → 只生成「弹窗输入的标题」
|
||
|
||
js
|
||
|
||
```js
|
||
<%* tp.file.rename( await tp.system.prompt("请输入笔记标题：") ) %>
|
||
```
|
||
|
||
## ✅ 背诵级・核心浓缩（新增异步重命名，最终终极版，3 句话记牢所有核心）
|
||
|
||
不用背所有语法，这 3 句话 = Templater **全部核心 + 所有避坑点**，学会后再也不会出错，覆盖 100% 需求：
|
||
|
||
1. 同步用 `<% %>`，异步用 `<%* %>`，弹窗必加 `await`，注释用 `<%* %>`；
|
||
2. 嵌套必写 `tp.file.include("[[模板名]]")`，日期必写 `tp.date.now("格式")`，光标必写 `tp.cursor()`；
|
||
3. 调用模板唯一正确方式：右键→Insert Template，重命名报错只查「*」和「await」两个点。
|
||
---
|
||
|
||
## ✨ 六、文本快捷语法（锦上添花，减少打字）
|
||
|
||
简单好用，不用手动敲格式，适合做笔记时快速生成固定文本，按需复制
|
||
|
||
`<% "——————————————————" %>` → 自动生成分割线，美化笔记排版
|
||
|
||
`<% tp.file.selection() %>` → 自动插入你「选中的文本」（比如摘抄的句子）
|
||
|
||
`<% tp.util.random_item(["内容1","内容2","内容3"]) %>` → 随机生成其中一个内容（适合每日一句 / 灵感）
|
||
|
||
---
|
||
|
||
## ✨ 七、新手高频避坑速查（语法失效？先看这里！）
|
||
|
||
### ❌ 问题 1：语法写了，生成后是空白 / 原封不动显示语法
|
||
|
||
▸ 原因：① 少了`<% %>`包裹 ② 符号用了中文 ③ 插件没启用
|
||
|
||
▸ 解决：直接复制速查表的语法，不要手动敲；检查插件是否启用，重启 Obsidian
|
||
|
||
### ❌ 问题 2：模板嵌套后，子模板内容不显示
|
||
|
||
▸ 原因：① 子模板名写错 ② 子模板没放在「模板文件夹」里 ③ 少了双中括号`[[ ]]`
|
||
|
||
▸ 解决：核对模板名（一字不差），把子模板拖进指定文件夹，用速查表的嵌套语法
|
||
|
||
### ❌ 问题 3：日期 / 变量生成的格式不对
|
||
|
||
▸ 原因：格式没加英文引号，比如写成`tp.date.now(YYYY-MM-DD)`
|
||
|
||
▸ 解决：所有日期格式必须加引号 → `tp.date.now("YYYY-MM-DD")`
|
||
|
||
### ❌ 问题 4：调用模板后，变量没自动更新
|
||
|
||
▸ 原因：用了「复制粘贴模板」，不是用「Insert Template」调用
|
||
|
||
▸ 解决：严格按右键→Insert Template 调用，这是唯一正确方式
|
||
|
||
### ✅ 避坑总结（一句话记牢）
|
||
|
||
**符号不错、路径不错、调用不错，语法就一定生效！**
|
||
|
||
---
|
||
|
||
## ✨ 八、新手必存「现成组合模板」（直接复制保存，0 修改即用）
|
||
|
||
不用自己拼语法，3 个最常用的场景，全部是「基础语法 + 嵌套 + 变量」的完美组合，**复制到你的模板文件夹，立刻能用**，覆盖 90% 日常需求！
|
||
|
||
### ✔️ 模板 1：终极日记模板（日记 + 打卡 + 复盘，嵌套版）
|
||
|
||
plaintext
|
||
|
||
```plaintext
|
||
# <% tp.date.now("YYYY年MM月DD日 周DD") %> 我的日记
|
||
天气：<% tp.system.suggester(["晴","阴","雨","雪"],["晴","阴","雨","雪"]) %>
|
||
心情：______
|
||
|
||
## ✅ 今日待办
|
||
1. ______
|
||
2. ______
|
||
|
||
<% tp.file.include("[[习惯打卡模板]]") %>
|
||
|
||
## ✨ 今日复盘
|
||
完成的事：______
|
||
未完成的事：______
|
||
明日计划：______
|
||
|
||
今日感悟：
|
||
<% tp.cursor() %>
|
||
```
|
||
|
||
### ✔️ 模板 2：终极读书笔记模板（书籍信息 + 摘抄 + 感悟，嵌套版）
|
||
|
||
plaintext
|
||
|
||
```plaintext
|
||
# <% tp.system.prompt("请输入书名：") %> 读书笔记 | <% tp.date.now("YYYY-MM-DD") %>
|
||
<% tp.file.include("[[书籍信息模板]]") %>
|
||
|
||
## ✍️ 金句摘抄
|
||
1. ______
|
||
2. ______
|
||
|
||
## 💡 我的思考
|
||
收获：______
|
||
启发：______
|
||
行动清单：______
|
||
|
||
<% tp.cursor() %>
|
||
```
|
||
|
||
### ✔️ 模板 3：周计划模板（周目标 + 每日计划，嵌套版）
|
||
|
||
plaintext
|
||
|
||
```plaintext
|
||
# 2026年第<% tp.date.now("WW") %>周 周计划
|
||
本周核心目标：______
|
||
|
||
## 周一 | <% tp.date.now("YYYY-MM-DD") %>
|
||
<% tp.file.include("[[日计划模板]]") %>
|
||
|
||
## 周二 | <% tp.date.add(tp.date.now(),1,"d","YYYY-MM-DD") %>
|
||
<% tp.file.include("[[日计划模板]]") %>
|
||
|
||
## 周三 | <% tp.date.add(tp.date.now(),2,"d","YYYY-MM-DD") %>
|
||
<% tp.file.include("[[日计划模板]]") %>
|
||
```
|
||
|
||
---
|
||
|
||
## ✨ 九、背诵级・核心浓缩（3 句话，记牢就够用）
|
||
|
||
不用背所有语法，记好这 3 句，Templater 的核心就掌握了，日常笔记完全够用：
|
||
|
||
1. 所有语法必写 `<% %>`，嵌套必写 `tp.file.include("[[模板名]]")`
|
||
2. 高频三板斧：自动日期 `tp.date.now()` + 光标定位 `tp.cursor()` + 弹窗输入 `tp.system.prompt()`
|
||
3. 调用模板唯一正确方式：右键 → Insert Template
|
||
|
||
---
|
||
|
||
## ✨ 最后小提醒
|
||
|
||
你现在已经掌握了 Templater 所有「新手必学的核心语法」，包括嵌套、日期、光标、交互，这些内容能覆盖你 **95% 的日常笔记需求**（日记、读书笔记、计划、打卡、复盘）。
|
||
|
||
不用追求学完所有冷门语法，Templater 的本质就是「帮你省时间、少打字」，咱们新手的目标就是：**一键生成模板 → 填内容 → 完成笔记**，简单高效就好～
|
||
|
||
慢慢积累你的模板库，你会发现写笔记的效率直接翻倍，这就是这个插件最棒的价值啦！✨ |