操作环境
- Windows 11 24H2
前置环境
-
请先完成 Rust 环境的配置，可参考 Windows 下 Rust 开发环境部署：GNU 工具链及镜像优化。
-
使用 cargo 安装 mdBook ：
cargo install mdbook mdbook --version # 验证
安装 mdBook-pandoc 插件
使用 cargo ：
cargo install mdbook-pandoc
安装 Pandoc
下载地址：Github
法一：下载 pandoc-版本号-windows-x86_64.msi 安装程序，运行并按照提示完成安装。
法二：下载压缩包（pandoc-版本号-windows-x86_64.zip），并解压到合适的地方，将 <Pandoc 文件夹路径>\pandoc-x.x.x 添加到系统环境变量 Path。
验证：
pandoc --version # 验证
安装 Pandoc 依赖 XeLaTeX
本文使用 TeX Live 安装 XeLaTeX。
TeX Live 官网：https://tug.org/texlive/
TeX Live 下载地址：https://tug.org/texlive/acquire-iso.html
北大镜像站：https://mirrors.pku.edu.cn/ctan/systems/texlive/Images/
-
下载安装文件（如
texlive2025-20250308.iso）并解压。 -
右键
install-tl-windows.bat→ 以管理员身份运行。 -
首先会短暂出现一个窗口，表示正在加载文件，稍后该窗口关闭，弹出安装窗口。
-
安装界面
- 修改安装路径（可选，不建议放 C 盘，软件很大）。
- 建议取消勾选
安装 TeXworks 前端选项（因为没啥用）。 - 高级用户可点
Advanced自定义。
-
点击 安装，等待完成（约 40 – 80 min）。
-
当安装窗口右下角
关闭按钮亮起时，安装完毕，此时打开终端，输入：
xelatex -v # 验证
配置 book.toml
编辑项目根目录 book.toml，示例：
[book]
title = "书名"
authors = ["作者"]
language = "zh" # 语言
[output.pandoc]
[output.pandoc.profile.pdf]
output-file = "output.pdf"
to = "latex" # output format
pdf-engine = "xelatex"
file-scope = true
number-sections = true
standalone = true # 使用合适的 header 和 footer
table-of-contents = true
[output.pandoc.profile.pdf.variables]
lang = "zh_CN.UTF-8"
mainfont = "STKaiti" # 字体，比如 STSong 是宋体，STKaiti 是楷体
geometry = "top=2cm,bottom=2cm,left=2.5cm,right=2.5cm" # 页边距
fontsize = "10pt" # 字体大小，默认10pt
构建 PDF
一切配置完成后，在项目根目录执行：
mdbook build
构建完成后，生成文件位于 .\book\pdf 目录下。