用途：在 Astro 项目中对 Markdown 进行格式化与校验，使用 markdownlint，并在过程中保留 frontmatter、代码示例与项目现有配置。
主要能力与用法：先识别项目契约，读取 package.json、lint 脚本、markdownlint 配置及工作区继承配置，找出被修改的文件，并区分 Markdown 与 MDX（MDX 含可执行语法，需对应的解析器或构建流程）。优先使用项目已有脚本；若没有 linter，则用与 lockfile 对应的包管理器将 markdownlint-cli 装为开发依赖，并在 package.json 中登记校验与修复脚本，同时划定文件范围、排除 node_modules、.git、dist 及生成文件。不得为了消除诊断而替换现有配置。
先运行校验再修复，--fix 仅作用于指定范围，阅读 diff 后手动处理剩余诊断。需保留 frontmatter 的值、链接目标、代码缩进与字面内容。修改标题后要检查依赖这些标题的带片段链接；表格应仍能正常渲染其列，lint 通过并不证明表格语义正确（例如被误转为段落）。
最后用不带 --fix 的同一命令复验；若项目存在 Astrofy 契约，运行 astrofy docs check；集合内容还需做 schema 校验与适用的构建。需报告已修复文件与剩余诊断，不得把格式化结果说成对文本的事实或编辑审查。
限制：未提供具体的 markdownlint 规则集、Astrofy docs check 的安装方式、价格与平台信息。