浏览器工具自制指南·对话导出（0.1）：用 Pandoc 一站式搞定

阶进遐
26 阅读5分钟

前言

本文是「浏览器工具自制指南·对话导出」专栏的附录。​ 在开发浏览器脚本直接拦截网页对话之前，最初的方案是用 Pandoc 将对话记录从 Word 转成 Markdown。虽然最终主方案迭代为脚本直出，但 Pandoc 仍是本地文档转换的可靠工具，特此记录备查。

如果你手上有一堆 .docx 文件，想转成干净的 .md 用于 GitHub、Obsidian、静态博客或笔记软件，Pandoc 是目前最权威、最稳定的本地解决方案——免费开源、不需上传文件、支持批量脚本化处理。

Pandoc 官网明确将其定位为"通用文档转换器"（universal document converter），支持在 Markdown、HTML、PDF、LaTeX、EPUB、Microsoft Word docx、RTF、ODT 等数十种格式之间互转。

一、为什么选 Pandoc

相比 WPS 自带的"另存为 .md"或在线转换网站，Pandoc 的优势在于：

  • 本地处理：文档不出本机，隐私安全
  • 格式保留完整：标题层级、列表、表格、加粗、代码块、脚注都能较好转换
  • 可批量脚本化：适合 CI/CD 流水线或一次性处理上百个文件
  • 跨平台：Windows / macOS / Linux 全支持

二、下载链接

📌 官方入口

当前最新稳定版为 3.10.2。

截至本文写作时（2026 年 8 月），最新稳定版为 3.10.2。

📦 Windows 3.10.2 版直链（MSI 与 ZIP 均已核实）

MSI 安装包（推荐，双击安装自动配置 PATH）：

https://github.com/jgm/pandoc/releases/download/3.10.2/pandoc-3.10.2-windows-x86_64.msi

ZIP 便携版（解压后需手动配置 PATH）：

https://github.com/jgm/pandoc/releases/download/3.10.2/pandoc-3.10.2-windows-x86_64.zip

💡 下载小贴士：如果浏览器打开 GitHub 发布页较慢，直接复制上面的文件直链到迅雷或 IDM 等多线程下载工具即可拉取——Release 文件的下载直链走的是独立 CDN，通常比网页更通畅。

三、安装方式

方式 A：MSI 安装包（推荐）

  1. 双击 pandoc-3.10.2-windows-x86_64.msi
  2. 一路 Next 完成安装
  3. MSI 安装包会自动把 Pandoc 加入系统 PATH，无需手动配置

安装完成后打开 PowerShell 验证：

pandoc --version

看到 pandoc 3.10.2 即成功。

方式 B：ZIP 便携版

  1. 把 ZIP 解压到固定目录，例如 D:\Program Files\pandoc
  2. 此版本不会自动配置 PATH，需手动添加：
    • Win + S 搜索"环境变量" → 编辑系统环境变量 → 环境变量
    • 在"系统变量"中找到 Path → 编辑 → 新建
    • 填入解压目录路径（如 D:\Program Files\pandoc）
    • 确定保存，重新打开 PowerShell 窗口
  3. 验证：
pandoc --version

⚠️ ZIP 版配置完环境变量后，之前已打开的终端窗口不会刷新，必须新开一个 PowerShell 才能生效。

方式 C：包管理器一键装

winget install JohnMacFarlane.Pandoc
# 或
choco install pandoc

四、使用方式

1. 基础转换

最常用的命令，Pandoc 会自动根据扩展名推断输入输出格式：

pandoc input.docx -o output.md

2. 指定为 GitHub Flavored Markdown（推荐）

GitHub、Obsidian、GitBook、Notion 都兼容 GFM 语法：

pandoc -f docx -t gfm input.docx -o output.md

3. 提取图片到本地

Word 里嵌入的图片会被抽取到 ./media 目录，并在 .md 里自动生成引用：

pandoc input.docx -t gfm --extract-media=./media -o output.md

4. 不自动换行（适合 Git 版本管理）

pandoc input.docx -t gfm --wrap=none -o output.md

5. 批量转换（PowerShell）

把目录下所有 .docx 批量转成 .md：

Get-ChildItem -Filter "*.docx" | ForEach-Object {
    $output = [System.IO.Path]::ChangeExtension($_.Name, ".md")
    pandoc $_.FullName -t gfm --wrap=none -o $output
    Write-Host "Converted: $($_.Name) → $output"
}

五、适用范围

✅ Pandoc 擅长处理的

  • Word ↔ Markdown 双向转换（docx 与 Markdown 互转）
  • 标题层级、有序/无序列表、加粗、斜体、行内代码
  • 标准表格、代码块、脚注、引用块
  • 嵌入图片的提取与引用
  • 其他格式互转：HTML、PDF（需配 LaTeX）、EPUB、RTF、ODT、LaTeX、reStructuredText 等数十种格式

⚠️ 需要注意的边界

  • 复杂表格：合并单元格等复杂结构可能转换不完整
  • 批注与修订：Word 特有功能，Markdown 不支持，建议转换前"接受所有修订、删除批注"
  • 特殊字体/颜色/字号：Markdown 不表达样式，会丢失
  • 公式：可转 LaTeX 语法，但需在支持 MathJax 的渲染器中查看

📌 转换后务必人工校对一遍，尤其是表格和图片引用。

六、总结

Pandoc 是 Word 转 Markdown 的黄金标准工具：

  • 官方下载：github.com/jgm/pandoc/…
  • 3.10.2 Windows 直链：MSI 与 ZIP 两种包均已核实（见上文第二节）
  • 安装：MSI 双击即用；ZIP 解压后需手动加到 PATH
  • 使用：pandoc input.docx -t gfm -o output.md 一行命令搞定
  • 适用：个人文档迁移、技术写作发布、批量格式转换、CI/CD 自动化

相比 WPS 自带导出、Typora 复制粘贴或在线转换网站，Pandoc 在保真度、可控性、可批量处理三个维度上都明显胜出。唯一的学习成本是需要打开命令行——但只要你记住 pandoc 输入文件 -o 输出文件 这个骨架，剩下的参数都是按需添加的"调味料"。

装好 Pandoc，你的 .docx 文档就能丝滑迁移到 Markdown 世界了。🚀

后记：​ 本文方案最初用于将 AI 对话记录从 Word 转成 Markdown，但从对话到 Word 再转换，流程繁琐且对话内容易缺失。后续开发了浏览器脚本直接拦截网页对话流、自动生成 Markdown，详见本专栏正文。

本文首发于个人博客「阶进遐的技术随笔」
博客中配有完整专栏目录、可复制配置与长期更新，适合沉浸式阅读。
欢迎来博客逛逛，这边有任何疑问也可直接评论区交流。

avatar
文章
阅读
粉丝