模板设置
书籍模板决定了“添加书籍”后新建笔记文档的初始内容。模板只负责搭好框架,之后仍然可以像普通思源文档一样继续编辑。
在阅读工作台点击“模板”,可以看到三个入口:
- 书籍笔记模板:通过豆瓣检索添加书籍时使用。
- 微信读书书籍模板:同步微信读书中的普通书籍时使用。
- 微信公众号模板:同步微信读书中的公众号文章时使用。
本章只讲第一个入口。微信读书的两套模板放在同步教程中说明。

控制笔记生成方式
模板设置顶部有两个开关:
| 设置 | 作用 |
|---|---|
| 添加书籍时生成读书笔记 | 作为添加书籍窗口中“生成读书笔记”的默认选择 |
| 使用思源模板渲染 | 在替换书籍变量后,再交给思源模板引擎处理日期、函数等 .action{} 语法 |
如果只使用普通 Markdown 和书籍变量,不需要开启“使用思源模板渲染”。
编辑书籍笔记模板
点击“书籍笔记模板”打开编辑窗口。模板使用 Markdown 编写,通过双大括号引用书籍信息,例如 {{书名}}、{{作者}} 和 {{ISBN}}。保存模板时,点击编辑窗口右上角的“保存模板”。

可以使用哪些变量
变量名与书籍数据库中的字段名一致。生成文档时,插件会把变量替换为当前书籍的实际内容。
| 变量 | 内容 |
|---|---|
{{书名}} | 书名 |
{{副标题}} | 副标题 |
{{原作名}} | 原作名 |
{{作者}} | 作者 |
{{封面}} | 下载到本地后的封面资源路径 |
{{译者}} | 译者 |
{{出版社}} | 出版社 |
{{出版年}} | 出版日期或出版年份 |
{{出品方}} | 出品方 |
{{丛书}} | 丛书或系列 |
{{ISBN}} | ISBN |
{{豆瓣评分}} | 豆瓣评分 |
{{评分人数}} | 豆瓣评分人数 |
{{定价}} | 定价 |
{{页数}} | 页数 |
{{装帧}} | 装帧信息 |
{{我的评分}} | 个人评分 |
{{书籍分类}} | 个人设置的书籍分类 |
{{阅读状态}} | 想读、在读、读完等个人状态 |
{{开始日期}} | 开始阅读日期 |
{{读完日期}} | 完成阅读日期 |
{{书籍简介}} | 书籍内容简介 |
{{作者介绍}} | 作者简介 |
不是每本书都有副标题、译者、出品方或丛书等信息。变量仍然可以保留在模板中,但对应数据不存在时,该位置会是空的。如果你不希望出现空行,可以删掉自己用不到的字段。
最小模板
只想快速建立一篇可继续书写的笔记,可以从下面这个版本开始:
# {{书名}}

- 作者:{{作者}}
- 出版社:{{出版社}}
- ISBN:{{ISBN}}
- 阅读状态:{{阅读状态}}
## 书籍简介
{{书籍简介}}
## 我的笔记{{封面}} 只是本地资源路径。想让封面直接显示为图片,需要写成 。
包含全部变量的模板
下面这个版本把所有可用字段都放了进去,适合作为修改素材。实际使用时,建议删除自己不需要的行,而不是强行保留全部字段。
# {{书名}} - {{副标题}}

## 基本信息
| 属性 | 内容 |
| --- | --- |
| 原作名 | {{原作名}} |
| 作者 | {{作者}} |
| 译者 | {{译者}} |
| 出版社 | {{出版社}} |
| 出版日期 | {{出版年}} |
| 出品方 | {{出品方}} |
| 丛书 | {{丛书}} |
| ISBN | `{{ISBN}}` |
| 页数 | {{页数}} |
| 定价 | {{定价}} |
| 装帧 | {{装帧}} |
| 分类 | {{书籍分类}} |
## 豆瓣信息
- 豆瓣评分:{{豆瓣评分}}
- 评分人数:{{评分人数}}
## 书籍简介
{{书籍简介}}
## 作者介绍
{{作者介绍}}
## 我的阅读记录
- 阅读状态:{{阅读状态}}
- 我的评分:{{我的评分}}
- 开始阅读:{{开始日期}}
- 完成阅读:{{读完日期}}
## 读书笔记
### 读书心得
### 摘录精选修改这份模板只会影响之后新建的读书笔记,不会自动重写已经存在的文档。你可以把模板理解为“新建文档时使用的底稿”。
使用思源模板渲染
开启“使用思源模板渲染”后,插件会先替换书籍变量,再调用思源模板引擎渲染剩余内容。因此除了书籍字段,还可以使用 .action{}、{{{col 等思源内置模板语法,实现当前时间、星期和分栏布局。
下面是旧教程中的完整高级模板,保留了日期计算、阅读状态、封面与图书信息分栏。它可以直接复制,再按自己的页面习惯删改:
.action{$week := add (mod (div ((toDate "2006-01-02" "2050-03-13").Sub now).Hours 24) 7) 1}
{{{col
{{{
创建时间:.action{now | date "2006-01-02 15:04"} .action{last (slice (list "星期六" "星期五" "星期四" "星期三" "星期二" "星期一" "星期天") 0 $week )}
}}}
{{{
阅读状态:{{阅读状态}}
}}}
}}}
---
{{{col
{{{

}}}
{{{
| 属性 | 内容 |
| --- | --- |
| 书名 | {{书名}}:{{副标题}} |
| 作者 | {{作者}} |
| 分类 | {{书籍分类}} |
| 出版社 | {{出版社}} |
| 出版日期 | {{出版年}} |
| 豆瓣地址 | [{{书名}}](https://douban.com/isbn/{{ISBN}}) |
| 豆瓣评分 | {{豆瓣评分}} / {{评分人数}} 人 |
| 我的评分 | {{我的评分}} |
}}}
}}}
---
## 书籍简介
{{书籍简介}}
## 书评
先确认普通 Markdown 模板能正常生成,再开启思源模板渲染。这样出现格式问题时,更容易判断是书籍变量还是思源模板语法造成的。
两种变量不要混淆
| 写法 | 由谁处理 | 示例 |
|---|---|---|
{{书名}} | 读书笔记插件 | 把当前书名写入文档 |
.action{}、{{{col | 思源模板引擎 | 计算时间、调用函数或生成分栏 |
如果关闭“使用思源模板渲染”,书籍变量仍然会替换,但 .action{} 等内容会按普通文本保留下来。
模板没有生效时
- 确认已经点击编辑窗口中的“保存模板”。
- 确认添加书籍时勾选了“生成读书笔记”。
- 检查变量是否使用了完整的双大括号,并保持变量名与表格一致。
- 若只有
.action{}等语法未渲染,检查“使用思源模板渲染”是否开启。 - 已经生成的旧文档不会因为修改模板自动重写;新模板用于之后创建的笔记。