markdown-formatting
自动格式化Markdown文档，生成清晰的Git差异对比
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：markdown-formatting。 它的用途是：自动格式化Markdown文档，生成清晰的Git差异对比 完整的 Skill 内容见：https://321skill.com/skills/markdown-formatting-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用markdown-formatting技能检查并格式化当前目录下的所有.md文件。’，它会扫描项目中的Markdown文件，并按照预设的换行和结构规则自动调整格式，输出变更摘要。或者，在提交代码前
对AI说：‘运行markdown格式化检查作为预提交钩子’，它会集成到你的Git流程中，确保只有格式规范的文档才能被提交。
介绍
这个Skill解决了开发者在协作编写Markdown文档时，因格式不一致（如换行、空格、列表缩进）导致Git版本对比（diff）混乱、难以阅读的问题。它通过自动应用一套预定义的规则（如行宽限制、列表结构标准化）来格式化Markdown文件，确保每次提交的变更内容清晰明了，便于代码审查和追踪历史。
使用时，你可以将其集成到你的开发工作流中，例如作为Git提交钩子（pre-commit hook）或CI/CD流水线的一个检查步骤。当检测到Markdown文件变更时，它会自动运行，将文件格式化为符合规则的整洁状态，然后才允许提交或通过检查。
它非常适合需要频繁编写和更新技术文档、项目README、Wiki或任何Markdown格式内容的前后端开发、全栈开发和文档工程师。对于团队协作项目，它能显著提升文档维护的效率和代码审查的体验。
建议在项目初期就引入此Skill，并与团队成员统一格式化规则。注意，它主要优化的是Git diff的可读性，而非Markdown的语义正确性。对于已经存在大量历史格式不一致的文件，首次运行可能会产生较大的变更范围，建议在单独的分支中执行并仔细审查。
核心特点
与通用的Markdown美化工具（如Prettier）不同，此Skill的核心设计目标明确指向“生成干净的Git差异对比”，其规则（如严格的换行策略）专门为优化版本控制中的行级变更可读性而定制。
注意事项
不适合用于格式化对行内样式或特定排版有严格艺术性要求的Markdown文档（如诗歌、复杂表格）。
常见问题
这个工具和Prettier的Markdown格式化有什么区别？
它更专注于通过强制换行等规则来优化Git diff的可读性，而Prettier等工具可能更注重整体代码风格和可读性，目标不同。
它会改变我Markdown文档的渲染效果吗？
通常不会，因为标准的Markdown渲染器对换行和空格不敏感。它主要改变的是源代码的排版，以便在Git中更清晰地查看变更。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-formatting-x-9/raw/index.md 读取 markdown-formatting 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-formatting-x-9/raw/index.md（查看排版版本）