使用Apifox写的接口,如何生成PDF/Word接口文档?(包含Markdown转PDF,PDF转Word)

2,404 阅读2分钟

一:背景介绍:

项目开发阶段已完成,接口由后端记录在Apifox上,接口已完成联调; 目前是项目验收阶段,需要写Word版本的接口文档。本篇文章主要介绍,怎么把Apifox上的接口,快速生成PDF/Word接口文档(包含Markdown转PDF,PDF转Word)。

注意:Apifox 目前不支持直接导出为 PDF 或 Word 格式,但你可以先导出为 Markdown 格式,然后使用外部工具进行转换。

二:步骤:

1.把Apifox上的接口,右键导出为Markdown文件;

image.png image.png

image.png

2.把Markdown文件转为PDF文件(直接转成Word会有排版错乱问题)。

目前我是借助 VSCode 中 Markdown PDF 这个插件来转换的。如果你已经安装了此插件,可以忽略安装步骤。

2.1 查找Markdown PDF插件,进行安装。

image.png

2.2 配置executablePath。

在settings中搜索Markdown PDF,找到executablePath配置项,填入chrome安装路径,例如:C:\Users\AppData\Local\Google\Chrome\Application\chrome.exe,具体操作如图:

image.png 添加后,settings.json文件会自动生成markdown-pdf.executablePath配置,也可直接在这里手动添加。

"markdown-pdf.executablePath": "C:\\Users\\AppData\\Local\\Google\\Chrome\\Application\\chrome.exe"

image.png

2.3 安装成功后,右键会出现Markdown PDF,选择pdf,进行导出;导出后原文件同级目录下会生成同名pdf文件。

image.png

image.png

image.png

3.PDF转为Word文件。

以下DeepSeek推荐的免费 PDF 转 Word 工具及使用指南,涵盖在线和离线方案,确保安全性和实用性:


一、在线转换工具(无需安装)

1. iLovePDF

  • 网址:www.ilovepdf.com/pdf_to_word

  • 优势

    • 完全免费,无隐藏收费
    • 保留原始格式(表格/图片/字体)
    • 支持批量转换(最多同时10个文件)
  • 限制

    • 单文件最大限制:50MB
    • 文件在服务器保留2小时后自动删除

2. Smallpdf

  • 网址:smallpdf.com/pdf-to-word

  • 特点

    • 简洁易用,支持拖拽上传
    • OCR 文字识别(扫描版PDF可转换)
  • 注意

    • 免费版每小时限2次转换
    • 需通过邮箱接收转换后的文件

3. PDF24 Tools


二、离线软件(保护隐私)

1. LibreOffice(开源免费)

  • 下载:www.libreoffice.org/

  • 操作步骤

    1. 安装后打开 LibreOffice Writer
    2. 文件 → 打开 → 选择PDF文件
    3. 另存为 .docx 格式
  • 注意

    • 复杂排版可能略有偏差
    • 适合文本为主的PDF

2. WPS Office(免费基础功能)

  • 下载:www.wps.cn/

  • 方法

    • 用WPS打开PDF → 点击「PDF转Word」按钮
  • 限制

    • 免费用户每日限3次转换
    • 会员解锁批量处理和更高精度

3. PDFgear(全功能免费)

  • 下载:www.pdfgear.com/

  • 优势

    • 支持OCR识别扫描件
    • 转换后可直接编辑Word

三、转换效果对比

工具格式保留OCR支持批量处理适用场景
iLovePDF★★★★☆常规文档
WPS Office★★★☆☆简单快速转换
PDFgear★★★★☆扫描件/复杂排版
LibreOffice★★☆☆☆隐私敏感文件

4. 可自行选择工具,选择后生成word文件如下:

image.png