Punk XHS Cards：把 Markdown 长文一键变成带个人 IP 的小红书知识卡片

如果你同时在 𝕏、公众号和小红书更新内容，应该都遇到过同一个问题：一篇长文已经写好了，想发到小红书，却几乎要重新做一遍。

直接截图，字号太小；复制文字，内容放不下；套现成模板，又和自己的账号风格对不上。教程类文章更麻烦，少一张关键截图，读者就可能卡在某一步。

最近，我把自己反复打磨的小红书排版流程整理成了一个 Codex Skill——Punk XHS Cards。

它可以根据你提供的人物照片（或已有 IP）、指定的人物动作，以及一篇 Markdown 长文，自动生成一套带个人 IP 的竖版知识卡片，同时输出小红书标题、正文、话题标签以及最终 ZIP 包，让一篇已经写好的内容，更低成本地完成跨平台复用。

为什么会做这个 Skill

以前我的小红书主要发图片和提示词，内容不长，整理一下就能发布。

后来教程和长文越来越多，虽然发到 𝕏 和公众号几乎不用修改，但到了小红书，总找不到满意的方式：全文截图看不清，复制文字放不下，重新排版又太耗时间。

于是，我开始让 Codex 帮我把 Markdown 自动拆成竖版 HTML。最初只是解决「如何把一篇长文排进手机屏幕」的问题，让文章自动拆成多张图片，并保持统一的字号、间距和版式。

做得越来越多以后，我发现真正重复的，其实远不止排版。

几乎每篇文章都需要：

• 重新拟一个适合小红书的标题；
• 将 Markdown 自动拆成多张知识卡片；
• 确认人物 IP，并作为封面作者；
• 保留教程里的关键截图；
• 生成封面、正文配文和话题标签；
• 检查文字截断、图片遗漏和人物比例。

既然每次流程都差不多，那完全可以固化成一套工作流。

正好我也在打造自己的个人 IP，于是设计了穿红色连帽卫衣的 Punk 形象，并把人物、主题色和排版规则一起接入整个流程，最终整理成了 Punk XHS Cards。

对于同时运营多个平台的创作者来说，同一篇内容如果只是简单改尺寸、换模板，很难建立品牌辨识度；而拥有统一 IP 和视觉系统之后，读者即使在不同平台，也能第一眼认出你的内容。

最终，这个 Skill 的输入是一篇 Markdown，输出则是一整套知识卡片、可直接发布的文案，以及最终 ZIP 包。

它是怎么工作的

Punk XHS Cards 不会收到文章就立刻批量出图，而是设置了三个确认节点：

• 人物确认
• 卡片样式确认
• 封面确认

完整流程如下：

上传人物照片或已有 IP 图
        ↓
确认人物名称、主题色、人物设定与卡片动作
        ↓
确认动作图、专属主色和正文样稿
        ↓
上传 Markdown 长文
        ↓
解析标题、正文结构和关键图片
        ↓
确认 IP 主题插图与 16:9 macOS 窗口封面
        ↓
生成从 01 开始编号的正文卡片、发布文案和 ZIP

这样做最大的好处，就是把修改成本控制到最低。

人物比例有问题，只改人物；主题色不满意，只调整 Profile；封面排版需要修改，也不用重新生成十几张正文卡片。

封面确认通过后，才会开始正式渲染全部内页。封面负责展示主题、书名、作者和个人 IP，不参与正文编号；正文统一从 01 开始。

每个人都可以拥有自己的版本

很多人看到我的演示，会注意到红色主题。

实际上，红色只是我的 Punk Profile。

每位用户第一次使用 Skill 时，都可以上传自己的照片或已有 IP，并指定：

• 人物名称
• 人物动作
• 品牌主题色

如果没有指定颜色，Skill 会自动从人物服装或配件中提取候选色，再由用户确认。

例如：

• 蓝色外套 → 蓝色视觉系统
• 橙色围巾 → 橙色封面与重点框
• 品牌绿色 → 全部卡片统一绿色

人物决定视觉系统，模板负责保持一致。

人物动作同样可以自由指定，例如：

• 站立讲解
• 指向内容
• 拿着平板
• 白板演示
• 坐着使用电脑

动作确认后，会写入人物 Profile，后续所有封面和正文都会保持一致。人物始终按比例渲染，不会为了填满版面而被拉伸或压缩。

教程截图也是正文的一部分

这是我制作 Skill 时最在意的一点。

很多排版工具只处理 Markdown 文本，要么完全丢弃图片，要么机械平均分配。

对于观点文章影响不大，但教程完全不同。

缺少一张关键截图，就可能导致读者无法完成整个操作流程。

因此，Punk XHS Cards 会先读取 Markdown 中的图片，再结合上下文判断它们的作用，并建立「步骤—截图—完成状态」映射。

优先保留的包括：

• 操作界面截图
• 输入内容示意图
• 设置完成后的结果图
• 流程图、结构图
• 缺失后影响理解的重要图片

装饰图、重复封面、头像、无关 Logo 则不会占用正文空间。

如果教程确实需要 12 张甚至 20 张卡片，Skill 会自动增加页数，而不会为了凑固定数量压缩截图或删除步骤。

教程的第一优先级，始终是让读者能够照着完成整个操作流程。

新封面设计

新版封面采用两层生成。

第一层由 Punk IP Article Illustrations 根据 Markdown 内容生成真正对应文章主题的插图，人物会参与内容表达，而不是站在旁边做装饰。

第二层由渲染器负责版式：

• 使用人物 Profile 的主题色
• 顶部放置简洁居中的书名
• 中间采用精细的 macOS 窗口
• 保留完整 16:9 插图
• 底部显示作者名称

作者名称来自建立人物时确认的人物名，而不是每次重新输入。

标题和作者文字均由渲染器绘制，不依赖生图模型，因此不会出现错字问题；字体也会根据 macOS、Windows、Linux 自动选择兼容方案。

最终会交付什么

默认情况下，一篇文章会生成：

• 1 张封面
• 9 张正文卡片

如果文章更长或教程截图更多，正文页数会自动增加。

最终目录如下：

<article-slug>-小红书/
├── source.md
├── cover-illustration.png
├── assets/article-images/
├── cards.json
├── publish-copy.md
├── output/
│   ├── cover.png
│   ├── card-01.png
│   └── ...
└── <article-slug>-小红书.zip

其中 publish-copy.md 包含：

• 1 个推荐标题
• 3 个备选标题
• 可直接发布的小红书正文
• 6～10 个推荐话题标签

全部图片生成完成后，还会自动检查：

• 文字是否截断
• 元素是否重叠
• 人物比例是否正确
• 教程步骤是否完整
• 是否遗漏关键截图

确认无误后，再打包生成最终 ZIP。

我最近测试的一篇 Obsidian 教程，最终生成了 1 张封面、17 张正文卡片，并完整保留了 16 张关键截图。

安装方式

项目已经开源到 GitHub。

使用 Codex 时可以直接安装：

git clone https://github.com/adrianpunk/punk-xhs-cards.git

cp -R punk-xhs-cards/punk-xhs-cards ~/.codex/skills/

Windows：

git clone https://github.com/adrianpunk/punk-xhs-cards.git

Copy-Item -Recurse punk-xhs-cards\punk-xhs-cards "$HOME\.codex\skills\punk-xhs-cards"

py -3 -m pip install -r "$HOME\.codex\skills\punk-xhs-cards\requirements.txt"

现在已经不再依赖 macOS 的 Swift 和 AppKit，而是采用 Python + Pillow 渲染器，Windows、Linux 和 macOS 共用同一套卡片数据与版式，仅 Linux 需要额外安装中文字体（Noto Sans CJK）。

封面阶段依赖 Punk IP Article Illustrations，因此请先确认该 Skill 已安装。

之后只需在新的 Codex 任务中发送：

请使用 $punk-xhs-cards。

先根据我上传的照片建立个人 IP，
确认人物、卡片动作和视觉风格后，
再把我提供的 Markdown 做成小红书知识卡片。

首次使用时，Skill 会依次确认：

• 人物照片（或已有 IP）
• 人物名称（作为封面作者）
• 主题色（建议提供 Hex）
• 人物动作

人物与视觉系统确认完成后，再开始处理长文，整个流程会更加顺畅。

当前边界

目前版本还有一些已知限制：

• Python + Pillow 已支持 macOS、Windows、Linux 共用版式；
• Linux 需要安装 Noto Sans CJK 中文字体；
• 运行环境需要支持图像生成；
• 封面插图依赖 Punk IP Article Illustrations；
• 当前主要针对中文教程和知识型长文进行了优化；
• 最终效果仍会受到人物照片、Markdown 结构以及原始截图质量的影响。

用户照片、人物 Profile、文章和生成结果都保存在运行目录，不会写入 Skill 安装目录，也不会上传到公开 GitHub 仓库。

最后

最开始，我只是想解决一个很简单的问题：如何把越来越多的教程和长文，更轻松地发布到小红书。

后来，从竖版 HTML 开始，一步步补齐了标题、封面、正文、Tags、教程截图、人物 IP 和视觉系统，最终形成了今天这套 Punk XHS Cards。

对于多平台创作者来说，最可惜的事情，就是一篇投入大量时间写好的内容，只在一个平台出现一次，然后慢慢沉下去。

Punk XHS Cards 想做的事情很简单：把已经完成的长文，以更适合小红书阅读的方式重新组织，同时保留你的内容、个人 IP，以及跨平台持续一致的品牌辨识度。

如果你也经常在 𝕏、公众号和小红书之间同步内容，不妨找一篇过去写过的教程，完整跑一遍，看看它能帮你节省多少重复工作。

项目地址：

https://github.com/adrianpunk/punk-xhs-cards