baoyu-format-markdown 适合文章已经写完，但标题层级、列表、加粗与中英混排不够清楚的情况。它强调只整理格式与明显错字，不扩写论点；如果需要改写内容，应把那作为另一个明确任务。
安装与调用
在项目目录的终端运行下面的命令，只安装这个 Skill 到 Claude Code：
npx skills add jimliu/baoyu-skills --skill baoyu-format-markdown -a claude-code
需要 Node.js 和可用的 npx。若使用 Codex，把 -a claude-code 换成 -a codex；在对话里明确要求使用 baoyu-format-markdown 并附上材料，不把终端安装命令当成任务提示。其他客户端应使用自身的技能选择入口。
先说明是否允许动标题和结构
原稿已有 Markdown 时，工作流会区分优化排版、保留原结构和只修排版问题。首次建议明确要副本，并说明哪些标题、引用或代码必须原样保留。可以这样输入：
使用 baoyu-format-markdown 整理 article.md，输出独立副本。
可以调整标题层级、列表和重点加粗，正文不增删改写。
保留现有标题，代码和引用文字不变；修正明显错字时给出改动表。
中英文间距与中文强调标记可修复，不替换英文引号。
完整流程先读全文并保存 article-analysis.md，再形成 article-formatted.md。它可以补 frontmatter 中的标题、slug、摘要等字段；正文首个 H1 可能移到标题元数据中，所以对比时要同时看元数据和正文，不要误以为标题凭空消失。
结构整理与脚本修复是两回事
标题、段落和列表由 Agent 根据文章内容整理，随后脚本处理排版细节。默认启用中英间距与强调修复，ASCII 引号替换默认关闭；需要保持间距时可用 --no-spacing，不处理强调可用 --no-emphasis。让 Agent 从实际安装目录定位脚本，不把说明里的占位路径直接执行。
脚本使用 Bun，没有本地运行时可按工作流用 npx -y bun；安装之后仍找不到命令时先检查 PATH。只修排版的入口可能原地修改文件，和完整流程生成副本不同，因此一开始说明“独立副本”能避免混淆。
完成后比较正文事实、数字、引语和代码，确认没有为了看起来简洁而删段落，也没有把所有句子都加粗。再用目标编辑器渲染，检查嵌套列表、表格、代码块和中文标点旁的强调是否正常。分析文件是工作记录，实际交付通常用 formatted 文件；若下一步转 HTML，应以确认后的这份文件为输入。
把访谈记录整理成可发表稿时
原稿可能混有无标题的长段、编号步骤、原话引用和代码片段。先说明哪些句子是采访对象的原话、哪些是操作指令；让 Agent 优化标题和列表，却不把原话改写成作者观点。完成 article-analysis.md 后先看它是否正确分清材料类型，再检查 formatted 版中每个操作步骤的顺序有没有变。换行和加粗改善可读性，但不能悄悄修正未经核实的事实。
如果稿件本来有精心设计的标题结构，选择“保留原结构”只做排版副本；只想修中英间距时选 typography-only，并先复制原件，因为那条路径可能原地写入。验收时用差异工具重点看代码块、数字、引号和链接；再实际渲染一次，确认 frontmatter 没被当正文显示。若格式化后的文稿把第一标题移入元数据，下游页面仍需显示标题，不能仅凭 Markdown 正文少了一行判断内容丢失。
在转成发布稿前做最后整理
让它处理接近定稿的 Markdown，而不是一边补事实一边改版式。Just Jason 的文章流程把 baoyu-format-markdown 排在写作和图片压缩之后、转换公众号 HTML 之前；这一位置适合做标题层级、摘要和强调的最后整理。格式化完成后用 diff 看正文事实、链接、代码块和图片路径有没有被意外改动，再打开目标渲染器预览。若你的站点使用 MkDocs Material 等扩展语法，还要额外检查公式、表格及告诫块；这些语法需要按目标渲染器规则处理，不能假定通用格式化脚本已覆盖。
有一位 MkDocs Material 用户基于宝玉的格式化流程另做专用 Skill：在 300—400 行、含大量公式和表格的笔记里，先用 AST 识别结构，再只补目标渲染器需要的空行，并保留原文。它展示的是衍生实现，而非原 Skill 已内置这些规则。若你的稿件也包含公式或扩展块，应先用小样本确认目标网站的渲染，再决定是否需要专门的后处理。