告别Notion免费版导出限制：5分钟解锁批量PDF转换全攻略

你是否曾为Notion免费版无法直接导出PDF而困扰？作为知识工作者、学生或团队协作成员，我们经常需要将Notion页面转换为PDF格式以便分享、存档或打印。但免费版Notion仅支持HTML格式导出，手动处理大量文件不仅耗时还容易出错。本文将系统介绍如何利用notion-pdf-export工具实现批量PDF转换，从环境搭建到高级优化，让你5分钟内掌握这一高效工作流。

读完本文你将获得：

• 一套完整的Notion页面批量PDF转换方案
• 针对Windows/macOS系统的详细操作指南
• 常见错误排查与性能优化技巧
• 工具自定义与二次开发入门知识

工具原理解析：从HTML到PDF的转换魔法

notion-pdf-export工具采用模块化架构设计，通过多个核心组件协同工作实现从HTML到PDF的批量转换。其工作流程如下：

flowchart TD
    A[Notion HTML导出] --> B[文件预处理]
    B --> C{重命名为ASCII格式}
    C --> D[创建PDF输出目录]
    D --> E[移动资源文件]
    E --> F[HTML转PDF转换]
    F --> G[清理临时文件]
    G --> H[完成转换]

核心转换功能由convert_from_html.js模块实现，该模块使用wkhtmltopdf工具作为转换引擎：

let convertFromHtml = (htmlFiles, nextStep) => {
    console.log('\n\nHTML Files to be converted :')
    console.log(htmlFiles)
    
    let pdfDocs = []
    let cwdLength = path.join(process.cwd()).length
    htmlFiles.forEach((htmlFile) => {
        let pdfFileName = htmlFile.replace('.html', '.pdf')
        pdfFileName = pdfFileName.substring(cwdLength)
        pdfFileName = path.join(process.cwd(), 'pdfs', pdfFileName)
        pdfDocs.push(pdfFileName)
    })
    
    console.log('\nConverting HTML Files to PDF')
    htmlFiles.forEach((htmlFile, index) => {
        let htmlFilePath = path.join(htmlFile)
        console.log('\nConverting ' + htmlFile)
        createMissingFolders(pdfDocs[index])
        try{
            // 核心转换命令
            exec(wkhtmltopdf, ['--enable-local-file-access', htmlFilePath, pdfDocs[index]])
        }catch (exception){
            console.log('Error with converting ' + htmlFile)
        }
    })

    nextStep()
}

文件系统操作由create_missing_folders.js模块处理，确保输出目录结构正确：

let createMissingFolders = (filePath) => {
    let destination = path.dirname(filePath)
    fileSystem.mkdirSync(destination, {recursive: true})
}

环境准备：5分钟快速上手

系统要求

操作系统	最低配置要求	推荐配置
Windows	Windows 10+，4GB RAM	Windows 11，8GB RAM
macOS	macOS 10.13+，4GB RAM	macOS 12+，8GB RAM

安装步骤

方法一：直接下载预编译版本

1. 访问项目发布页面获取最新版本：

   • Windows: notion-pdf-export_windows_1.3.0.zip
   • macOS: notion-pdf-export_mac_1.3.0.zip

2. 解压下载的压缩包到本地文件夹

方法二：从源码构建

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/no/notion-pdf-export.git
   cd notion-pdf-export
   

2. 安装依赖：

   npm install
   

3. 安装nexe（用于编译可执行文件）：

   • Windows:

     install_nexe_win.bat
     

   • macOS:

     chmod +x install_nexe_mac
     ./install_nexe_mac
     

4. 编译可执行文件：

   • Windows:

     build_win32.bat
     

   • macOS:

     chmod +x build_macos
     ./build_macos
     

完整操作指南：从Notion页面到PDF文件

第一步：导出Notion页面为HTML

1. 在Notion中，选择需要导出的页面
2. 点击右上角的"..."菜单，选择"Export"
3. 在导出选项中：
   • 格式选择"HTML"
   • 勾选"Include subpages"（包含子页面）
   • 点击"Export"按钮
4. 等待导出完成，保存ZIP文件到本地

第二步：准备转换环境

1. 解压Notion导出的ZIP文件
2. 将解压得到的所有HTML文件和文件夹复制到notion-pdf-export工具所在目录

第三步：运行转换工具

Windows系统：

1. 双击运行notion-pdf-export.exe
2. 首次运行可能会出现Windows Defender SmartScreen警告，点击"更多信息"，然后选择"仍要运行"
3. 观察命令行窗口输出，等待转换完成

macOS系统：

1. 打开终端，导航到工具所在目录：

   cd /path/to/notion-pdf-export
   

2. 运行工具：

   chmod +x notion-pdf-export
   ./notion-pdf-export
   

3. 如果出现安全警告，需要在"系统偏好设置" > "安全性与隐私"中允许运行

第四步：获取转换结果

转换完成后，工具会在当前目录创建pdfs文件夹，所有转换后的PDF文件将按原始目录结构保存在该文件夹中。

常见问题与解决方案

转换失败问题排查

问题症状	可能原因	解决方案
命令窗口闪退后无反应	文件权限不足	以管理员身份运行或修改文件夹权限
部分页面转换失败	HTML文件路径包含中文/特殊字符	确保文件名仅包含ASCII字符
转换后的PDF缺少图片	资源文件路径错误	检查HTML文件中图片引用路径是否正确
macOS下提示"无法打开"	未授予执行权限	运行chmod +x notion-pdf-export

性能优化建议

对于包含大量页面（100+）的转换任务，可采用以下优化策略：

1. 分批次处理：将HTML文件分成多个文件夹，分批转换
2. 增加系统资源：关闭其他占用内存和CPU的应用程序
3. 修改转换参数：在convert_from_html.js中调整wkhtmltopdf参数：

   // 添加性能优化参数
   exec(wkhtmltopdf, [
     '--enable-local-file-access',
     '--dpi', '96',  // 降低DPI减少资源占用
     '--no-images',  // 如需纯文本可禁用图片
     htmlFilePath, 
     pdfDocs[index]
   ])
   

高级自定义：打造你的专属转换工具

notion-pdf-export的模块化设计使其易于扩展和自定义。以下是一些常见的自定义方向：

修改PDF页面样式

通过修改convert_from_html.js中的wkhtmltopdf参数，可以自定义PDF输出样式：

// 添加页面大小和边距设置
exec(wkhtmltopdf, [
  '--enable-local-file-access',
  '--page-size', 'A4',
  '--margin-top', '15mm',
  '--margin-right', '15mm',
  '--margin-bottom', '15mm',
  '--margin-left', '15mm',
  htmlFilePath, 
  pdfDocs[index]
])

添加水印功能

要为生成的PDF添加水印，可以扩展convert_from_html.js：

// 添加水印参数
exec(wkhtmltopdf, [
  '--enable-local-file-access',
  '--footer-center', 'CONFIDENTIAL',  // 页脚水印
  '--footer-font-size', '10',
  '--footer-spacing', '5',
  htmlFilePath, 
  pdfDocs[index]
])

实现PDF合并功能

如果需要将多个PDF文件合并为一个，可以添加新的模块merge_pdfs.js，使用pdf-lib等库实现合并功能：

// 伪代码示例：合并PDF文件
const { PDFDocument } = require('pdf-lib');
const fs = require('fs');

async function mergePDFs(inputPaths, outputPath) {
  const mergedPdf = await PDFDocument.create();
  
  for (const path of inputPaths) {
    const pdfBytes = await fs.promises.readFile(path);
    const pdfDoc = await PDFDocument.load(pdfBytes);
    const pages = await mergedPdf.copyPages(pdfDoc, pdfDoc.getPageIndices());
    pages.forEach(page => mergedPdf.addPage(page));
  }
  
  const mergedPdfBytes = await mergedPdf.save();
  await fs.promises.writeFile(outputPath, mergedPdfBytes);
}

module.exports = mergePDFs;

工具开发背后的技术细节

为什么选择wkhtmltopdf作为转换引擎？

wkhtmltopdf是一个将HTML/CSS转换为PDF的开源工具，相比其他方案具有以下优势：

• 对CSS布局和样式的支持更完善
• 支持本地文件访问，适合处理包含本地图片的HTML
• 轻量级且无需复杂的运行环境
• 支持命令行操作，易于集成到自动化流程

跨平台兼容性实现

为了实现Windows和macOS的跨平台支持，项目采用了以下策略：

1. 为不同平台提供专用的编译脚本
2. 在代码中通过process.platform判断当前系统：

   let isMac = process.platform === 'darwin'
   let wkhtmltopdf = path.join(process.cwd(), '/utils/wkhtmltopdf/wkhtmltopdf.exe')
   if(isMac){
       wkhtmltopdf = path.join(process.cwd(), '/utils/wkhtmltopdf/wkhtmltopdf')
   }
   

3. 针对macOS的特殊目录访问问题，使用shell脚本作为启动器

总结与展望

notion-pdf-export工具为Notion免费版用户提供了一个高效、可靠的批量PDF转换解决方案。通过本文介绍的方法，你可以轻松将Notion页面转换为PDF格式，突破官方导出限制。

随着项目的不断发展，未来可能会加入更多高级功能，如：

• 直接连接Notion API实现无手动导出转换
• 自定义PDF样式模板系统
• 云服务集成实现自动备份

如果你在使用过程中遇到问题或有功能建议，欢迎通过项目仓库提交issue或Pull Request参与项目贡献。

如果你觉得本工具对你有帮助，请给项目点赞和分享，让更多Notion用户受益！

下一篇教程预告：《Notion数据管理进阶：使用Python自动化处理导出内容》

附录：工具核心模块参考

主要功能模块说明

模块文件	功能描述	核心函数
convert_from_html.js	HTML转PDF核心转换	convertFromHtml(htmlFiles, nextStep)
create_missing_folders.js	创建必要的目录结构	createMissingFolders(filePath)
get_all_filepaths.js	获取所有HTML文件路径	getHtmlFiles()
move_assets.js	移动资源文件到输出目录	moveAssets(htmlFiles)
rename_to_ascii.js	将文件名转换为ASCII格式	renameToAscii()