能直接导出,但需解决 PATH 未继承至 Sublime GUI、构建系统路径写错、selector 未设为 source.gfm、未用 --reference-doc 指定 Word 样式模板这四大关键问题。

能直接导出,但必须绕过 Sublime Text 的“假内置”幻觉——它不带 Pandoc,也不自动认路径,pandoc 命令在构建系统里跑不通,90% 是因为 PATH 没透到 GUI 进程里。
确认 pandoc 已安装且 Sublime 能调用
这是第一道也是最常卡住的关卡。Sublime 的构建系统走的是系统 shell,但它不加载你终端里生效的 PATH(尤其 macOS 的 zsh profile、Windows 安装时漏勾「Add to PATH」)。
- 在终端运行
pandoc --version,有输出(推荐 ≥3.0)才算真正装好 - 如果终端能跑、Sublime 按
Ctrl + B却报pandoc is not recognized或静默失败,说明 GUI 环境没继承到路径 - 临时解法:在构建文件中写死全路径,比如 macOS 上是
/opt/homebrew/bin/pandoc,Windows 上可能是C:\Program Files\Pandoc\pandoc.exe(注意反斜杠要双写或改用正斜杠)
配置 Pandoc.sublime-build 构建系统
Sublime 的构建系统本质是 shell 命令封装,变量拼错、引号漏掉、selector 不对,都会导致空文件、乱路径或根本不触发。
安全的随机密码生成器。支持自定义长度、字符类型(大写/小写字母、数字、特殊符号),排除相似字符,批量生成。纯 Python 标准库,无需 API 密钥。
-
${file}是完整路径,${file_base_name}是不含扩展名的文件名,${file_path}是目录路径——三者混用会把.docx输出到错误位置 - 命令必须加双引号:
"shell_cmd": "pandoc "${file}" -o "${file_path}/${file_base_name}.docx"",否则路径含空格(如C:UsersMy Documents)直接崩 -
selector必须设为"source.gfm",否则右键 → Build System 里看不到这个选项,.md文件也不会自动匹配 - 若原文含中文、数学公式或参考文献,得补参数:
--from=markdown+tex_math_dollars --filter=pandoc-citeproc
用 --reference-doc 控制 Word 样式
默认导出的 .docx 只有基础格式,标题层级塌、字体乱、页眉页脚全无——这不是 Pandoc 的锅,是你没给它样式模板。
-
--reference-doc参数指定一个已有 Word 文档(如template.docx)作为样式源,所有格式(标题样式、列表缩进、字体字号)都从它复制 - 模板文件路径必须写绝对路径或相对于当前文件的相对路径,并用双引号包裹:
--reference-doc="templates/my-style.docx" - 别指望用
.css或 HTML 模板去影响 Word 输出——--reference-doc是唯一可靠方式 - 模板里至少定义好
Heading 1到Heading 3样式,Pandoc 才能把#、##映射过去
真正麻烦的不是命令怎么写,而是每台机器上 pandoc 的路径、字体、模板位置都不一样;写死路径+双引号+source.gfm selector+--reference-doc 这四点漏掉任何一环,就只能看到空文件或报错。别信“装完插件就能用”的说法——Pandoc 插件只是个壳,底下的命令还是得自己对齐环境。

















