.cursorrules 文件是什么？
连 .cursor/rules/*.mdc 一起讲清

两种格式

如果一个仓库两样都有，Cursor 更依赖 .cursor/rules/ 文件夹。旧的 .cursorrules 没坏，它只是同一个思路的上一代。

.mdc 文件是什么？

.mdc 文件就是顶部带一小段头信息的 markdown。那段头（frontmatter）给规则定作用域：一句描述，常常还有说明规则对哪些文件生效的文件 glob。头信息下面，就是普通 markdown，和你在任何地方写的标题、列表一样。

所以 .mdc 不是要新学的一门语言。它是一个顶部带点元信息的 markdown 文件。还不熟底下的语法，看 Markdown 怎么写。

放在哪

• .cursorrules 放在仓库根目录，挨着 package.json 或你项目对应的根配置。
• .cursor/rules/ 是根目录下的一个文件夹，装一个或多个 .mdc 文件。把规则拆到几个文件里（一个框架或一个概念一个），正是新格式的用意。

里面写什么（以及和其他文件的关系）

内容和每个 AI 规则文件装的是同一类东西：你的技术栈、约定、要跑的命令、边界。如果你仓库里还有 AGENTS.md 或 CLAUDE.md，它们为别的工具覆盖同样的内容。哪个工具读哪个文件的完整地图，看 我的 AI 工具读哪个规则文件？；里面具体写什么，看 AGENTS.md / CLAUDE.md 是什么？

用 NoteLoom 读你仓库里的 markdown

一旦看清这些全是 markdown，读它们就只是读 markdown。你仓库里的规则和文档，那些 AGENTS.md、CLAUDE.md、README.md，都是 markdown 文件，而 NoteLoom 直接在浏览器里打开文件夹，把它们在干净的 reading 视图里渲染出来，source 视图供你改、存回本地。

有一点要说清楚：它不会让 Cursor 听你的规则，也不连接 Cursor 或任何编程工具。它只打开、渲染、存回你的 markdown 文件。规则，以及编辑器听不听，都在你和你的工具之间。

具体操作：用 Chrome / Edge / Arc 打开 app.noteloom.cc，挂载你的项目文件夹，读或改里面的 markdown 文档。直接存回本地，不上云、不用账号。