Sublime Text将Markdown导出为PDF文档_Sublime Text处理实操教程【办公】-sublime-PHP中文网

export to pdf菜单灰色是因为触发条件缺失：文件语法未设为github flavored markdown、markdownpreview插件未安装或装错、pandoc/wkhtmltopdf未安装或sublime找不到其路径。

sublime text将markdown导出为pdf文档_sublime text处理实操教程【办公】

Export to PDF 菜单项灰色，不是插件没装，而是 Sublime 找不到 pandoc、wkhtmltopdf 或 Chrome —— 它们压根没装，或者装了但路径没对上。

为什么 Export to PDF 菜单项是灰色的？

这不是 Sublime 的 bug，是触发条件缺失：

当前文件语法未设为 GitHub Flavored Markdown（右键 → Set Syntax → Markdown (GFM)）
MarkdownPreview 插件未安装，或装的是已废弃的 MarkdownPDF（硬编码调用 phantomjs，2026 年完全失效）
终端运行 pandoc --version 或 wkhtmltopdf --version 无输出 → 系统根本没装
Mac 用户尤其容易踩坑：brew install pandoc 后真实路径常是 /opt/homebrew/bin/pandoc，但 Sublime 默认只查 /usr/bin，不显式配置就等于没装

用 MarkdownPreview + wkhtmltopdf 最省事

这是目前 Windows/macOS/Linux 通用性最好、配置成本最低的路径，适合技术文档、笔记类场景：

去 wkhtmltopdf.org/downloads.html 下载对应系统版本，Windows 安装时务必勾选「Add to system PATH」；macOS/Linux 确认 /usr/local/bin 已在 shell 的 $PATH 中
Sublime 中打开 Preferences → Package Settings → Markdown Preview → Settings，填入：

{
  "enabled_parsers": ["markdown"],
  "enable_pdf_export": true,
  "pdf_converter": "wkhtmltopdf",
  "wkhtmltopdf_path": ""
}

wkhtmltopdf_path 留空即可（插件会自动查 $PATH）；若填了绝对路径，必须指向可执行文件，例如 /usr/local/bin/wkhtmltopdf 或 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe

该方案不依赖 LaTeX，编译快、体积小，但对复杂 CSS（如 flex 布局、自定义分页）支持有限。

Markdown Viewer

用于 AI 配对编辑的实时 Markdown 查看器，协作时更新即时渲染，支持任意 AI 代理和网页浏览器。

下载

用自定义 .sublime-build + pandoc 实现高质量排版

需要目录、页眉页脚、数学公式、精确中文字体控制？必须走 pandoc + lualatex 路线：

菜单 → Tools → Build System → New Build System…，粘贴并保存为 Markdown2PDF.sublime-build
"cmd" 必须写 pandoc 全路径，不能只写 "pandoc"（否则找不到命令）
"selector" 必须是 "source.gfm"，否则 .md 文件里按 Ctrl+B 不触发
"path" 填你本地 pandoc 所在目录（多个路径用英文冒号分隔），例如："/opt/homebrew/bin:/usr/local/bin"

{
  "cmd": ["/opt/homebrew/bin/pandoc", "-s", "--pdf-engine=lualatex", "-V", "mainfont=Noto Sans CJK SC", "-o", "$file_base_name.pdf", "$file"],
  "selector": "source.gfm",
  "path": "/opt/homebrew/bin:/usr/local/bin",
  "working_dir": "$file_path"
}

中文 PDF 乱码、字体丑、段落挤在一起？90% 是因为没加 -V mainfont=... 参数。macOS/Linux 常用 Noto Sans CJK SC，Windows 可换为 SimSun 或 Microsoft YaHei；若系统没装该字体，pandoc 编译会报错或静默失败。