用途:当用户要求格式化 Markdown 文档、修复语法错误、优化排版、智能分段、清理冗余内容或检查文档质量时使用。
主要能力与流程:
- 语法检查与修复:运行 python3 ~/.claude/skills/markdown-checker/scripts/check_markdown.py "文件路径" 检查文档。按优先级处理:错误(链接格式、代码块闭合、列表格式)必须修复;警告(行尾空格、标点、缩进)建议修复;提示(排版建议)可选。YAML frontmatter 的 --- 会被误报为列表,可忽略。只修复真正影响语法的问题。
- 智能分段:长段落(超过 100 字符)需分段,在句号、问号、感叹号后分段,冒号、分号后若为完整句子也可分段,同时保持语义与逻辑连贯。
- 排版优化:移除行尾多余空格、移除连续空行(最多保留 2 行)、修复明显排版错误;可选在中英文之间及中文标点后接英文时加空格,但属个人偏好,不宜过度修改。
- 内容清理:移除重复空行、统一列表符号、检查 YAML frontmatter 格式、验证图片链接是否有效。
- Emoji 图片引用处理:识别如
的模式;若 alt text 含 emoji 则直接替换为 emoji,否则删除整个图片引用。此类 Twitter/X 的 SVG emoji 链接在 Markdown 中不适合直接显示。
使用偏好与注意:优先保证语法正确、保持原文语义不变、段落合理;处理从 Twitter/X 等抓取的 clipping 文档时内容密集,需合理分段并保留原始信息。不要自动修改代码块内容、特殊格式(表格、数学公式)及用户自定义格式。大量修改(超过 10 处)或涉及内容重写、不确定是否修改时,先告知或询问用户。格式化后重新运行 markdown-checker 确认错误已修复,读取文件确认语义正确,并告知用户修复了哪些问题。