by 运行时依赖
安装命令
点击复制技能文档
Markdown Formatter 将纯文本或 Markdown 转换为结构良好、易于阅读的 Markdown。目标是帮助读者快速掌握关键点、亮点和结构 —— 而不改变任何原始内容。核心原则：仅调整格式并修复明显的拼写错误。永远不要添加、删除或重写内容。
用户输入工具 当此技能提示用户时，按照以下工具选择规则（优先顺序）： 首选当前代理运行时暴露的内置用户输入工具 —— 例如，AskUserQuestion、request_user_input、clarify、ask_user 或任何等效工具。 回退：如果没有此类工具，则发出编号的纯文本消息，并要求用户用所选的编号/答案回复每个问题。 批处理：如果工具支持每次调用多个问题，则将所有适用的问题合并到单个调用中；如果仅支持单个问题，则按优先顺序一次询问一个问题。 具体的 AskUserQuestion 引用如下 —— 示例 —— 在其他运行时中用本地等效项替换。
脚本目录 脚本位于 scripts/ 子目录中。 {baseDir} = 此 SKILL.md 的目录路径。 解析 ${BUN_X} 运行时：如果安装了 bun —— 则使用 bun；如果可用 npx —— 则使用 npx -y bun；否则建议安装 bun。 用实际值替换 {baseDir} 和 ${BUN_X}。
脚本目的 scripts/main.ts 主入口点，带有 CLI 选项（使用 remark-cjk-friendly 进行 CJK 强调） scripts/quotes.ts 用全宽引号替换 ASCII 引号 scripts/autocorrect.ts 通过 autocorrect 添加 CJK/English 空格
首选项（EXTEND.md） 按优先顺序检查 EXTEND.md —— 第一个找到的是获胜者： 优先顺序 路径 范围 1 .baoyu-skills/baoyu-format-markdown/EXTEND.md 项目 2 ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-format-markdown/EXTEND.md XDG 3 $HOME/.baoyu-skills/baoyu-format-markdown/EXTEND.md 用户主目录 如果没有找到，则使用默认值 —— 不需要为此技能进行首次设置。 EXTEND.md 支持： 设置 值 默认 描述 auto_select true/false false 跳过标题和摘要选择，自动选择最佳 auto_select_title true/false false 跳过标题选择 auto_select_summary true/false false 跳过摘要选择 其他 — — 默认格式选项，字体首选项
使用方法 工作流程分为两个阶段：分析（理解内容）然后格式化（应用格式）。 Claude 执行内容分析和格式化（步骤 1-5），然后运行脚本以修复字体（步骤 6）。
工作流程步骤 1：读取和检测内容类型 读取用户指定的文件，然后检测内容类型： 指标 分类 是否存在 --- YAML 前置内容 Markdown 是否存在 #、##、### 标题 Markdown 是否存在 粗体、斜体、列表、代码块、块引用 Markdown 以上均无 Plain text 如果检测到 Markdown，则使用 AskUserQuestion 询问： 检测到现有的 Markdown 格式。您想做什么？
- 优化格式（推荐）- 分析内容，改进标题、粗体、列表以提高可读性 - 运行字体脚本（间距、强调修复）- 输出：{filename}-formatted.md
- 保留原始格式 - 保留现有的 Markdown 结构 - 仅运行字体脚本 - 输出：{filename}-formatted.md
- 仅字体修复 - 在原始文件上运行字体脚本 - 不创建副本，直接修改原始文件
步骤 2：分析内容（读者的视角） 仔细阅读整个内容。从读者的角度思考：什么可以帮助他们快速理解和记住关键信息？ 生成分析，涵盖以下维度： 2.1 亮点和关键见解 作者的核心论点或结论 令人惊讶的事实、数据点或违反直觉的说法 难忘的名言或精心措辞的句子（金句） 2.2 结构评估 内容是否有明确的逻辑流程？是什么？ 是否存在自然的章节边界，但缺乏标题？ 是否存在可以通过视觉断行来改进的长文本？ 2.3 对读者重要的信息 可行的建议或收获 定义、解释关键概念 在正文中埋藏的列表或枚举 可以更清楚地以表格形式呈现的比较或对比 2.4 格式问题 缺失或不一致的标题层次 混合多个主题的段落 以正文形式书写的并行项，而不是列表 未标记为代码的代码、命令或技术术语 明显的拼写错误或格式错误 将分析保存到文件：{原始文件名}-analysis.md 分析文件作为步骤 3 的蓝图。使用以下格式： # 内容分析：{文件名}
亮点和关键见解
- [列出发现]
结构评估
- 当前流程：[描述]
- 建议章节：[列出标题候选项及其简要理由]
对读者重要的信息
- [列出可行项、关键概念、埋藏的列表]