Baoyu Markdown 排版整理技能（Format Markdown for Clearer Reading） Skill 技能

技能简介

Baoyu Format Markdown 是一款把「毛坯文字」变成「可扫读文档」的 Agent Skill，由 jimliu（宝玉）开发并开源，MIT 协议，当前版本 1.57.0，支持 Claude、Codex、Claude Code 三类工具，质量分 83、审核状态 complete，属 gold 级技能。它的定位非常克制：不改动作者的实质内容，只优化结构——标题层级、强调、列表、表格、引用、代码标记、frontmatter 以及排版细节。无论是从聊天窗口里粘出来的一段纯文本，还是排版混乱的 Markdown，它都能在不改变原意的前提下，把文档整理成读者可以快速扫读、定位和分享的形态。它尤其擅长中英混排（CJK）与英文之间的间距、强调符号和引号规范处理，中文写作场景下体验明显好于通用格式化工具。

核心能力

1. 输入类型识别：依据可见结构判断输入是纯文本还是 Markdown，再决定整理方式。
2. Frontmatter 生成与更新：自动补齐或更新标题、slug、摘要、描述与封面图路径等元信息。
3. 结构增强：优化标题层级、强调、列表、表格、引用块与代码标记，提升可读性与扫读效率。
4. 安全改写策略：默认输出带 -formatted.md 后缀的副本；仅在纯排版调整时才会改动原文件。
5. CJK 排版修正：处理中文与英文之间的空格、强调符号、可选的引号替换与 frontmatter 格式化。
6. 内容保全：逐句保留实质内容，不做删改或概括，避免「格式越整越丢信息」。

安装配置

1. 确认本机具备可运行 npx 的 Node.js 环境。
2. 执行 npx skillstore add jimliu/baoyu-format-markdown 安装该技能。
3. 确认文件系统与外部命令权限可用（技能会读写 Markdown 文件）。
4. 在 Claude / Codex / Claude Code 中启用后即可调用。

使用步骤

1. 提供文稿：把草稿或待整理的 Markdown 文件路径交给 Agent。
2. 声明目标：说明「整理为可读 Markdown，保留每句实质内容，补标题与摘要」等要求。
3. 运行格式化：技能识别输入类型并执行结构优化与 CJK 排版修正。
4. 检查副本：打开生成的 -formatted.md 核对结构与内容是否完整。
5. 按需确认入库：确认无误后再替换原文件或提交发布。

适用场景

1. 润色草稿文章：在不改动实质写作的前提下提升结构与可扫读性。
2. 规范化技术笔记：为工程笔记补齐一致的标题、代码标记、列表与 frontmatter。
3. 修复中文排版：对既有 Markdown 应用 CJK 与英文间距、强调与引号处理。
4. 发布前整理：把聊天记录或零散文本整理成可直接发布的文档形态。

适用人群

• 经常写公众号、博客与长文的内容创作者
• 需要统一文档规范的技术写作者与工程团队
• 关注中文排版质量、追求阅读体验的中文写作者
• 需要把零散素材快速整理成正式文档的运营与产品人员

工作原理

技能以「结构优先、内容不动」为原则工作：第一步识别输入是纯文本还是 Markdown，第二步按规则重建文档骨架（frontmatter、标题层级、列表、表格、引用、代码标记），第三步针对中文场景执行 CJK 与英文间距、强调与引号等排版修正，最后把结果写成副本文件，除非任务本身就是纯 typography 调整。由于全程不删改实质句子，输出可以直接用于发布或归档。

官方链接

• 技能页面：https://skillstore.io/skills/jimliu-baoyu-format-markdown
• 项目仓库：https://github.com/jimliu/baoyu-skills
• 安装命令：npx skillstore add jimliu/baoyu-format-markdown