llms.txt 怎么写？
规范、示例和常见坑

还不知道 llms.txt 是什么？先看《llms.txt 是什么？给中文站长的一篇讲透》。这篇只讲怎么写：规范拆开揉碎，附好坏对比，再告诉你我们从 1000 个网站实测里挖出来的 5 个坑。

01规范长什么样

llms.txt 是 Markdown，结构固定为四件套：

1. H1（一级标题）——网站名，只能有一个，放在最开头；
2. 引用块（>）——一句话介绍网站是干嘛的，紧跟 H1；
3. H2（二级标题）分组——按主题把链接分组，比如"产品""文档""博客"；
4. 链接列表——每个链接带一句话描述，格式：- [标题](地址)：一句话描述。

记住这个顺序，基本不会错。我们的生成器就是按这个结构出的文件。

02好坏示例对比

❌ 坏示例：链接裸奔

54 分

# 我的网站

## 链接
- https://example.com/a
- https://example.com/b
- https://example.com/c

毛病：没有一句话摘要；链接没有描述，AI 不知道点进去是啥；裸 URL 不如 Markdown 链接好读。

✅ 好示例：每句话都有用

96 分

# 我的网站

> 专注独立开发的个人博客，分享效率工具评测与出海经验，每周三更新。

## 精选文章
- [为什么我放弃了 Notion](https://example.com/posts/notion)：从 Notion 迁移到纯文本工作流的完整记录，含工具清单
- [独立开发第一年](https://example.com/posts/year1)：收入构成、踩过的坑、给新手的三条建议

## 关于我
- [关于](https://example.com/about)：前大厂程序员，现独立开发者，联系方式在这

好在哪：一句话摘要说清定位；每个链接都有描述，AI 能判断值不值得深入读；分组清晰。

035 个常见坑（来自 1000 站实测）

坑 1：返回 200，打开是 HTML 壳

164 个大站踩了这个坑：/llms.txt 返回 200，但内容是网站的 HTML 外壳，不是纯文本。SPA 站点最容易中招——路由没配好，什么路径都返回 index.html。AI 拿到的是壳，不是说明书，等于白做。

怎么避：部署后直接浏览器打开 你的域名/llms.txt，看到纯文本才算数。我们的在线体检会自动识别这种情况。

坑 2：链接只有地址，没有描述

这是独立站里最常见的毛病。站长花心思列了几十个链接，但每个都是光秃秃的 URL。AI 靠描述决定要不要点进去读——没描述的链接，基本等于没写。

怎么避：每个链接跟一句 15–30 字的话：这个页面讲什么、适合谁看。

坑 3：缺一句话摘要

H1 下面直接就是链接列表，没有 > 引用块摘要。AI 第一眼看不到"你是谁"，后面的链接就缺了上下文。

怎么避：H1 后面必须跟一句：网站是干嘛的、给谁看的、多久更新。

坑 4：链接重复、死链一堆

字节的 Coze 就是例子：文件做了，但 74 个警告，链接重复一堆，只拿 50 分。做了不等于做好。

怎么避：定期跑一遍校验，死链、重复一次清干净。

坑 5：更新了网站，忘了更新文件

llms.txt 是手写的，网站一改版，文件就过期。过期的说明书比没有更糟——AI 会一本正经地介绍你已经下线的产品。

怎么避：把"更新 llms.txt"写进发布 checklist，或者每次大改版后跑一次体检。

04部署 checklist

• 文件放网站根目录，路径必须是 /llms.txt；
• Content-Type 用 text/plain 或 text/markdown，别当 HTML 吐；
• 浏览器直接打开能看到纯文本（避开坑 1）；
• 跑一遍校验，80 分以上再发布；
• 大改版后记得更新文件（避开坑 5）。