llms.txt格式规范详解:TITLE、H1、区块与链接语法
很多站长第一次手动写 llms.txt,容易凭感觉排版:标题写了两三行、简介写成一大段、 链接混着路径和锚点。文件是能打开,但 AI 解析起来很费劲,效果大打折扣。 这篇文章把 llmstxt.org 的规范逐段拆开讲:H1、引用块、区块、链接行到底该 怎么写,什么样的文件才算"写好",以及常见的格式错误长什么样。写之前建议 先看一眼 llms.txt 生成器 输出的标准样例, 对照着学最快。
规范的总原则:一个"精心挑选的 Markdown 子集"
按 llmstxt.org 的原始提案(查询时间 2026-09-13),llms.txt 本质是一个允许大模型 高效读取的 Markdown 文件,但它不是完整 Markdown:表格、图片、代码块这类 复杂元素尽量不用,因为 AI 抓取时主要按纯文本解析,结构越简单、信息越直接越好。
第一部分:# TITLE(唯一必填项)
文件第一行必须是 H1 标题,写网站或项目的名称。这是整个文件唯一必需的部分, 其他都能省略——但实际没人只写一行。
# 解忧工具箱
注意三点:第一,必须用 # 加一个空格,不是 ## 起头;
第二,紧跟在 H1 后面的内容会被 AI 当作对整站的概括,所以标题后面直接跟以下这段
引用块;第三,标题里别堆关键词,写真名。
第二部分:> 引用块(一句话简介)
H1 之后紧跟一个 Markdown 引用块(以 > 开头),用一两句话描述
网站是什么、提供什么。这是 AI 判断"这个站是否与用户问题相关"的第一依据,也是
全文里最容易被完整读完的一段,务必写得具体、可理解:
> 解忧工具箱(www.cqqzx.com)是一个提供 136+ 免费在线工具的纯前端工具站, 涵盖开发工具、跨境电商工具、设计工具等 13 大分类。所有工具 100% 在浏览器本地运行, 数据不上传服务器,无需注册。
不要写"欢迎来到我的网站"这类废话,直接把业务实质说清楚。
第三部分:可选描述段落(交代背景与规则)
引用块之后可以写若干普通段落,进一步说明项目逻辑、内容范围,或者"AI 该怎么理解 这个网站"。规范允许除标题外的任何 Markdown(段落、列表都行),但记住原则: 这是给 AI 的指引,不是给自己看的日记。
第四部分:## 区块 + 链接列表(核心资产)
后面用 H2 分区块,每个区块下是一个 Markdown 无序列表,每行一个链接,格式为:
## 主要页面 - [首页](https://www.cqqzx.com/) - [工具大全索引](https://www.cqqzx.com/tools/) - [行业笔记](https://www.cqqzx.com/blog/)
语法拆开看:[链接文字](URL) 是必填部分,后面可以加
: 描述文字 可选说明。规范原文的示例是
- [Link title](https://link_url) : Optional link details。
描述别省略——AI 在短上下文里可能只看描述来决定要不要打开这页。
一个特殊区块:## Optional(可选链接)
规范里有一个约定俗成的特殊区块名:## Optional。放在这个区块里的链接,
AI 在上下文紧张时可以直接跳过。用途是装"辅助性、非核心"的内容:
招聘页、活动页、历史归档等。核心价值页面放在普通区块,次要页面丢进 Optional,
这是给 AI 的隐性优先级信号。
好文件的五个要素
| 要素 | 要求 | 反例 |
|---|---|---|
| 一句话简介 | 引用块里说清业务实质 | "欢迎光临" |
| 清晰分区 | H2 分区逻辑分明 | 所有链接堆一个区块 |
| 精选少量高质链接 | 只列最值得读的页面 | 塞进全站几百个 URL |
| 维护日期 | 内容改版后同步更新 | 文件两年没动过 |
| 多语言指引 | 主语言内容 + 其他语言链接 | 多语言站只写中文 |
常见格式错误对照
- 错:第一行写
## 我的网站→ 对:用#单井号 - 错:简介不用引用块、直接一段大字 → 对:用
>开头 - 错:链接写相对路径
- [首页](/)→ 对:写完整https://绝对地址 - 错:在文件里放表格、贴一整段 HTML → 对:只留纯 Markdown 子集
- 错:链接后没有描述 → 对:
](url) : 一句话说明
格式细节还有疑问,可以先读 llms.txt 是什么 建立整体认知, 再对照本文逐行写。
不想手写?用生成器按规范产出
手动写一遍能加深理解,但正式上线建议用工具保证格式零错误:本站 llms.txt 生成器 内置 llmstxt.org 标准结构,你只需填网站名称、一句话描述、官网地址,再按需添加"摘要链接 / 文档链接 / 可选链接"三个区块,就能一键生成符合规范的标准文件,纯本地运行、内容不进服务器。 生成后照着 llms.txt 部署上线教程 上传即可。