免费工具 llms.txt 检查:逐行校验格式
把网站 /llms.txt 的内容贴进来。工具按 llmstxt.org 描述的结构从头读到尾,列出每个问题和所在行号:缺标题或简介、解析器读不懂的链接、相对网址和重复链接、空分组。
- 问题带行号
- llmstxt.org 格式
- 本地运行
贴上 llms.txt,看问题清单
浏览器打开 https://你的域名/llms.txt,全选复制粘贴到这里。示例里故意留了三个错误,清单会随输入更新。
Markdown 格式,开头带 BOM 也可以。
分组
3
H2 标题数。
链接
6
解析器能读出的列表项。
错误
0
不符合格式。
警告
3
能读,但容易丢信息。
问题
- 警告第 10 行链接后面的文字没有冒号。说明要跟在「: 」后面,如「- [标题](网址): 说明」。注意用英文冒号。
- 警告第 11 行「/docs/webhooks.md」是相对网址。单独读取 llms.txt 的工具补不出域名;提案的示例都用完整网址。
- 警告第 16 行https://yunfan.example/docs/quick-start.md 在第 9 行已经列过。
- 说明第 18 行Optional 分组有 1 个链接。按约定,AI 工具上下文不够时可以跳过它们。
各分组概况
| 分组 | 链接 | 其他内容 | 行号 |
|---|---|---|---|
| 文档 | 3 | 只有链接 | 7 |
| 产品 | 2 | 只有链接 | 13 |
| Optional | 1 | 只有链接 | 18 |
版本 v1.0更新于 更新记录
错误、警告和说明
四个数字概括整份文件,清单逐条解释。
错误
文件根本不符合格式:没有 H1、H1 不在最前面、返回的是 HTML 网页,或者链接没有可用的网址。先改这些。
警告
解析器能读,但会丢信息:链接说明前没有「: 」、相对网址、重复链接、分组里夹着大段文字、空分组、缺简介。
说明
不算错,值得知道:Optional 分组可能被跳过、「*」列表符号参考解析器不认、没有提供 Markdown 版页面。
各分组概况
每个 H2 一行:有几个链接、有没有夹杂别的文字。整段都是文字的分组,内容一般应该挪到前面的补充说明里。
检查通过只代表文件符合提案格式,不代表有 AI 会读它:目前没有哪家主要 AI 公司确认它的爬虫会读取 llms.txt。
三步用完
手写的、插件生成的、文档平台导出的文件都能查。
-
1
复制线上文件
浏览器打开网站的 /llms.txt。如果看到的是网页或 404,这就是第一个要解决的问题。
-
2
粘贴、看清单
错误和警告都带行号,回到你的编辑器用「跳转到行」就能找到。
-
3
改完再查
改好后重新粘贴,直到只剩「正常」和说明。想从头生成,用 llms.txt 生成器。
逐行对照 llmstxt.org 格式
提案(llmstxt.org,2024 年 9 月)规定了文件的顺序。本工具照它检查,链接按它的参考解析器所用的正则来认。
- 最前面:带名称的 H1(必需),之前只允许 BOM
- 然后:一行引用块简介,再往下是任意非标题的 Markdown
- 然后:若干 H2 分组,每组是
- [名称](网址)列表,后面可跟: 说明 - 名为
Optional的分组放可以跳过的链接。其余检查(相对网址、重复链接)是好习惯,不是提案的硬性规定
| 这一行 | 识别为 | 结果 |
|---|---|---|
# 云帆客服 | 标题(H1) | 在第一行就正常 |
> 面向中小团队的… | 简介 | 紧跟 H1 就正常 |
- [价格](https://…/pricing): 各版本 | 带说明的链接 | 正常 |
- [API 文档](https://…/api.md) 接口地址 | 链接,说明没加冒号 | 警告 |
- [Webhook](/docs/webhooks.md): … | 相对网址的链接 | 警告 |
* [博客](https://…/blog) | 用 * 的列表项 | 说明 |
### 使用指南 | H3 标题 | 警告 |
价格 | https://…/pricing | 分组里的普通文字 | 警告 |
示例里的三个错误
示例文件能解析,但有三行会丢信息。下面逐条给出问题和改法。
| 行号 | 问题 | 改法 |
|---|---|---|
| 10 | API 文档链接后的说明没有冒号,解析器会丢掉它 | …api.md): 接口地址和鉴权方式 |
| 11 | /docs/webhooks.md 是相对网址 | https://yunfan.example/docs/webhooks.md |
| 16 | 「产品」里又列了一次快速开始(第 9 行已有) | 删掉重复的,或换成另一个页面 |
第 18 行 Optional 那条只是说明,博客链接放在那里没问题。另外注意说明前的冒号要用英文半角「:」,中文全角「:」解析器不认。
llms.txt 通常坏在哪
出问题的文件大多来自手工修改,或者各种工具自己发明的写法。
返回的是 HTML
单页应用或伪静态规则把 /llms.txt 也转给了首页。要看原始响应,不能只看浏览器里显示的样子。
写成大段文字
H2 下面的段落参考解析器会忽略。分组保持链接清单,背景写进每条链接的说明。
用了中文冒号
- [标题](网址):说明 用的是全角冒号,解析器只认半角 :,说明会丢。
嵌套标题
H3 小节不在格式里。拆成几个并列的 H2 分组。
拿真实的爬虫访问来对照
文件写对是简单的一步。到底有没有 AI 爬虫来读,看访问数据就知道。
怎么知道我的 llms.txt 写得对不对?
贴到上面。没有错误和警告时只显示一条「正常」,表示文件符合 llmstxt.org 的格式:H1 在最前,接着是简介引用块,然后是由 Markdown 链接组成的 H2 分组。
llms.txt 的格式要求是什么?
只有写网站或项目名的 H1 是必需的。之后提案期望有一行引用块简介、可选的非标题 Markdown,以及若干 H2 分组,分组里每项写成 - [名称](网址),可加 : 说明。
llms.txt 里的链接必须是完整网址吗?
提案没有明说,但它的示例全是完整网址,而且脱离网站单独读取时 /docs 补不出域名。所以本工具对相对网址给出警告。
为什么我写的说明没被识别?
多半是冒号的问题:要写 - [标题](网址): 说明,冒号是英文半角。漏了冒号或用了中文全角冒号,链接后面的文字都会被丢掉。
llms.txt 写对了,就能被 AI 搜索引用吗?
没有公开证据。Google 说 Google 搜索不需要 llms.txt,OpenAI、Anthropic 的爬虫文档也没有提到它,国内大模型厂商同样没有公开说明。格式正确只能保证会读它的工具能正确解析。
能检查 llms-full.txt 吗?
本工具检查的是 llms.txt 的结构。llms-full.txt 是一些文档平台放全文的做法,没有固定格式,这里的大部分规则不适用。
我贴的内容会上传吗?
不会。全部在浏览器里运行,这个工具也没有分享链接,粘贴的内容不会离开页面。