做一个 Markdown 转小红书笔记的 Skill：排版交给脚本，内容一个字不动

写长笔记发小红书，最烦的不是写，是排版：一段段手动拆、标题一改再改、Markdown 的星号和链接贴过去全是乱码。我做了一个小 Skill「xhs-note-polish」，把这件事交给一个确定性脚本：输入一篇 Markdown 草稿，输出可以直接复制到小红书发布的笔记文本，原文的事实、数据和结论一个字不动。

作品本身

整个包只有 6 个文件、约 24KB：入口是 SKILL.md，核心是一个零依赖的 Python 脚本 scripts/format_note.py，只用标准库，离线就能跑；另有排版规则说明、输出模板和一对输入输出样例。包很小，是因为它只做一件事——排版，不做生成：不从零写文案、不编造内容、不做图片和封面，发布到小红书也不是它管的事。

脚本做五件事，都是按规则算出来的。第一，提炼标题：取一级标题，给出最多 3 个 20 字以内的候选，发布时挑一个顺眼的就行。第二，拆长段：90 字以上的段落按句末标点拆成短段，段与段之间留空行，手机上读起来轻松。第三，清理标记：加粗、斜体、行内代码、链接、图片这些 Markdown 标记全部去掉只留文字，因为小红书正文不渲染它们，留着只会剩下一堆星号；二级以下标题变成📌独立行，列表统一符号，引用块加💡前缀。第四，提炼重点句和话题标签：重点句只能从原文原句里挑，标签只从原文真实出现的主题和加粗术语里选，最多 8 个，不塞无关热门标签。第五，数字数：统计正文和全文总字数，正文超过 1000 字会提醒删减，删哪段要先经人确认，脚本自己不删。

自测结果

样例是真实跑出来的，不是手写的。输入一篇带标题、加粗、列表、引用块和长段落的草稿，命令 python3 scripts/format_note.py examples/sample_input.md -o examples/sample_output.md，退出码 0，输出标题《杂乱笔记别手抄了》，全文约 512 字，标签 4 个。逐项核对过：长段确实拆开了，标记确实清干净了，重点句是原文原句，标签都来自原文主题。管道输入也能跑，空输入会退出并提示“输入为空，没法排版”，不产出假结果。规范上也合规：名字 xhs-note-polish 与目录名一致，描述 150 字，远低于各项上限。

两个实用心得

一是写和发分开。草稿阶段只管内容，排版阶段不改一个事实——这个分工定死了，脚本才敢放手跑，改稿的人也不用每次都逐字复核。二是别让工具替你撒谎。标题不写“必火”这类虚假承诺，标签不蹭无关品牌词，重点句不改写拼接出新结论；排版可以自动化，内容的可信度只能靠原文。

这个 Skill 是为 2026 华为开发者大赛·小红书 Skill 创新赛做的参赛作品，做法本身也通用：把一个反复出现的手工活，收成一个“只做一件事、每一步都可验证”的小工具，再配上真实跑通的样例，就是一个能复用的 Skill。