它解决什么问题
Markdown 写东西很顺手，但要发给同事、客户、上传到平台时，往往得是别的格式：
- 写好的文档要交 Word 版 → Markdown 转 .docx；
- 笔记要做成电子书 → Markdown 转 .epub；
- 要一个能直接浏览器打开的网页 → Markdown 转 .html；
- 反过来，手里一份 Word/HTML 想整理进 Markdown 笔记 → 也能转回来。
Pandoc 是这方面公认的「万能转换器」，格式覆盖极广。本工具把它包成了好用的图形界面 + 命令行。
和其他转换工具的区别
本系列里能转文档的有三款，分工不同：
- MarkItDown / AnyDoc：管「往里转」——把 Word/PDF/PPT 等文档转成 Markdown；
- Pandoc：管「往外转」——把 Markdown 转成 Word/HTML/EPUB 等，而且双向，也能把 Word/HTML 转回 Markdown。
所以：要把一堆文档收进 Markdown 笔记，用 MarkItDown / AnyDoc；要把 Markdown 输出成 Word、网页、电子书，用 Pandoc。按方向选，也可以都装。
核心特性
- 万能双向：Markdown ↔ Word / HTML / EPUB / OpenDocument / LaTeX / RTF / Org / AsciiDoc……
- 内置引擎：Pandoc 二进制由 pypandoc 自带，装完即用、离线运行，无需另装 pandoc；
- 命令行 + 图形界面：双击拖文件选格式即转，或终端批量处理；
- 拖放即转：文件拖进窗口松开，选格式、保存；
- 自动识别输入：按文件扩展名判断输入格式，.md / .docx / .html / .rst / .org 都能喂进去；
- 完整文档 / 片段：可选生成完整文档（默认，带完整结构）或只输出片段。
支持的输出格式
| 格式 | 说明 | 能否预览 |
|---|---|---|
docx | Word 文档 | 否（写文件） |
html | 网页 | 是 |
epub | 电子书 | 否（写文件） |
odt | OpenDocument 文本 | 否（写文件） |
rtf | 富文本 | 是 |
latex | LaTeX 源码（.tex） | 是 |
markdown / gfm | Markdown / GitHub Markdown | 是 |
org / asciidoc / plain | Org-mode / AsciiDoc / 纯文本 | 是 |
不支持 PDF：Pandoc 出 PDF 需要额外的 LaTeX / 排版引擎（体积大、易出错）。要 PDF，推荐先转成 docx / html，再用 mdview 打开后「打印到 PDF」。
图形界面（GUI）怎么用
装完后双击桌面或开始菜单的 Pandoc 图标即可打开，没有命令行黑窗口。界面要点：
- 输入来源：填文件路径（按扩展名自动识别输入格式）；
- 输出格式：下拉选（docx / html / epub / odt / rtf / latex / markdown 等）；
- 输出文件：文本格式可留空仅预览；二进制格式（docx / epub / odt）必须填写输出文件；
- 完整文档：默认勾选（等价 pandoc
-s）；取消则只输出片段； - 拖放转换：文件拖进窗口松开即载入；
- 暗色 / 亮色主题：标题栏 ⚙ 设置里切换。
文本格式（html/markdown/latex 等）的结果直接显示在预览区可编辑；二进制格式（docx/epub 等）直接写入文件并提示路径。
命令行（CLI）速查
新开一个终端，命令是 py-tools-pandoc：
:: Markdown -> Word
py-tools-pandoc 报告.md -t docx -o 报告.docx
:: Markdown -> 完整网页
py-tools-pandoc 报告.md -t html -o 报告.html
:: Markdown -> 电子书
py-tools-pandoc 笔记.md -t epub -o 笔记.epub
:: HTML -> Markdown（反向）
py-tools-pandoc notes.html -t markdown -o notes.md
:: 只输出片段（不带完整文档头）
py-tools-pandoc 报告.md -t html --fragment
:: 默认 -t markdown，输出到屏幕
py-tools-pandoc 报告.md
py-tools-pandoc --help| 参数 | 命令行选项 | 说明 |
|---|---|---|
| 输入来源 | SOURCE（位置参数） | 按扩展名自动识别输入格式 |
| 输出格式 | -t, --to | 默认 markdown |
| 输出文件 | -o, --output | 二进制格式必填 |
| 完整文档 | -s, --standalone / --fragment | 默认开 |
| 详细日志 | -v, --verbose | 输出详细日志 |
下载与安装
- 点上方「下载安装包」按钮，得到
py-tools-pandoc-setup-1.0.0.exe； - 双击运行，按提示下一步——免管理员，装到当前用户目录，自动加入开始菜单和 PATH；
- 想用图形界面：双击桌面或开始菜单的 Pandoc 图标；
- 想用命令行：新开终端输入
py-tools-pandoc。
首次启动会在窗口里显示环境初始化进度（约 1~3 分钟，含内置 Pandoc 引擎），完成后即可使用。本系列多个工具共用一套运行环境，之后装其他工具会很快。
常见问题
- docx / epub 提示「必须指定输出文件」？二进制格式不能只预览，填写「输出文件」或命令行加
-o。 - 图形界面打不开？依赖系统 WebView2 运行时（Win10 / Win11 通常自带），缺失时安装 WebView2 Runtime。
- 报「未找到 Pandoc 引擎」？确认
pypandoc-binary已随安装正确就位；它内置 pandoc，无需另外安装。 - 能转 PDF 吗？不直接支持（需 LaTeX 引擎）。先转 docx / html，再用 mdview 打印到 PDF 最省事。
- 和 MarkItDown / AnyDoc 怎么选？见上方「和其他转换工具的区别」——往里转用那两个，往外转用 Pandoc。
总结
如果你要把 Markdown 输出成 Word、网页、电子书等成品格式，或者在不同文档格式之间来回转换，Pandoc 是覆盖面最广、最可靠的万能转换器。本工具把它做成了好用的图形界面 + 命令行，内置引擎、离线运行，免费、装上不占地方。