文件夹一键批量导出:Better Export PDF 如何把 100 篇笔记快速变成 100 个 PDF
【免费下载链接】obsidian-better-export-pdfObsidian PDF export enhancement plugin项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-better-export-pdf
如果你正在用 Obsidian 管理一个包含上百篇笔记的知识库,那么Better Export PDF的「文件夹一键批量导出」功能会是你最需要的能力——它在官方 PDF 导出之外,支持对整个文件夹的 Markdown 笔记进行批量导出:每个笔记自动变成一个独立 PDF,还附带导出预览、书签大纲、页码、页眉页脚等增强功能,让你 3 分钟内完成过去要花一下午的手动导出工作。
为什么官方导出搞不定"100 篇笔记"?
Obsidian 自带的 PDF 导出功能只有两个痛点:
- 只能导出当前笔记:100 篇笔记就要重复打开、导出 100 次;
- 没有导出前预览:页边距、页眉页脚、分页效果全靠"盲发"。
Better Export PDF 针对这些问题提供了两种文件夹级别的批量方案(详见 README.zh.md):
| 功能 | 入口 | 结果 |
|---|---|---|
| Export folder to PDF | 文件夹右键 | 全部笔记合并成一个 PDF |
| Export each file to PDF | 文件夹右键 → Export to PDF... | 每篇笔记独立生成一个 PDF |
本文聚焦第二种:批量导出成 100 个独立 PDF 文件。
一键批量导出:Export each file to PDF 完整步骤
第 1 步:在文件树右键文件夹
在 Obsidian 侧边栏找到目标文件夹,右键选择Export to PDF...,再选择子菜单Export each file to PDF。这两个菜单项的注册逻辑位于 src/main.ts:
右键文件夹 ├─ Export folder to PDF → 合并为一个 PDF └─ Export to PDF... ├─ Export each file to PDF ← 本文主角:逐个导出 └─ Generate TOC.md file → 一键生成目录笔记第 2 步:插件自动收集文件夹内所有笔记
选择菜单后,插件会递归遍历整个文件夹(包括所有子文件夹),筛选出全部.md文件并按名称排序,收集逻辑见 src/utils/index.ts 的traverseFolder函数。也就是说,你不需要手动勾选文件,100 篇笔记会被自动纳入导出清单。
第 3 步:在预览弹窗中确认配置
弹出的Export to PDF对话框支持导出前实时预览,可调整的配置包括:
- 📄Page size:纸张尺寸(A4 / 横向 / 自定义)
- 📐Margin:页边距(支持精确到毫米的自定义值)
- 📑Display header/footer:页眉页脚(默认自动生成
3 / 5样式的页码) - 🏷️Add filename as title:把笔记名作为 PDF 标题
- 🚀Open after export:导出完成后自动打开
如果沿用默认配置,直接按Enter或点击Export即可,不需要逐项修改。
第 4 步:选择输出目录,等待完成
选择一个输出文件夹即可——插件会为每篇笔记按"笔记名.pdf"的规则生成文件,比如笔记1.md输出为笔记1.pdf,同名互不覆盖、自动区分。输出目录的选择逻辑见 src/pdf.ts 的getOutputPath。
100 篇笔记通常在一两分钟内全部完成,全程无需人工干预。
幕后原理:并行渲染如何让批量导出不卡死
批量导出最耗时的是 Markdown 渲染环节。Better Export PDF 采用受控并发策略(src/components/PdfPreviewV2.svelte):
- 用
p-limit把渲染任务排成队列,默认同时渲染 5 篇笔记; - 每篇笔记独立生成预览 DOM,渲染完立即生成 PDF,互不阻塞;
- 渲染阶段有进度反馈,避免"点了没反应"的假死体验。
并发数可以在插件设置中调整——设置页的限制并发数(Limit concurrency)选项,见 src/setting.ts:
- 配置较低电脑:调小到
2~3,减少内存和 CPU 占用; - 追求速度:调大到
8以上,批量导出更快。
批量导出还能白赚这些增强功能
每个导出的 PDF 都独立享受官方导出没有的增强能力:
- 📚书签大纲:自动把标题层级写入 PDF 书签面板(默认最大到 h6,可在设置中调整);
- 🔗保留内部链接:笔记中的
[[双链]]在 PDF 里可点击跳转; - 🏷️PDF 元数据:frontmatter 中的
title、author、keywords等自动写入 PDF 属性; - 🎨打印 CSS 支持:
@media print代码片段、自定义分页(break-before: page)全部生效。
常见问题(FAQ)
Q:导出的是整个文件夹吗?会包含子文件夹的笔记吗?会。traverseFolder是递归遍历,子目录中的.md文件全部纳入;非 Markdown 文件自动跳过。
Q:100 篇笔记导出的文件会不会乱序?文件名与笔记一一对应(笔记名.pdf),不存在覆盖或混淆问题;若担心重名,可先重命名笔记。
Q:想导成一个 PDF 而不是 100 个怎么办?改用文件夹右键的Export folder to PDF菜单即可合并导出;若还想自定义阅读顺序,可用Generate TOC.md file先生成目录笔记,再导出该笔记。
总结
| 你的场景 | Better Export PDF 的解法 |
|---|---|
| 100 篇笔记 → 100 个 PDF | 右键文件夹 → Export each file to PDF,一键批量导出 |
| 100 篇笔记 → 1 个 PDF | 右键文件夹 → Export folder to PDF,合并导出 |
| 担心批量导出卡顿 | 设置页调整"限制并发数" |
把知识库整体备份、归档、分享给同事——现在只需一次右键。在 Obsidian 官方商店搜索Better Export PDF安装后即可使用(当前版本 2.0.3,仅限桌面端),配合本文步骤,把 100 篇笔记变成 100 个 PDF 从未如此简单。
【免费下载链接】obsidian-better-export-pdfObsidian PDF export enhancement plugin项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-better-export-pdf
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考