将当前 Markdown 文件导出为 PDF，渲染样式复用 Zwing's blog （markdown-it + MPE 风格），与博客文章页视觉一致。
本项目最初受 MPE（Markdown Preview Enhanced）启发，故命名 MPE2PDF。
功能
- 博客同款渲染：正文排版、代码高亮（GitHub 主题）、荧光笔
==高亮==、13 种 MPE 风格提示框 - 完整公式支持：
$..$行内公式、$$..$$块级公式（MathJax 3） - 图表支持：
mermaid 图（客户端渲染，跟随明暗主题）、plantuml 图（Java 渲染，需配置） - 中文友好：标题锚点保留中文、中文/空格路径自动编码
- 打印排版：块级元素（代码块/表格/提示框/公式/图）不跨页截断，标题不孤立页底
- 零下载：直接驱动系统 Microsoft Edge / Chrome（Windows 11 自带 Edge）
- 不污染：图片相对路径/根路径自动映射，同名文件自动改名不覆盖
支持的提示框类型
> [!note] [!info] [!tip] [!success] [!question] [!warning]
[!example] [!quote] [!important] [!bug] [!fail]
安装
本地开发调试
npm install- 按
F5启动「Run Extension」调试窗口（自动编译） - 在调试窗口中打开任意
.md文件 → 右键 →「MPE2PDF: 导出为 PDF」
打包安装（VSIX）
npm run package # 产出 mpe2pdf-x.y.z.vsix
code --install-extension mpe2pdf-x.y.z.vsix
使用
- 编辑器右键（Markdown 文件）或资源管理器右键（.md 文件）→「MPE2PDF: 导出为 PDF」
- 命令面板：
MPE2PDF: 导出为 PDF - 导出完成后可点击「打开文件」直接查看 PDF
设置
| 设置 | 默认 | 说明 |
|---|---|---|
mpe2pdf.theme |
light |
PDF 明暗主题 |
mpe2pdf.pageSize |
A4 |
纸张大小（A4 / Letter） |
mpe2pdf.margin |
20mm 四周 | 页边距（mm） |
mpe2pdf.includeToc |
false |
是否生成目录（h2/h3 标题） |
mpe2pdf.includePageNumbers |
true |
页脚页码 |
mpe2pdf.cssOverride |
"" |
追加的 CSS 文件路径（相对工作区或绝对路径） |
mpe2pdf.browserPath |
"" |
Edge/Chrome 可执行文件路径（空 = 自动探测） |
mpe2pdf.javaPath |
"java" |
Java 命令（PlantUML 用） |
mpe2pdf.plantumlJarPath |
"" |
plantuml.jar 绝对路径（空 = 不启用 PlantUML，降级显示源码） |
mpe2pdf.outputDir |
"" |
PDF 输出目录（空 = 与源文件同目录） |
mpe2pdf.rootDir |
"" |
根路径图片（/assets/...）映射目录（空 = 源文件目录） |
PlantUML 示例（博客场景）：
{
"mpe2pdf.plantumlJarPath": "C:/Users/<你>/Desktop/myBlog/plantuml.jar",
"mpe2pdf.rootDir": "C:/Users/<你>/Desktop/myBlog"
}
与博客样式同步
样式与语法从 myBlog 复制进扩展，博客更新后手动同步：
assets/css/style.css变更 → 更新resources/print.css（正文相关部分）scripts/md.js变更 → 更新src/markdown/renderer.tsassets/vendor/（mathjax/mermaid）升级 → 替换resources/vendor/dist/assets/css/hljs*.css变更 → 替换resources/hljs*.css- 可用
mpe2pdf.cssOverride临时指向博客 style.css 对比
开发
npm run compile # tsc 编译
npm run test # 单元测试（node:test）
npm run compare:blog # 渲染保真对比（与博客 dist 逐块比对，需配置 myBlog 路径）
npm run package # 打包 .vsix
开发状态
五个阶段全部完成，当前版本 0.1.0 已打包并本地安装验证：
- Phase 0：扩展骨架、命令与设置项声明
- Phase 1：渲染核心（callout/高亮/代码高亮/MathJax/Mermaid/PlantUML）
- Phase 2：博客同款页面模板与打印样式
- Phase 3：PDF 导出（puppeteer-core + 系统 Edge）
- Phase 4：设置项打磨与文档
- Phase 5：图标、打包、边界回归、本地安装验证（
mpe2pdf-0.1.0.vsix，6.26 MB）
发布到 Marketplace（可选）
本地安装已可用。若需发布到 VS Code Marketplace：
- 在 Azure DevOps 注册 publisher 并创建 PAT
npx vsce login <publisher>- 将
package.json的publisher改为注册名后执行npx vsce publish
许可证
MIT