第 2 章

模板设置

2026-03-24更新 2026-07-31

书籍模板决定了“添加书籍”后新建笔记文档的初始内容。模板只负责搭好框架,之后仍然可以像普通思源文档一样继续编辑。

在阅读工作台点击“模板”,可以看到三个入口:

  • 书籍笔记模板:通过豆瓣检索添加书籍时使用。
  • 微信读书书籍模板:同步微信读书中的普通书籍时使用。
  • 微信公众号模板:同步微信读书中的公众号文章时使用。

本章只讲第一个入口。微信读书的两套模板放在同步教程中说明。

读书笔记插件模板设置
书籍模板与微信读书模板分别保存,互不覆盖
微信读书同步
查看微信读书书籍模板、公众号模板和同步位置标记的设置方法。

控制笔记生成方式

模板设置顶部有两个开关:

设置作用
添加书籍时生成读书笔记作为添加书籍窗口中“生成读书笔记”的默认选择
使用思源模板渲染在替换书籍变量后,再交给思源模板引擎处理日期、函数等 .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{} 等内容会按普通文本保留下来。

模板没有生效时

  1. 确认已经点击编辑窗口中的“保存模板”。
  2. 确认添加书籍时勾选了“生成读书笔记”。
  3. 检查变量是否使用了完整的双大括号,并保持变量名与表格一致。
  4. 若只有 .action{} 等语法未渲染,检查“使用思源模板渲染”是否开启。
  5. 已经生成的旧文档不会因为修改模板自动重写;新模板用于之后创建的笔记。