Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Last updated: Monday 07 September 2026 @ 20:44:27

mdbook-reading-time 操作手册

mdbook-reading-time 用于计算当前章节的字词数量和预计阅读时间。

原仓库:https://github.com/pawurb/mdbook-reading-time

本页实际结果

本页字词数:484

预计阅读时间:1 minute

这两个值由插件在构建时替换。

两个核心占位符

插件不会自动把结果插到页面中,需要在 Markdown 中主动放置占位符。

字词数

484

构建后替换为当前章节的 word count。

阅读时间

1 minute

构建后替换为类似:

9 minutes

样例:文章标题下显示阅读信息

# FlowANN

> 484 words · 1 minute

正文……

样例:只显示预计阅读时间

预计阅读:1 minute

当前配置

[preprocessor.reading-time]
words-per-minute = 250

插件默认是 200 WPM;当前书库改为 250 WPM。

概念上的计算关系是:

reading time ≈ word count / words-per-minute

例如:

1000 words / 250 WPM ≈ 4 minutes

调整阅读速度

希望预计时间更长,可以降低 WPM:

[preprocessor.reading-time]
words-per-minute = 180

希望预计时间更短,可以提高 WPM:

[preprocessor.reading-time]
words-per-minute = 300

这个参数只影响 reading_time,不会改变 word_count。

常用放置位置

标题下方

# 文章标题

> 484 words · 1 minute

正文末尾

---

全文 484 words。

Frontmatter 卡片之后

如果页面同时使用 mdbook-frontmatter-render,可把阅读信息放在属性卡之后、正文之前。

中文与论文笔记

插件输出的是自身统计得到的 word count,再按 WPM 换算时间。中文、公式密集或代码很多的页面,应把结果理解为粗略阅读成本,而不是严格计时。

如果需要校准,选几篇你实际读过的长文,对照真实耗时后统一调整 words-per-minute 即可。