sublime怎么配置Markdown转PDF功能？（文档输出）

sublime text需借助插件与外部工具链（如pandoc或weasyprint）实现markdown转pdf；推荐markdownpreview插件配合自定义build system，注意路径、字体及名称匹配。

sublime text 本身不支持 Markdown 转 PDF，必须靠插件 + 外部工具链

Sublime Text 是纯文本编辑器，没有内置渲染或导出能力。所谓“转 PDF”，实际是调用 markdown 解析器（如 pandoc 或 mkdocs）+ LaTeX 或 weasyprint 生成 PDF。你配的不是 Sublime，而是它和命令行工具之间的“传话员”。

常见错误现象：Export to PDF 菜单项灰色、点击无反应、报错 command not found: pandoc 或 No module named weasyprint —— 这说明工具链没装好，不是插件没启用。

• 先确认系统已安装 pandoc（推荐）或 weasyprint：终端运行 pandoc --version 或 weasyprint --version，有输出才算到位
• pandoc 更通用，支持自定义 LaTeX 模板、目录、页眉页脚；weasyprint 依赖 Python，对 HTML/CSS 渲染更友好，但中文分页和表格支持较弱
• Mac 用户注意：brew install pandoc 后，Sublime 可能读不到 /opt/homebrew/bin 路径，需在插件配置里显式写全路径，比如 /opt/homebrew/bin/pandoc

推荐插件：MarkdownPreview + 自定义 build system（最稳）

别用老版本的 MarkdownPDF 插件 —— 它已多年未维护，不兼容 Sublime Text 4，且硬编码调用过时的 phantomjs，现在根本跑不起来。

正确做法是用官方维护的 MarkdownPreview（支持实时预览），再加一个轻量 build system 实现一键 PDF 输出：

• 安装 MarkdownPreview 插件（Package Control → Install Package → 输入 MarkdownPreview）
• 菜单栏 → Tools → Build System → New Build System…，粘贴以下内容并保存为 Markdown2PDF.sublime-build

{   "cmd": ["pandoc", "-s", "-o", "$file_base_name.pdf", "$file"],   "selector": "source.gfm",   "path": "/usr/local/bin:/opt/homebrew/bin" }

注意：path 需按你本地 pandoc 实际位置调整；selector 设为 source.gfm 才能在 .md 文件里触发该构建系统。

中文 PDF 导出失败？大概率是字体或引擎问题

直接用 pandoc file.md -o out.pdf 生成的 PDF 中文乱码、缺字、段落挤在一起 —— 不是 Sublime 的锅，是 pandoc 默认用 LuaTeX，但没指定中文字体。

解决方法是在 build system 里补上 LaTeX 模板和字体参数：

• 新建模板文件 zh.tex（放在项目根目录或 ~/Templates/），内容包含 setmainfont{Noto Sans CJK SC} 等中文字体声明
• 修改 build system 的 cmd：

  "cmd": ["pandoc", "-s", "--pdf-engine=lualatex", "--template=zh.tex", "-o", "$file_base_name.pdf", "$file"]

• 确保系统已安装对应字体（macos 自带 Noto Sans CJK；windows 建议用 SimSun 或 microsoft YaHei；linux 用 fonts-noto-cjk）

想点一下就出 PDF？快捷键和右键菜单要手动绑定

build system 默认只在 Ctrl+B（Win/Linux）或 Cmd+B（Mac）生效，但很多人习惯右键或快捷键。需要额外两步：

• 菜单栏 → Preferences → Key Bindings，添加快捷键（例如绑定到 F9）：

  { "keys": ["f9"], "command": "build", "args": {"build_system": "Packages/User/Markdown2PDF.sublime-build"} }

• 右键菜单：在 Package Settings → MarkdownPreview → Settings – User 里加：

  "enable_pdf_export": true

  然后右键就会出现 Export to PDF（前提是 build system 名称匹配且路径正确）

容易被忽略的是：Sublime 的 build system 名称必须和 "build_system" 字段里写的完全一致（包括大小写和空格），否则快捷键或右键会静默失效 —— 这类问题查日志都看不到报错，只能逐字核对。