技能介绍

要解决什么问题

技术文档、笔记常以 Markdown 维护，但直接截图或导出 PDF 在朋友圈、微信群分享时，常见两类痛点：逻辑宽度与压缩策略不匹配（长边超过约 2000px 会触发微信强压缩，文字发糊），以及 设备像素比未对齐（iPhone 14/15 逻辑宽 390px，3x Retina 对应 1170px 物理宽，低倍率截图在手机上观感发虚）。

md2img 把「可维护的 .md」转成适合手机阅读与微信转发的单张或多张位图，而不是通用 HTML 导出。

如何工作

渲染入口在 scripts/md2img.js：用 Playwright（Chromium） 把 Markdown 编成带样式的 HTML，再对整页做截图，默认 device scale factor = 3（约 1170px 物理宽）。

可按内容选型：

文字为主：默认 PNG，利于锐利字形
图文混排：-f jpeg -q 92 控制体积
深色阅读：--theme dark
过长单图：--multi 按章节拆成多张，避免一条时间线里「巨长图」

文档里对尺度的说明很具体：1170px 长边通常仍低于微信强压缩阈值，起点分辨率够高，轻压缩后文字仍可读；需要打印或更高 stakes 时可提高到 -s 4（约 1560px），但 -s 6+ 容易踩 2000px 线，得不偿失。

边界与注意点

依赖 Node.js 16+ 与 Playwright Chromium；缺模块或浏览器二进制时要按 SKILL 里的 setup.sh / npx playwright install chromium 处理。
中文乱码多为 CJK 字体未装（如 Noto Sans CJK），属于环境问题而非 Markdown 语法问题。
文字出现 JPEG 块状伪影时，优先回到 PNG 或提高 -q；图太高优先 --multi 或调 --font-size，而不是一味加 scale。

更细的微信尺寸说明见技能内 references/wechat_image_specs.md。