长文转社交卡片

处理过长文案的人都会遇到这类问题：小红书、公众号贴图对图片比例有要求，直接截图会挤成一团，手动裁切又容易打断句子，图文排版调整起来费时费力。这个技能的目标很明确，把 Markdown 格式的长文本自动渲染成 3:4 比例的多张卡片 PNG，省去重复的手动操作。

工作原理

核心思路是 HTML 到 PNG 的离屏渲染。技能读取输入的文案，在段落、句子、分句边界处做智能分页，生成对应风格的 HTML 片段，再调用 puppeteer-core 驱动本机 Chrome/Edge 完成出图。

几个关键能力值得关注：

• 智能分页：不是按字符数硬切，而是在语义边界断句，避免出现半个词或残句。
• 六种风格 ID：从 minimal-white 的极简白纸到 chinese-ink 的宣纸水墨风，覆盖知识分享、生活方式、传统文化等不同内容调性。
• 封面与尾页模板：封面自动提取大标题、副标题、话题标签和阅读时长；尾页统一收尾，带「完」字标记和互动引导。
• 原生 Markdown 解析：## 标题、**粗体**、> 引用、- 列表、` 代码 、==高亮==` 都会映射到对应视觉样式。
• 文字密度三档：compact 适合信息量大的干货，spacious 适合金句留白，对应每卡约 300/220/150 字的容量差异。
• 自定义强调色与 2x 高清输出：默认输出 1080x1440 的 2 倍清晰度 PNG，可直接用于平台发布。

生成流程分四步：准备文本并适当分段 → 按内容类型选风格 ID → 执行渲染 → 检查 output/preview.html 并展示结果。

适用边界

这不是排版引擎的替代品。 复杂的表格、多栏布局、数学公式不在处理范围内，分页策略按段落和句子粒度工作，遇到嵌套结构可能不够理想。

渲染质量依赖系统已安装的中文字体（微软雅黑、宋体、楷体等）。Linux 服务器若未配置中文字体，可能出现方块或缺字，需要预先安装字体包。

首次运行时 puppeteer-core 会自动安装，但浏览器路径是自动探测的——Windows/macOS/Linux 都支持，前提是系统里确实有 Chrome 或 Edge。

每张卡片渲染约 1-2 秒，生成 10 张卡片大约 15 秒，适合离线批处理，不适合需要秒级响应的交互场景。