一:背景介绍:
项目开发阶段已完成,接口由后端记录在Apifox上,接口已完成联调; 目前是项目验收阶段,需要写Word版本的接口文档。本篇文章主要介绍,怎么把Apifox上的接口,快速生成PDF/Word接口文档(包含Markdown转PDF,PDF转Word)。
注意:Apifox 目前不支持直接导出为 PDF 或 Word 格式,但你可以先导出为 Markdown 格式,然后使用外部工具进行转换。
二:步骤:
1.把Apifox上的接口,右键导出为Markdown文件;
2.把Markdown文件转为PDF文件(直接转成Word会有排版错乱问题)。
目前我是借助 VSCode 中 Markdown PDF 这个插件来转换的。如果你已经安装了此插件,可以忽略安装步骤。
2.1 查找Markdown PDF插件,进行安装。
2.2 配置executablePath。
在settings中搜索Markdown PDF,找到executablePath配置项,填入chrome安装路径,例如:C:\Users\AppData\Local\Google\Chrome\Application\chrome.exe,具体操作如图:
添加后,settings.json文件会自动生成markdown-pdf.executablePath配置,也可直接在这里手动添加。
"markdown-pdf.executablePath": "C:\\Users\\AppData\\Local\\Google\\Chrome\\Application\\chrome.exe"
2.3 安装成功后,右键会出现Markdown PDF,选择pdf,进行导出;导出后原文件同级目录下会生成同名pdf文件。
3.PDF转为Word文件。
以下DeepSeek推荐的免费 PDF 转 Word 工具及使用指南,涵盖在线和离线方案,确保安全性和实用性:
一、在线转换工具(无需安装)
1. iLovePDF
-
优势:
- 完全免费,无隐藏收费
- 保留原始格式(表格/图片/字体)
- 支持批量转换(最多同时10个文件)
-
限制:
- 单文件最大限制:50MB
- 文件在服务器保留2小时后自动删除
2. Smallpdf
-
特点:
- 简洁易用,支持拖拽上传
- OCR 文字识别(扫描版PDF可转换)
-
注意:
- 免费版每小时限2次转换
- 需通过邮箱接收转换后的文件
3. PDF24 Tools
-
亮点:
- 无广告,支持离线模式(下载桌面版)
- 可自定义页面范围转换
二、离线软件(保护隐私)
1. LibreOffice(开源免费)
-
操作步骤:
- 安装后打开 LibreOffice Writer
- 文件 → 打开 → 选择PDF文件
- 另存为
.docx格式
-
注意:
- 复杂排版可能略有偏差
- 适合文本为主的PDF
2. WPS Office(免费基础功能)
-
下载:www.wps.cn/
-
方法:
- 用WPS打开PDF → 点击「PDF转Word」按钮
-
限制:
- 免费用户每日限3次转换
- 会员解锁批量处理和更高精度
3. PDFgear(全功能免费)
-
优势:
- 支持OCR识别扫描件
- 转换后可直接编辑Word
三、转换效果对比
| 工具 | 格式保留 | OCR支持 | 批量处理 | 适用场景 |
|---|---|---|---|---|
| iLovePDF | ★★★★☆ | ❌ | ✅ | 常规文档 |
| WPS Office | ★★★☆☆ | ✅ | ❌ | 简单快速转换 |
| PDFgear | ★★★★☆ | ✅ | ✅ | 扫描件/复杂排版 |
| LibreOffice | ★★☆☆☆ | ❌ | ✅ | 隐私敏感文件 |