如何将DocC创建的SDK文档导出为PDF文件？

DocC 本身没有提供原生一键导出PDF的功能，但可以通过导出静态站点+网页转PDF的路径实现，具体操作步骤如下：

步骤1：将DocC文档编译导出为本地可访问的静态站点 #

• 打开终端进入你的SDK项目根目录，执行DocC编译命令，将文档导出为归档文件：
  xcodebuild docbuild -scheme <替换为你SDK对应的Scheme名称> -derivedDataPath ./docc-temp-output
• 命令执行完成后，进入生成归档文件的目录：
  cd ./docc-temp-output/Build/Products/Debug-iphoneos
  该路径下后缀为.doccarchive的文件就是你编译好的DocC文档归档
• 在当前目录启动本地静态HTTP服务，用于正常加载DocC文档的路由、样式和资源：
  python3 -m http.server 8080
  启动完成后打开浏览器访问http://localhost:8080，确认所有文档页面、代码块、导航目录都能正常加载显示。

步骤2：将静态文档站点转换为PDF #

你可以根据自己的需求选两种常用转换方式：

方式一：浏览器直接导出（适合单次手动导出） #

• 在浏览器中打开本地运行的文档站点，按Command+P（macOS系统）或Ctrl+P（Windows系统）唤起系统打印面板
• 打印目标选择「另存为PDF」，在打印设置中勾选「背景图形」选项，调整合适的页边距、缩放比例，保证代码块、提示卡片、标题层级的样式和网页端一致
• 如果需要导出全量文档，可提前展开所有折叠的内容块，选择全页打印范围后确认导出即可。

方式二：命令行工具批量转换（适合自动化导出流程） #

• 本地安装命令行网页转PDF工具（比如wkhtmltopdf）
• 参考DocC生成的站点目录结构，写简单的遍历脚本按文档层级逐个抓取页面转换为PDF片段，最后将所有片段合并为单个完整PDF即可。

注意：如果你的DocC文档配置了自定义主题、第三方渲染扩展，导出前一定要在本地预览页确认所有特殊样式、交互内容都正常加载，避免导出后出现内容缺失、样式错乱的问题。

内容的提问来源于stack exchange，提问作者Rasul Mammadow