sublime text 无法直接导出 markdown 为 pdf，必须依赖外部工具链；推荐使用 markdownpreview 插件配合 wkhtmltopdf，需手动安装并配置路径，且“漂亮 pdf”的实现关键在于 css 与转换器的细节配置。
Sublime Text 本身不支持 Markdown 转 PDF，也无内置导出功能——所有“一键转PDF”方案都依赖外部工具链，且必须手动配置。直接装插件不配环境，90% 情况下会报错 command not found: pandoc 或 Failed to launch wkhtmltopdf。
为什么不能只装 MarkdownPreview 插件？
MarkdownPreview 插件（MarkdownPreview）默认只渲染 HTML 预览，即使勾选了 "enable_pdf_export": true，它仍需要系统已安装并可调用的 PDF 渲染引擎：
-
pandoc+LaTeX（生成学术级排版，但安装大、编译慢） -
wkhtmltopdf（将 HTML 快速转 PDF，轻量但对 CSS 支持有限） -
chrome/chromium（通过 Puppeteer 或命令行 headless 模式导出，效果最接近预览）
插件不会自动帮你装这些——它只负责调用。没装或路径不对，Export to PDF 菜单项灰掉，或执行时报错。
推荐方案：用 MarkdownPreview + wkhtmltopdf（Windows/macOS/Linux 通用）
这是平衡易用性、输出质量和配置成本的最佳路径。关键步骤如下：
- 下载并安装
wkhtmltopdf：去官网 wkhtmltopdf.org/downloads.html 选对应系统版本，安装时勾选「Add to system PATH」（Windows）或确认/usr/local/bin已在$PATH（macOS/Linux） - 在 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。
通过 jina.ai 将网页抓取为精简的 markdown，用于在需要获取 URL 并获取压缩的 markdown 内容以节省 token。触发词 l...
重启 Sublime，右键 Markdown 文件 → Markdown Preview → Export to PDF，生成的 PDF 会保留基础样式（标题、列表、代码块），但自定义 CSS 需额外配置 css_js_files。
导出“漂亮”PDF 的真实限制在哪？
所谓“漂亮”，往往指中文字体、页眉页脚、目录、语法高亮等。但这些不是 Sublime 决定的，而是由你选择的转换器和模板控制：
-
wkhtmltopdf默认不嵌入中文字体，中文会显示为方框——需在 CSS 中指定本地字体，如font-family: "PingFang SC", "Microsoft YaHei", sans-serif;，并确保系统已安装 - 页眉页脚需在设置中启用：
"pdf_header_html"和"pdf_footer_html"，值为 HTML 字符串或本地文件路径 - 目录（TOC）需配合
--toc参数，但 MarkdownPreview 当前版本（v3.0.5）不支持透传该参数，必须改用pandoc方案或写自定义 build system - 代码块高亮依赖
highlight.js或Pygments渲染后的 HTML，若预览里没高亮，PDF 也不会有
也就是说，“导出漂亮 PDF”这件事，80% 工作量在 CSS 和转换器配置上，Sublime 只是触发器。
真正卡住人的，从来不是“怎么点菜单”，而是 wkhtmltopdf 找不到字体、pandoc 缺 xelatex、或者 CSS 里写了 @page { size: A4; } 却忘了加 @media print 适配——这些细节不试一遍根本看不出问题。
