多个 Markdown 文件批量转 Word:PowerShell + Pandoc,连同图片和公式一起检查

从 AI 网页批量导出对话后,手里可能有一批 .md 文件。Markdown 适合存档和搜索,交给同事修改时却常需要 .docx。逐个打开在线转换页很费时间;在 Windows 上可以用 Pandoc 一次转换一个目录中的多个文件。这里给出脚本,并说明哪些内容不能只凭"命令成功"判断。

先确认输入文件

建议把文件整理成下面的结构:

复制代码
ai-export/
├─ 讨论-01.md
├─ 讨论-02.md
├─ 讨论-03.md
└─ images/
   └─ chart.png

Markdown 中的图片如果写成 ![图](images/chart.png),转换时需要让 Pandoc 找得到这个相对路径。网页上的远程图片、浏览器里的附件或只有占位符的内容,不会因为转换命令而自动变成本地原文件。

文件来源可以是手工保存、AI 平台当前提供的导出功能,也可以是支持该页面的浏览器插件。比如鲸鱼AI助手官网说明其插件的"批量导出"可输出 Markdown、JSON、Word。这里使用的是已经拿到本地 .md 文件的情况;插件是否能覆盖账号全部历史会话,需要另看当前页面实际支持范围。

先试转一份

安装 Pandoc 后,在 PowerShell 里执行:

Powershell

复制代码
pandoc --from markdown --to docx "讨论-01.md" -o "讨论-01.docx"

打开结果,核对标题、表格、代码块和图片。Pandoc 官方手册说明它支持 Markdown 与 DOCX 转换,也提醒复杂格式之间的转换可能有损失,因此不能把"生成了 DOCX"当作内容完整的证明。

批量逐份转换

将 $sourceDir 改成自己的绝对路径。脚本只处理该目录第一层 的 .md 文件,每个 Markdown 生成一份同名 Word,输出到 _docx 子目录;原 Markdown 不会被覆盖。

Powershell

复制代码
$sourceDir = 'D:\ai-export'
$outDir = Join-Path $sourceDir '_docx'

if (-not (Get-Command pandoc -ErrorAction SilentlyContinue)) {
    throw '未找到 pandoc。请先安装并确认它在 PATH 中。'
}

New-Item -ItemType Directory -Path $outDir -Force | Out-Null
$failed = @()

Get-ChildItem -LiteralPath $sourceDir -Filter '*.md' -File | ForEach-Object {
    $source = $_.FullName
    $target = Join-Path $outDir ($_.BaseName + '.docx')

    & pandoc --from markdown --to docx --resource-path $sourceDir $source -o $target

    if ($LASTEXITCODE -ne 0 -or -not (Test-Path -LiteralPath $target)) {
        $failed += $_.Name
        Write-Warning "转换失败:$($_.Name)"
    } else {
        Write-Host "已生成:$target"
    }
}

if ($failed.Count -gt 0) {
    Write-Warning ("失败文件:" + ($failed -join '、'))
}

这里使用 --resource-path 告诉 Pandoc 到输入目录查找图片等资源。若各 .md 文件散落在不同子目录,应逐个目录处理,或调整资源路径;不要简单加 -Recurse 后假设相对图片路径还能正确解析。

公式、流程图和图片的边界

  • 公式 :$...$、$$...$$ 等 Pandoc 可识别的数学写法通常能参与转换,但复杂 LaTeX 宏、AI 输出的非标准定界符仍需在 Word 中逐个抽检。不要直接承诺所有公式均可编辑。

  • Mermaid 流程图 :标为 mermaid 的代码块只是图的源码。单靠上面的基础命令,不能保证它会变成 Word 里的流程图;应先把图渲染成图片并在 Markdown 中引用,或使用经过验证的过滤器。

  • 图片与附件 :--resource-path 解决的是本地资源查找,不负责下载网页附件。生成 Word 后还要确认图片真正嵌入,重要附件应另存。

  • 表格:普通 Markdown 表格通常能转换为 Word 表格,但合并单元格、嵌套表格和过宽表格需人工检查。

转换后的最小验收

随机抽取一份短文和一份长文,检查文件是否能打开、标题层级是否正确、表格行列是否完整。再选一份含公式或图片的文件,打开 Word 检查实际显示结果。失败文件按脚本警告逐个处理,别把输出目录里"有几个文件"当作成功率。

如果你最终只需要几份 Word,可直接从源 AI 网页选择 Word 导出;上面的批量脚本更适合已经有大量 Markdown、需要持续归档或统一二次转换的流程。

技术依据:Pandoc 官方《Pandoc User's Guide》(pandoc.org/MANUAL.html),包含输出格式、--resource-path 与格式转换限制说明。

相关推荐
世界是一片荒原11 小时前
给 DeepSeek Harness 做多会话工作台:四格原生会话、Agent 脉络图与压缩预警
deepseek
AI英德西牛仔20 小时前
智谱清言导出word指令失效?PC端深度用户正在用“AI导出鸭”重构内容归档流
人工智能·重构·word·excel·deepseek·ai导出鸭
Jahzo2 天前
DSH 客户端二开实战(四):业务登录如何接入原生桌面与本地 Host
架构·deepseek
小七-七牛开发者2 天前
Anthropic:Agent 不必一直运行,也能持续工作
agent·claude·deepseek·anthropic·alwaysonagent
大模型真好玩2 天前
做好真人分身却不知道拍什么?8个视频应用场景直接抄
人工智能·agent·deepseek
AI导出鸭PC端3 天前
纳米AI怎么复制表格?对话导出总是格式崩塌,我用“AI 导出鸭”重构了工作流
人工智能·重构·豆包·ai导出鸭
AI导出鸭PC端3 天前
用 AI 导出鸭高效处理:豆包导 pdf 怎么压缩但清晰
android·人工智能·pdf·豆包·ai导出鸭
木头左3 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
沉默王二3 天前
真狠啊,DeepSeek 开放全家桶 API。
人工智能·agent·deepseek
XLYcmy3 天前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 上
llm·prompt·模糊测试·漏洞修复·漏洞检测·deepseek·消融实验