Obsidian需借助Better Export PDF插件实现带页码、目录书签、自定义页眉页脚的PDF/HTML导出。安装方式包括插件市场启用或手动下载解压至.plugins目录;支持单文件导出、目录文件控制顺序合并导出、文件夹批量导出;HTML导出分原生基础版与插件增强版,后者保留主题色、内部链接及CSS模板配置。

你需要把Obsidian里整理好的笔记变成可打印、可分享的PDF或HTML文档,但官方导出功能无法添加页码、目录书签、自定义页眉页脚,也无法批量处理多个文件。
安装Better Export PDF插件
打开Obsidian设置 → 第三方插件 → 关闭安全模式(首次启用社区插件必做)→ 点击“浏览” → 搜索“Better Export PDF” → 找到后点击安装并启用。
如果插件市场无法加载,手动安装:访问 https://gitcode.com/gh_mirrors/ob/obsidian-better-export-pdf 下载最新zip包 → 解压至你的库目录下 【.obsidian/plugins/】 文件夹 → 重启Obsidian → 在插件管理中启用。
启用后,任意笔记右上角会出现“⋯”按钮,点击即可看到“Better Export PDF”选项。
立即学习“前端免费学习笔记(深入)”;
单文件导出为PDF(带预览与书签)
打开目标笔记 → 点击右上角“⋯” → 选择“Better Export PDF” → 弹出配置窗口。
在右侧实时预览区确认排版效果,左侧调整参数:页面尺寸选A4、边距设为12mm、开启“添加文件名作为标题”和“生成大纲书签” → 勾选“导出后自动打开PDF”。
这一步操作起来很简单,直接点击“Export”按钮,选择保存位置即可生成带可点击书签、页码和页眉的PDF。不勾选“生成大纲书签”,导出后PDF将没有左侧导航栏,长文档阅读时需手动翻页查找章节。
多文件合并导出为单个PDF
方法一:用目录文件控制顺序(推荐)
新建一个Markdown文件,命名为_toc.md → 在front matter中写入toc: true → 正文中按需顺序插入链接,例如:
- [[项目背景]]<br>- [[需求分析]]<br>- [[实施方案]]
→ 右键该文件 → 选择“Better Export PDF: Export current file to PDF”。
方法二:快速文件夹导出
在文件树中右键目标文件夹 → 选择“Export folder to PDF” → 插件会按字母顺序合并所有.md文件,自动生成目录。
【注意:目录文件中的链接必须使用双括号语法[[xxx]],且目标文件名必须完全一致,大小写敏感】
导出为HTML(保留交互与样式)
打开任意笔记 → 点击右上角“⋯” → 选择“Export to HTML”(此为Obsidian原生功能,无需插件)→ 选择保存路径 → 点击“导出”。
生成的HTML文件默认包含Obsidian基础样式,但无侧边栏、无内部跳转锚点。如需增强,可在设置 → 外观 → CSS片段中添加自定义样式,或配合Templater等插件注入导航结构。
若需导出含完整主题色、图床链接、双向链接可视化的HTML,必须启用Better Export PDF插件后,在其导出界面勾选“Export as HTML”选项——此时导出的HTML支持实时预览、嵌入CSS、保留内部链接跳转能力,且可复用PDF全部模板配置(如页眉HTML代码同样生效)。



















