markdown-themeable-pdf导出PDF常空白或乱码，因其底层依赖已弃用且不兼容Electron 22+的phantomjs，导致渲染失败、中文方块、样式丢失；推荐改用marked+Chrome命令行或pandoc+xelatex链式转换。
markdown-themeable-pdf 导出 PDF 为什么经常空白或乱码
这个插件底层用的是 phantomjs 渲染 HTML → PDF，而 phantomjs 自 2018 年起已被官方弃用，且完全不兼容 Electron 22+（Atom 1.70+ 默认使用）。常见现象包括：生成的 PDF 是纯白页、中文显示为方块、标题层级错乱、CSS 样式丢失。
它不会报明显错误，而是静默失败——比如控制台输出 AssertionError: html-pdf: Failed to load PhantomJS module，或根本无日志。即使你手动 npm install phantomjs-prebuilt，也会因 ABI 不匹配被 Node.js 拒绝加载。
配置 papersize 和页眉页脚的实际效果
在插件 Settings 页面改 papersize 为 A5 确实能放大字体，但前提是渲染器能正常工作；一旦底层 PhantomJS 失效，调大纸张也只是一张更大的白纸。
页脚定制（如修改 footer.js）仅在渲染成功时生效。你改了 return { height: '1cm', contents: '<div>Page {{page}}/{{pages}}</div>' }，但若整个页面没渲染出来，页脚自然也不会出现。
- 页眉页脚开关藏在插件设置里，叫
headerEnabled/footerEnabled，默认是true - 字体控制依赖系统已安装的中文字体，插件本身不打包字体，
font-family: "Noto Sans CJK SC"这类声明在 PhantomJS 下大概率被忽略 -
page-break类需写成<div class="page-break"></div>，且必须保存文件后触发导出，否则不生效
替代方案：绕过插件，用命令行链式导出（推荐）
不用装任何 Atom 插件，也不碰 PhantomJS，直接用系统级工具链，稳定、可控、支持中文和自定义样式。
WiseOCR — 将 PDF 或图片文件转换为高质量 Markdown 文本，支持表格完整识别、多栏版式还原、中英文混排。适用场景：扫描件文字提取、纸质文档数字化、合同/报告/论文转文本、图片中文字提取。支持格式：PDF、JPG、JPEG、PNG、WEBP、GIF、BMP、TIFF。触发：用户上传文件并要求"帮我识别这个文件的文字"、"PDF转文字"、"图片转文本"、"帮我提取这个表格"——会调用本技能。说"用Wi
先装 marked：npm install -g marked；确保系统已安装 Chrome（含 chrome 命令）。
- 导出 HTML：
marked -o output.html input.md（保留你在 .md 文件顶部写的<style>body{font-family:"Noto Sans CJK SC"}</style>） - 转 PDF：
chrome --headless --disable-gpu --print-to-pdf=output.pdf --print-to-pdf-no-header output.html - 路径含空格或中文？先 cd 到
/tmp或其他纯英文路径再执行，避免静默失败
如果需要目录、页眉页脚、章节编号等出版级排版，换 pandoc：pandoc input.md -o output.pdf --pdf-engine=xelatex -V mainfont="Noto Serif CJK SC"，前提是本地装了 xelatex。
为什么 markdown-preview-plus 的 export-html 不能直接接 PDF
它只负责 Markdown → HTML 这一步，生成的 HTML 缺少打印适配（比如 @media print 规则），直接用 Chrome 打印会带默认页眉、边距过大、分页错乱。
关键点在于：markdown-preview-plus:export-html 命令本身不启动浏览器，也不调用 PDF 生成逻辑——它只是把渲染结果存成 HTML 文件，剩下的得你自己用 CLI 或其他工具完成。
容易忽略的细节：执行该命令前，光标必须落在 .md 文件编辑器内（不能在设置页、空标签页或 tree-view 面板），否则命令无响应；导出路径若含中文，部分版本会静默跳过写入。
