markdown-formatting
自动格式化Markdown文档，生成清晰的Git差异对比。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：markdown-formatting。 它的用途是：自动格式化Markdown文档，生成清晰的Git差异对比。 完整的 Skill 内容见：https://321skill.com/skills/markdown-formatting/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用markdown-formatting工具检查并格式化docs目录下的所有.md文件。’，它会运行格式化程序，自动调整文档的换行和结构，并输出修改了哪些文件。或者，在提交代码前，你可以说：‘帮我把这次改动涉及到的Markdown文件都格式化一下，确保diff清晰。’，它会执行格式化，让你提交的代码变更只包含实质内容。
介绍
该Skill旨在解决开发者在协作编写Markdown文档时，因格式不一致（如换行、缩进、列表结构）导致的Git提交历史混乱、代码审查困难的问题。它通过预定义的规则自动调整Markdown文件的格式，确保每次提交的差异（diff）只反映内容的实质性修改，而非无关的格式变动。
使用方式非常直接：在提交代码前或作为持续集成（CI）流程的一部分运行该工具。它会扫描指定目录下的Markdown文件，根据配置的规则（如每行最大字符数、列表项统一格式等）进行重排和格式化，输出整洁、统一的文档。
它非常适合需要频繁维护技术文档、项目README、设计文档或任何使用Markdown进行协作的团队，特别是前端开发、后端开发、全栈开发、文档工程师以及项目经理等角色，能显著提升代码仓库的可读性和协作效率。
建议将该Skill集成到项目的Git钩子（如pre-commit）或CI/CD流水线中，以实现自动化的格式检查与修复。注意，首次运行时可能会对历史文件产生较大的格式改动，建议在团队内同步规则后，在一个独立的分支上执行批量格式化，再合并到主分支，以避免干扰正在进行的工作。
核心特点
与通用的代码格式化工具（如Prettier）不同，它专门针对Markdown的语义和Git diff的可读性进行优化，例如智能处理长句换行以避免在单词中间断开，以及保持列表和标题的结构清晰，使版本对比时更容易定位到真正的文本增删。
注意事项
不适合用于格式化非Markdown文件（如纯文本、HTML），且其格式化规则可能不适用于对排版有特殊艺术化要求的创意写作场景。
常见问题
这个工具会影响Markdown的渲染效果吗？
不会，它只调整源代码的格式（如换行、空格），不改变Markdown的语义，因此渲染后的效果保持不变。
可以自定义每行的最大长度吗？
可以，通常通过配置文件（如.prettierrc）来设置‘printWidth’等参数，以适应不同的团队规范。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-formatting/raw/index.md 读取 markdown-formatting 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-formatting/raw/index.md（查看排版版本）