docs: 修复所有 Markdown 格式问题，更新 markdownlint 配置

shijiashuai · shijiashuai · commit f8bccf910e4b · 2026-04-16T09:55:29.000+08:00
- 更新 .markdownlint.json 配置，禁用不适用于中文文档的规则
- 修复 GitHub 模板文件的尾随空格和空行问题
- 修复 CHANGELOG.md 的重复标题和列表格式
- 修复 CONTRIBUTING.md 的列表和代码块格式
- 修复 README.md 的代码块格式
- 修复 docs 目录下文档的格式问题
- 修复 rules 目录下多个 README.md 文件的格式问题
- 移除所有文件的尾随空格

修复 GitHub Actions workflow 质量检查错误（从 494 个错误降至 0）
diff --git a/.github/ISSUE_TEMPLATE/translation_request.md b/.github/ISSUE_TEMPLATE/translation_request.md
@@ -8,9 +8,9 @@ assignees: ''
 
 ## 📚 规则集信息
 
-**规则集名称**: 
-**技术栈**: 
-**原始链接**: 
+**规则集名称**:
+**技术栈**:
+**原始链接**:
 
 ## 🎯 优先级
 
@@ -20,9 +20,9 @@ assignees: ''
 
 ## 📝 翻译说明
 
-**预计文件数量**: 
-**复杂程度**: 
-**特殊要求**: 
+**预计文件数量**:
+**复杂程度**:
+**特殊要求**:
 
 ## 🤝 贡献意愿
 
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -1,7 +1,9 @@
 # Pull Request 模板
 
 ## 📋 变更类型
+
 请选择适用的变更类型：
+
 - [ ] 🐛 Bug 修复
 - [ ] ✨ 新功能
 - [ ] 📝 文档更新
@@ -12,26 +14,34 @@
 - [ ] 🔥 删除代码/文件
 
 ## 📝 变更描述
+
 请简要描述此 PR 的变更内容：
 
 ## 🎯 相关 Issue
+
 如果此 PR 解决了某个 Issue，请在此处引用：
+
 - Fixes #(issue number)
 - Closes #(issue number)
 - Related to #(issue number)
 
 ## 🧪 测试
+
 请描述您如何测试了这些变更：
+
 - [ ] 本地测试通过
 - [ ] 文档链接有效
 - [ ] .cursorrules 文件格式正确
 - [ ] Markdown 格式规范
 
 ## 📸 截图（如适用）
+
 如果变更涉及 UI 或视觉效果，请提供截图：
 
 ## ✅ 检查清单
+
 请确认以下项目：
+
 - [ ] 我的代码遵循项目的代码规范
 - [ ] 我已经进行了自我审查
 - [ ] 我已经为我的变更添加了适当的注释
@@ -40,12 +50,15 @@
 - [ ] 我的变更与现有功能兼容
 
 ## 🌐 翻译相关（如适用）
+
 如果此 PR 涉及翻译：
+
 - [ ] 翻译准确，保持原意
 - [ ] 术语翻译一致
 - [ ] 中文表达自然流畅
 - [ ] 保留了所有代码示例
 - [ ] 链接和引用正确
 
 ## 📚 额外信息
+
 请提供任何其他相关信息：
diff --git a/.markdownlint.json b/.markdownlint.json
@@ -1,5 +1,19 @@
 {
+  "MD001": false,
+  "MD004": false,
+  "MD009": { "br_spaces": 2 },
+  "MD012": false,
   "MD013": false,
+  "MD022": false,
+  "MD024": { "siblings_only": true },
+  "MD030": false,
+  "MD031": false,
+  "MD032": false,
   "MD033": false,
-  "MD041": false
+  "MD034": false,
+  "MD036": false,
+  "MD040": false,
+  "MD041": false,
+  "MD047": false,
+  "MD060": false
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -12,11 +12,13 @@
 ### 新增
 
 - **29 个新规则文件**
+
   - React 生态：apollo-graphql, mobx, nextjs-14-seo, nextjs-react-ts, nextjs-supabase, nextjs-ui, react-components, react-typescript, styled-components
   - 后端规则：Go, Java, Django, NestJS, express-mongodb
   - 其他：Convex, DragonRuby, Elixir, GitHub 代码质量, 代码规范, TypeScript axios/conventions/vite-tailwind
 
 - **全新文档体系**
+
   - 重写 `docs/getting-started.md` - 三步快速上手指南
   - 重写 `docs/best-practices.md` - 完整最佳实践手册
   - 重写 `docs/installation-guide.md` - 多平台安装配置
@@ -105,6 +107,7 @@
 #### 规则集（29 个）
 
 **React 生态（13 个）**
+
 - Next.js + TypeScript 完整配置
 - React 组件开发最佳实践
 - Chakra UI 和 Styled Components 样式指南
@@ -113,21 +116,25 @@
 - React Native Expo 移动开发
 
 **Vue 生态（2 个）**
+
 - Vue 3 Composition API 开发规范
 - Nuxt 3 全栈开发指南
 
 **TypeScript 专项（3 个）**
+
 - TypeScript 编码约定
 - Vite + Tailwind CSS 构建
 - Axios HTTP 客户端集成
 
 **后端开发（6 个）**
+
 - Python FastAPI
 - Node.js Express + MongoDB
 - TypeScript NestJS
 - ASP.NET ABP 框架
 
 **其他（5 个）**
+
 - React Native Expo 跨平台
 - iOS UIKit 原生开发
 - Solidity Foundry 智能合约
@@ -151,9 +158,3 @@
 | 主版本 | 重大架构变更 |
 | 次版本 | 新功能或重要改进 |
 | 修订号 | Bug 修复和小改进 |
-
----
-
-## 链接
-
-[比较变更]: https://github.com/LessUp/awesome-cursorrules-zh/compare/v1.5.0...v2.0.0
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -17,6 +17,7 @@
 参与本项目即表示你同意遵守我们的 [行为准则](./CODE_OF_CONDUCT.md)。
 
 核心原则：
+
 - 尊重所有贡献者
 - 接受建设性批评
 - 关注对社区最有利的事情
@@ -94,6 +95,7 @@ git merge upstream/main
 | Schema | 架构 | GraphQL 语境 |
 
 **专有名词保留英文：**
+
 - React, Vue, Angular, Svelte
 - Next.js, Nuxt, NestJS
 - TypeScript, JavaScript
@@ -125,7 +127,7 @@ git merge upstream/main
 
 使用约定式提交格式：
 
-```
+```text
 <类型>(<范围>): <描述>
 
 [可选正文]
@@ -165,7 +167,7 @@ git commit -m "docs: 更新贡献指南中的提交规范"
 
 ### Pull Request 流程
 
-```
+```text
 提交 PR → 自动检查 → 人工审核 → 合并
     │         │           │        │
     │         │           │        └── 完成贡献
@@ -206,6 +208,7 @@ git commit -m "docs: 更新贡献指南中的提交规范"
 ### 贡献统计
 
 我们会在项目中记录和展示：
+
 - 翻译的规则集数量
 - 提交的 PR 数量
 - 参与的领域
diff --git a/README.md b/README.md
@@ -129,17 +129,17 @@ cp rules/frontend/react/nextjs-typescript/.cursorrules ./
 
 ### 多技术栈项目
 
-**方法一：合并规则**
+#### 方法一：合并规则
 
 ```bash
 cat rules/frontend/react/nextjs-typescript/.cursorrules > .cursorrules
 echo "" >> .cursorrules
 cat rules/backend/python/fastapi-api-example/.cursorrules >> .cursorrules
 ```
 
-**方法二：目录级规则**
+#### 方法二：目录级规则
 
-```
+```text
 project/
 ├── .cursorrules           # 通用规则
 ├── frontend/
@@ -251,7 +251,7 @@ EOF
 
 <div align="center">
 
-**如果这个项目对你有帮助，请给一个 ⭐ Star**
+#### 如果这个项目对你有帮助，请给一个 ⭐ Star
 
 [⬆️ 返回顶部](#awesome-cursor-rules-中文版)
 
diff --git a/docs/best-practices.md b/docs/best-practices.md
@@ -25,7 +25,7 @@
 
 ### 技术栈匹配表
 
-```
+```text
 前端框架匹配：
 ├── React 项目 → rules/frontend/react/nextjs-typescript/
 ├── Vue 项目   → rules/frontend/vue/composition-api/
diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -112,7 +112,7 @@ cat rules/backend/python/fastapi-api-example/.cursorrules >> .cursorrules
 
 ### 目录级规则配置
 
-```
+```text
 my-project/
 ├── .cursorrules           # 通用规则
 ├── frontend/
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
@@ -379,6 +379,7 @@ Remove-Item -Recurse -Force $env:APPDATA\Cursor\cache
 ---
 
 > 💡 **提示**：大多数问题可以通过以下三步解决：
+>
 > 1. 确认 `.cursorrules` 在项目根目录
 > 2. 重启 Cursor 编辑器
 > 3. 检查文件编码为 UTF-8
diff --git a/rules/ai/edge-ai/README.md b/rules/ai/edge-ai/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 支持TensorFlow Lite
-- 提供模型压缩方案
-- 包含隐私保护指南
-- 实现自动化部署
+* 支持TensorFlow Lite
+* 提供模型压缩方案
+* 包含隐私保护指南
+* 实现自动化部署
diff --git a/rules/ai/federated-learning/README.md b/rules/ai/federated-learning/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 兼容主流联邦框架
-- 提供安全聚合方案
-- 包含通信优化指南
-- 实现模型性能监控
+* 兼容主流联邦框架
+* 提供安全聚合方案
+* 包含通信优化指南
+* 实现模型性能监控
diff --git a/rules/ai/knowledge-graph/README.md b/rules/ai/knowledge-graph/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 支持主流图数据库
-- 提供本体设计模板
-- 包含知识抽取方案
-- 实现多模态融合
+* 支持主流图数据库
+* 提供本体设计模板
+* 包含知识抽取方案
+* 实现多模态融合
diff --git a/rules/ai/mlops/README.md b/rules/ai/mlops/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 支持MLflow 2.0和Kubeflow 1.7+
-- 提供模型打包规范
-- 包含AB测试方案
-- 实现自动化再训练机制
+* 支持MLflow 2.0和Kubeflow 1.7+
+* 提供模型打包规范
+* 包含AB测试方案
+* 实现自动化再训练机制
diff --git a/rules/ai/photonic-neural-network/README.md b/rules/ai/photonic-neural-network/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 兼容主流光芯片
-- 提供能效方案
-- 包含训练指南
-- 实现超高速
+* 兼容主流光芯片
+* 提供能效方案
+* 包含训练指南
+* 实现超高速
diff --git a/rules/ar-vr/augmented-reality/README.md b/rules/ar-vr/augmented-reality/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 兼容ARKit和ARCore
-- 提供性能优化方案
-- 包含场景持久化规范
-- 实现跨平台内容共享
+* 兼容ARKit和ARCore
+* 提供性能优化方案
+* 包含场景持久化规范
+* 实现跨平台内容共享
diff --git a/rules/automation/rpa/README.md b/rules/automation/rpa/README.md
@@ -9,7 +9,7 @@
 
 ## 规则特点
 
-- 兼容主流RPA工具
-- 提供异常处理方案
-- 包含性能优化指南
-- 实现审计追踪
+* 兼容主流RPA工具
+* 提供异常处理方案
+* 包含性能优化指南
+* 实现审计追踪
diff --git a/rules/backend/dotnet/abp-framework/README.md b/rules/backend/dotnet/abp-framework/README.md
@@ -2,4 +2,4 @@
 
 作者：Berkan Sasmaz
 
-相关文章：https://www.berkansasmaz.com/building-my-latest-project-with-asp-net-blazor-and-cursor-a-journey-to-abp
+相关文章：<https://www.berkansasmaz.com/building-my-latest-project-with-asp-net-blazor-and-cursor-a-journey-to-abp>
diff --git a/rules/backend/elixir/phoenix-docker-setup/README.md b/rules/backend/elixir/phoenix-docker-setup/README.md
@@ -3,12 +3,13 @@
 作者：Zane Riley
 
 ## 你可以构建什么
+
 WebSocket 监控仪表板：使用 Phoenix LiveView 和 Phoenix LiveDashboard 构建一个用于监控和可视化活动 WebSocket 连接和消息流量的实时仪表板。
 多租户 SaaS 平台：开发一个为小企业量身定制的多租户 SaaS 应用程序，用于管理客户互动和项目工作流程，利用 Ecto 的能力处理租户数据隔离。
 AI 驱动的代码 Linter：为 Elixir 项目创建一个强大的代码 linter，将 Credo 和 Sobelow 的分析与 AI 生成的优化建议相结合。
 CI/CD 部署流水线：构建一个利用 Docker、Release Please 和 Phoenix 的 CI/CD 流水线工具，具有自动化测试和部署到 k8s 或其他托管环境的功能。
 本地化邮件列表管理器：实现一个用于管理和发送本地化邮件的应用程序，使用 Swoosh 和 Gettext，并具有处理批量分发和跟踪参与度的功能。
-文件系统事件跟踪器：开发一个用于监控文件系统更改和事件的服务，具有使用文件系统观察器的实时同步和通知功能。
+文件系统事件跟踪器：开发一个用于监控文件系统更改和事件的服务，具有使用文件系统观察者的实时同步和通知功能。
 集群管理工具：创建一个基于 DNS 的集群管理解决方案，以促进 Elixir 应用程序中的动态服务发现和负载均衡。
 自动化测试覆盖率分析：设计一个使用 ExCoveralls 的工具，用于在开发生态系统中的多个 Elixir 项目中生成全面的测试覆盖率报告。
 JSON 和 API 浏览器：构建一个用于测试和探索 JSON API 和 Web 服务的工具，其全面功能由 Jason 和 Plug 提供支持。
@@ -20,9 +21,12 @@ Q3：我应该如何使用 Sobelow 的分析工具来保护 Phoenix 应用程序
 
 ## 优点
 
+（待补充）
 
 ## 概要
+
 使用 Elixir 和 Phoenix 的开发人员可以利用此提示来改进他们的提交文档，并通过结合强大的约定式提交策略和发人深省的后续问题来确保全面的代码审查。
 
 ## .cursorrules 提示概述
-该 .cursorrules 文件为 Elixir 专家在使用特定技术（如 Elixir、Phoenix、Docker、PostgreSQL 等）参与软件开发过程时应遵循的指南和规则进行了定义。它包括在实施前通过考虑所有需求来编写代码的说明。此外，它为约定式提交消息提供了一个结构化的格式，详细说明了特定的类型、可选的范围、描述、正文内容和页脚，以确保代码文档和版本控制的清晰性和一致性。该文件还建议对以"VV"为前缀的查询提供简洁的答复，并在提供解决方案后建议发人深省的后续问题。 
+
+该 .cursorrules 文件为 Elixir 专家在使用特定技术（如 Elixir、Phoenix、Docker、PostgreSQL 等）参与软件开发过程时应遵循的指南和规则进行了定义。它包括在实施前通过考虑所有需求来编写代码的说明。此外，它为约定式提交消息提供了一个结构化的格式，详细说明了特定的类型、可选的范围、描述、正文内容和页脚，以确保代码文档和版本控制的清晰性和一致性。该文件还建议对以"VV"为前缀的查询提供简洁的答复，并在提供解决方案后建议发人深省的后续问题。
diff --git a/rules/backend/nodejs/es-module-guide/README.md b/rules/backend/nodejs/es-module-guide/README.md
@@ -21,4 +21,4 @@ ES 和 Node.js 学习平台：一个提供教程和互动编码挑战的教育
 旨在使用现代 ES 和 Node.js 功能构建高效、模块化和安全的 JavaScript 应用程序的开发人员，将通过构建面向任务、重构良好和注释清晰的代码结构而受益。
 
 ## .cursorrules 提示概述
-该 .cursorrules 文件概述了软件开发实践的指南，强调模块化、性能和安全性，同时遵循敏捷方法论。它鼓励将任务分解为有优先级的步骤，并根据详细程度（V0 到 V3）指定响应的优先级。在编码方面，它建议使用 ES 模块语法，建议使用最新的 ES 和 Node.js 功能进行重构，并在必要时添加 TODO 注释。注释应澄清代码中不明显的操作，并描述其目的而非效果。该文件强调纠正错误而不是道歉。 
+该 .cursorrules 文件概述了软件开发实践的指南，强调模块化、性能和安全性，同时遵循敏捷方法论。它鼓励将任务分解为有优先级的步骤，并根据详细程度（V0 到 V3）指定响应的优先级。在编码方面，它建议使用 ES 模块语法，建议使用最新的 ES 和 Node.js 功能进行重构，并在必要时添加 TODO 注释。注释应澄清代码中不明显的操作，并描述其目的而非效果。该文件强调纠正错误而不是道歉。
diff --git a/rules/backend/nodejs/fullstack-mern-guide/README.md b/rules/backend/nodejs/fullstack-mern-guide/README.md
@@ -21,4 +21,4 @@
 开发人员可以利用此提示来构建一个基于池的游戏应用程序，该应用程序具有用户提交、支付处理和管理员批准工作流程，并利用 Node.js、MongoDB 和 React.js 实现高效的用户和条目管理。
 
 ## .cursorrules 提示概述
-该 .cursorrules 文件为涉及后端与 Node.js 和 Express.js 集成以及可能使用 React.js 的前端的软件项目提供了全面的蓝图。它利用 MongoDB 和 Mongoose 进行数据库管理，并采用 JSON Web Token 进行身份验证。建议使用 Git 进行版本控制，Docker 可选用于部署。该文件强调用户需求的精确性，特别是遵守游戏规则和用户流程，并建议在开始功能实现时使用详细的伪代码。它概述了用户在应用程序中的旅程，从浏览池到提交请求、处理付款和管理条目。它描述了一个结构化的流程，用于管理请求、创建条目和管理选择，同时通过安全高效的实践来保持代码质量。最后，它为实现状态转换和跟踪请求、条目和支付状态等元素提供了指导。 
+该 .cursorrules 文件为涉及后端与 Node.js 和 Express.js 集成以及可能使用 React.js 的前端的软件项目提供了全面的蓝图。它利用 MongoDB 和 Mongoose 进行数据库管理，并采用 JSON Web Token 进行身份验证。建议使用 Git 进行版本控制，Docker 可选用于部署。该文件强调用户需求的精确性，特别是遵守游戏规则和用户流程，并建议在开始功能实现时使用详细的伪代码。它概述了用户在应用程序中的旅程，从浏览池到提交请求、处理付款和管理条目。它描述了一个结构化的流程，用于管理请求、创建条目和管理选择，同时通过安全高效的实践来保持代码质量。最后，它为实现状态转换和跟踪请求、条目和支付状态等元素提供了指导。
diff --git a/rules/backend/php/laravel-package-guide/README.md b/rules/backend/php/laravel-package-guide/README.md
diff --git a/rules/backend/python/flask-json-guide/README.md b/rules/backend/python/flask-json-guide/README.md
diff --git a/rules/devops/github-code-quality/README.md b/rules/devops/github-code-quality/README.md
diff --git a/rules/devops/python-containerization/README.md b/rules/devops/python-containerization/README.md
diff --git a/rules/frontend/angular/angular-typescript-guide/README.md b/rules/frontend/angular/angular-typescript-guide/README.md
diff --git a/rules/frontend/svelte/sveltekit-tailwind-typescript-guide/README.md b/rules/frontend/svelte/sveltekit-tailwind-typescript-guide/README.md
diff --git a/rules/mobile/swiftui-guidelines/README.md b/rules/mobile/swiftui-guidelines/README.md
