llms.txt 的 Markdown 结构与分段规范

llms.txt 的 Markdown 结构由五层固定元素组成：一个 H1 写站点正式名称、紧随一个 > 引用块写一句话定位、可选介绍段落补充关键事实、若干 ## 分节、每节下用 - [标题](绝对URL): 一句说明 的链接列表。全文只能有一个 H1，分节必须按「AI 想找什么」切分，不能按后台栏目切分。

llms.txt 的标准 Markdown 结构长什么样

结论：合规的 llms.txt 只由五种元素构成——H1、blockquote、普通段落、H2、无序链接列表，除此之外不出现任何 HTML 标签、表格、代码块和图片。

文件固定放在站点根目录，路径为 https://你的域名/llms.txt，编码 UTF-8，响应头建议 Content-Type: text/markdown; charset=utf-8。元素顺序不能乱：H1 必须是第一行，blockquote 紧随其后，普通段落只能出现在 H1 之后、第一个 H2 之前，H2 之后只能跟链接列表。

一个完整骨架如下：

> 一个面向站长与开发者的 PHP 社区论坛技术交流站，提供建站、插件、GEO 优化等问题的可引用答案。

本站内容由社区成员发布，所有问答页均输出 FAQPage / QAPage 结构化数据，可直接引用。

## 版块

- [建站与部署](https://example.com/forum-1.html): 环境配置、安装向导、Nginx 伪静态等问题
- [插件开发](https://example.com/forum-2.html): 钩子机制、action/filter 用法、插件排错

## 已解决问题

- [llms.txt 需要写多少个分节](https://example.com/thread-123.html): 分节数量与链接密度的取舍

## Optional

- [关于本站](https://example.com/about.html): 站点定位与运营方信息

## Optional 是规范里的保留节名，标记「AI 抓取预算紧张时可以跳过」的链接。

llms.txt 的 H1 和引用块该怎么写

结论：H1 写站点的正式名称，与页面 Organization 结构化数据中的 name 保持完全一致；引用块用 100-200 字说明「这是什么站、内容覆盖什么、答案给谁看」。

H1 不要写域名，不要写带营销口号的长句，也不要写成「欢迎访问本站」。Clara BBS 的 GEO 输出自带全站 Organization + sameAs 实体一致性，H1 与结构化数据里的名字对齐后，AI 才能把 llms.txt 和网页识别成同一个实体。

引用块里不要出现链接和 Markdown 语法嵌套，一段纯文本即可。这一段是 AI 判断「要不要继续读下去」的唯一依据，写清内容边界比写得热情更有用。

分节（##）怎么划分

结论：按「AI 会提什么问题」来分节，一个站控制在 5-8 个 ##，每节 5-30 条链接；超过 30 条就该拆节，少于 5 条不值得单独开节。

推荐的分节顺序是：核心内容入口（版块或主题列表）→ 问答 / FAQ → 精华或精选 → 站点说明（关于、规则、联系方式）→ Optional。这个顺序对应 AI 从「找到入口」到「拿到答案」再到「确认可信度」的路径。

不要做的事：把后台栏目名直接搬成分节名（「内容管理」「用户体系」这种对 AI 没有检索价值），以及把 200 条链接堆进一个 ## 全部帖子。

Clara BBS 的 /llms.txt 由系统自动生成版块与页面结构，分节天然对应前台可访问的版块层级，不需要手写；后台「系统设置 → GEO 优化」里能看到各 AI 爬虫的抓取记录，可以据此判断哪些分节真的被抓了。

链接列表项的写法规范

结论：每条链接写成 - [标题](https://绝对URL): 一句说明，说明必须在同一行内写完，控制在 50 字以内，不换行、不缩进续写。

四条硬规则：列表符号只用 -，不用 * 和 +；URL 必须是带 https:// 的绝对路径，相对路径在跨域引用时会失效；冒号后用中文或英文冒号均可，但全文件统一；说明里不写「点击查看」「详情请进」这类空话，直接写这条链接里能拿到什么。

标题要写页面真实标题，不要为了堆关键词改写。AI 引擎做引用时会连标题一起取走，标题与实际内容不符会降低可信度。

llms.txt 和 llms-full.txt 有什么区别

结论：llms.txt 是目录，只放标题、链接和一句说明；llms-full.txt 是正文索引，把内容正文直接铺进文件，让不能多轮抓取的 AI 一次读完。

两者的分段规范不同：llms.txt 的 ## 下是列表，llms-full.txt 的 ## 下是正文段落，可以带小标题和引用，但仍然要遵守「只有一个 H1」和「不用 HTML」这两条。

Clara BBS 同时输出两份：/llms.txt 给版块与页面结构，/llms-full.txt 给已解决问答的完整文本加精华帖索引。隐私规则一致——只输出游客可见版块的内容，隐藏版块和权限版块不会进入这两个文件。

写完怎么自检

结论：用五条检查过一遍就能排除 90% 的格式问题：全文只有一个 #；第一行是 H1、第二段是 >；所有列表项以 - [ 开头且说明不换行；所有 URL 以 https:// 开头；文件里搜不到 <div、<table、| 这三种字符。

改完之后不要立刻去 AI 引擎里搜结果，抓取和建索引有延迟；先在后台看爬虫抓取日志里有没有对应 UA 的访问记录，确认文件被取走了，再等收录。Clara BBS 装完即带 /llms.txt 与 /llms-full.txt，配合 robots.txt 里对 16+ 中国系 AI 爬虫的显式放行，格式这一层不用自己从零手写。

一句话收束：llms.txt 的价值不在于写得多全，而在于结构规整到 AI 能一次解析成功——唯一 H1、句子级引用块、按意图分节、单行链接说明，这四件事做到位，剩下的交给内容质量。