markdown-formatting
自动格式化Markdown文档，确保代码变更清晰可读。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：markdown-formatting。 它的用途是：自动格式化Markdown文档，确保代码变更清晰可读。 完整的 Skill 内容见：https://321skill.com/skills/markdown-formatting-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请使用markdown-formatting技能，帮我格式化`./docs`目录下的所有`.md`文件。'，它会扫描指定目录，根据预设的换行和结构规则调整所有Markdown文件的格式，确保它们符合规范，从而让你后续的Git提交记录只显示有意义的文本改动，而非杂乱的格式调整。
介绍
这个Skill主要解决开发者在协作编写Markdown文档时，因格式不统一（如换行、空格、列表缩进不一致）导致的Git版本对比（diff）混乱、难以阅读的问题。它通过预定义的规则自动调整文档结构，使每次提交的变更内容聚焦于实质性的文本修改，而非无关的格式调整。
使用时，你只需将待处理的Markdown文档或包含Markdown文件的目录路径提供给AI，AI便会调用此Skill对文档进行格式化处理。它通常作为代码提交前或文档整理阶段的一个自动化步骤，可以集成到你的本地工作流或CI/CD流程中。
它非常适合需要频繁编写和维护技术文档、项目README、API说明或任何使用Markdown进行协作的开发者、技术写作者和项目管理者。对于追求代码仓库整洁、重视团队协作效率的团队来说，这是一个提升文档质量的实用工具。
建议在团队中统一启用此规则，并将其作为代码审查或文档提交前的必要检查项。注意，它主要优化的是Git diff的可读性，而非文档的最终渲染样式。对于已经存在大量格式不一致的历史文档，建议在单独的分支中进行批量格式化，并确保团队成员知晓此次变更，以避免合并冲突。
核心特点
专注于为Git版本控制优化Markdown格式，核心目标是生成清晰、易读的代码变更记录（clean git diffs），而非仅仅美化文档的最终显示效果。它通过强制执行特定的换行和结构规则来实现这一目标。
注意事项
不适合用于格式化对最终渲染布局（如复杂表格、特殊HTML嵌入）有精确要求的Markdown文档，因为它优先考虑的是diff可读性而非视觉呈现。
常见问题
这个工具会改变我的Markdown内容吗？
会，但只改变格式（如换行、空格、列表缩进），不会修改你的文字内容，目的是让Git diff更清晰。
它能集成到Git钩子（pre-commit）中吗？
可以，你可以将此Skill的执行命令配置为Git的pre-commit钩子，在每次提交前自动格式化Markdown文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/markdown-formatting-x-6/raw/index.md 读取 markdown-formatting 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/markdown-formatting-x-6/raw/index.md（查看排版版本）