为 Typora 配置 Pandoc：用真实 DOCX 与 EPUB 验证导出链路

Typora 的导出菜单里已经出现 DOCX 与 EPUB，但选择后无法启动转换器。编辑器本身工作正常，原生输出路径也没有异常。缺失的环节是这些扩展格式依赖的外部程序。

Typora 官方文档说明，HTML、PDF 和图片可以直接输出，Word、RTF、EPUB 等格式则会调用 Pandoc。文档还建议安装后重启应用；若仍无法发现 Pandoc，应在导出设置中手动选择其可执行文件（Typora 导出文档）。

本次处理严格限制范围：先确认转换器状态，只安装一份 Pandoc，显式绑定可执行文件，再检查真实 DOCX 与 EPUB 包。流程没有增加 PDF 引擎，也没有改写其他 Typora 高级配置。

导出菜单不能证明转换器已经可用

初始检查把 Typora 界面和它要启动的外部进程分开验证：

• 当前 Windows 环境无法解析 pandoc 命令；
• Typora 记录了 Pandoc 进程启动失败；
• 原有高级配置文件没有被本次操作修改；
• Typora 的原生功能仍可使用。

这些证据把故障范围收敛到转换器发现链路。重置编辑器、替换主题或改写文档内容都会扩大修改面，却无法处理进程启动失败这一边界。

这条导出路径依赖外部 Pandoc

Typora 会把多种导入和导出格式交给 Pandoc 处理，而没有在编辑器内部实现全部转换器。因此，菜单项表示该集成受到支持，不能说明外部程序已经安装且可访问。

这也解释了安装后仍提示缺少 Pandoc 的常见情况。安装程序可以更新用户的可执行文件搜索路径，已经运行的桌面进程仍保留启动时继承的环境。重启 Typora 可以刷新环境；在导出设置中显式选择可执行文件，还能进一步消除程序路径歧义。

只安装一份并验证可执行文件

Pandoc 的 Windows 官方安装说明同时提供安装程序和以下 WinGet 命令（安装 Pandoc）：

winget install `
  --source winget `
  --exact `
  --id JohnMacFarlane.Pandoc

应当只选择一种安装方式。Pandoc 文档提醒，混用多个包管理器可能留下两份安装，使路径排查更难稳定复现。

安装完成后打开新的 PowerShell 会话，确认 Windows 实际解析到的程序：

Get-Command pandoc
pandoc --version

记录命令解析出的可执行文件，不猜测默认目录。随后重启 Typora；若编辑器仍提示需要 Pandoc，进入首选项的 导出 > 通用，把刚才发现的可执行文件设置为 Pandoc 路径。

此时的执行链应当清晰可查：

1. 从 Typora 发起导出操作。
2. 启动已经配置或重新发现的 Pandoc 可执行文件。
3. 选择 DOCX 或 EPUB 目标输出格式。
4. 写出生成文件包。

验证内容、结构和嵌入资源

导出成功提示可以作为运行证据，但它无法证明结果保留了实际需要的文档特性。本次验证文档包含：

• 中文文本；
• 一张带已知值的小表格；
• 一张由 Markdown 引用的本地图片。

该文档分别导出为 DOCX 和 EPUB。这两种格式都采用 ZIP 包结构，因此可以检查内部条目，不必只依赖桌面阅读器的视觉结果。

DOCX 检查确认了文档 XML、预期中文与表格值，以及媒体条目。EPUB 检查确认了容器元数据、可读取的 XHTML、预期中文与表格值，以及图片条目。这些结果同时证明 Pandoc 已运行，并且 Typora 把有代表性的内容和资源传递给了转换器。

验收边界可以整理为：

层级	证据	能证明什么
安装	pandoc --version 成功	新终端能够运行转换器
应用绑定	Typora 记录或使用选定程序	编辑器知道应启动哪个进程
导出执行	DOCX 与 EPUB 文件生成	两个目标格式均已完成
包结构	必要条目与嵌入媒体存在	输出包包含实际内容
内容检查	中文与表格值存在	代表性文档数据通过转换

适用边界与可复用结论

这套流程适用于 Windows 上由 Pandoc 支持的 DOCX 与 EPUB 输出。可执行文件位置和设置名称可能变化，应以命令发现结果指导配置。自定义 Word 样式、EPUB CSS、过滤器、引用、数学公式和阅读器兼容性需要各自的验证文档。

Pandoc 的 PDF 生成属于另一条链路，因为它通常还需要额外 PDF 引擎。需求只覆盖 DOCX 与 EPUB 时，无需为此安装大型 TeX 发行版。

编辑器通过外部转换器提供导出格式时，应把集成视为一条进程链来验证：确认程序发现结果，必要时显式绑定路径，导出有代表性的内容，再检查真实产物。菜单项或单次成功提示都不能单独覆盖这条验收边界。