前言¶

拿到一篇没排版的稿子，最常见的状态是：没有 frontmatter，没有标题层级，重点句和普通句长得一样，段落里躺着本该拆成列表的并列项。手工去改，时间花在加粗、拆段、调层级这些机械动作上，真正该花时间的反而没时间。

Baoyu Format Markdown 做的就是这一步：输入一个纯文本或 Markdown 文件，输出排版好的成品，原内容不增不删。

这是什么¶

Baoyu Format Markdown 是一个通用 SKILL.md 格式的 Skill，坐标 @clawhub_jimliu/baoyu-format-markdown，由 Jim Liu（宝玉，@jimliu）发布维护，上游仓库在 ClawHub（https://clawhub.ai/jimliu/baoyu-format-markdown），SkillHub 上归入 office-efficiency 分类。

它的定位是文章排版器：把纯文本或 Markdown 变成结构清晰、读者能快速抓住重点的版本。核心原则写在 SKILL.md 里——只调整格式、修正明显错别字，不新增、不删除、不改写内容。

在 SkillHub 上的版本是 1.117.2，评分 100000，下载 12412 次，安装 96 次。

核心功能¶

下面介绍的能力都来自 SKILL.md 的说明。

1、前置元数据。检查是否存在 --- 包裹的 YAML frontmatter，没有则创建，字段包括 title、slug、summary、description、coverImage。其中 coverImage 只在同目录存在 imgs/cover.png 时取相对路径。

2、标题与摘要。正文第一行如果是 H1，提取到 frontmatter 并从正文移除。标题按流程生成候选（hook 公式 + 直白标题，共 4-5 个）交给用户选择，summary 为一句话摘要，description 为更长的描述。

3、结构重排。补标题层级、给长段落加视觉分隔、把埋在叙述里的并列项拆成列表、把代码和命令包进代码块、识别适合做成表格的对比内容。

4、排版细节。加粗重点句、统一列表与引用格式、修正标题层级跳级。

5、错别字与排版脚本。scripts/ 目录下三个脚本：main.ts 是带 CLI 选项的主入口（用 remark-cjk-friendly 处理中日韩强调），quotes.ts 把 ASCII 引号换成全角引号，autocorrect.ts 用 autocorrect 补齐中英文之间的空格。

6、输出命名。排版结果写到 {filename}-formatted.md，不覆盖原文件；中间产物 {original-filename}-analysis.md 是分析稿，作为排版的蓝图。

安装与启用¶

官方页面给出的安装方式是 ClawHub 的 CLI，命令如下：

openclaw skills install @jimliu/baoyu-format-markdown

安装后 Skill 放在本地 SKILL.md 目录下，{baseDir} 指向该目录，scripts/ 子目录里的脚本用它定位。运行时先解析 ${BUN_X}：装了 bun 就用 bun，只有 npx 就用 npx -y bun，两者都没有则提示安装 bun。

页面同时列出了 npx skills 和 Prompt 两种安装入口，具体参数页面未展开，这里不写。

Cursor、Codex CLI、Claude Code 的差异，抓取到的资料里没有说明，不做推测。

典型用法¶

Skill 内部是先分析再排版的两阶段流程，前 5 步由模型完成，第 6 步跑脚本。

第一步识别内容类型。判断依据是：有 --- YAML frontmatter、有 #/##/### 标题、有加粗斜体列表代码块引用，都算 Markdown，否则算纯文本。识别为 Markdown 时会先问用户要哪种处理：优化格式（默认推荐）、保留原有格式、只做排版修正。纯文本则直接进下一步。

第二步从读者视角分析内容，覆盖四个维度：核心观点与亮点、结构评估、读者需要的信息、排版问题，外加错别字清单。分析结果存成 {original-filename}-analysis.md。

第三步处理 frontmatter、标题和摘要，按上面第 1、2 点的规则生成并让用户挑选。

第四步按分析稿改写正文层级和列表，第五步生成最终 Markdown。

第六步跑脚本做排版修正。全流程结束后产出 {filename}-formatted.md。

适用场景与注意¶

适合的场景：草稿、会议纪要、技术笔记这类已经有内容但排版不到位的 Markdown 或纯文本文件；需要在不改原意的前提下提升可读性时。

需要注意的点：

1、它不做内容改写。指望它补数据、补论证、重写段落会失望，原则是只调格式、只修明显错别字。

2、需要交互。标题和摘要默认会让用户选，不配 auto_select 就会在这一步停下来等输入。

3、依赖 bun。没有 bun 且没有 npx 时无法跑 scripts/ 里的脚本。

4、脚本只做排版修正，中文引号替换、中英文空格这类改写是刻意的，不适合需要保留半角引号的技术文档。

5、输出是新文件，原文件不动，除非用户选了「只做排版修正」——那个分支会直接原地修改。

配置项写在 EXTEND.md 里，按优先级查找，第一个命中的生效：项目级 .baoyu-skills/baoyu-format-markdown/EXTEND.md、XDG 级 ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md、用户级 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md。三个都找不到就用默认值，不需要首次配置。已知的开关是 auto_select、auto_select_title、auto_select_summary，默认都是 false。

结尾¶

Baoyu Format Markdown 解决的是排版这一件事，边界划得清楚：内容不动，格式和错别字管到底。对已经在人工排版的写作流程来说，它可以把机械的那部分交出去。

官方地址：https://api.skillhub.cn/zcwl/baoyu-format-markdown
上游仓库：https://clawhub.ai/jimliu/baoyu-format-markdown