자주 발생하는 llms.txt 실수
게시일:
대부분의 llms.txt 문제는 몇 가지 패턴으로 압축됩니다. 다음은 저희 validator가 가장 자주 표시하는 문제들과 각각의 빠른 해결 방법입니다.
1. H1이 두 개 이상
명세는 최상위 # Title이 정확히 하나만 있기를 요구합니다. 추가적인 # 제목은 구조를 혼란스럽게 만듭니다. 나머지는 ## 섹션 제목으로 강등하세요.
2. 인용문(blockquote) 요약 없음
제목 바로 아래에 한두 문장으로 된 인용문은 모델이 가장 먼저 읽는 맥락입니다. 이를 생략하는 것은 가장 흔히 놓치는 부분입니다. 다음과 같이 추가하세요:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. 링크 없는 섹션 (또는 섹션 자체가 없음)
비어 있는 ## 섹션은 아무런 도움이 되지 않습니다. 각 섹션에는 실제 페이지로 연결되는 Markdown 글머리 기호 목록이 들어 있어야 합니다. 섹션이 전혀 없다면, 핵심 페이지들을 ## Docs나 ## Guides 같은 제목 아래로 묶으세요.
4. 깨진 링크
파일이 완벽하게 형식을 갖췄더라도 죽은 페이지를 가리킬 수 있습니다 — 이는 크롤러의 예산을 낭비하고 신뢰를 떨어뜨립니다. 모든 URL은 정상적으로 연결되어야 합니다. 이것은 대부분의 도구가 건너뛰는 검사이지만, 저희는 각 링크를 직접 가져와 확인합니다.
5. 상대 링크 또는 http:// 링크
모든 곳에서 절대 https:// URL을 사용하세요. 모델은 /docs/start 같은 상대 경로를 해석하지 못할 수 있으며, 일반 http:// 링크는 신뢰하기 어려워 보이고 HTTPS 전용 크롤링에서 작동하지 않을 수 있습니다.
6. 잘못된 콘텐츠 유형
파일은 text/plain; charset=utf-8로 제공하세요. 서버가 text/html을 반환하면(흔한 설정 오류), 일부 소비 주체는 이를 llms.txt로 취급하지 않습니다.
7. 비대하고 정제되지 않은 파일
llms.txt는 정제된 인덱스이지, 사이트맵을 통째로 쏟아낸 것이 아닙니다. 설명 없는 수백 개의 링크는 신호를 파묻어 버립니다. 가장 좋은 페이지만 남기고, 각 항목 뒤에 짧은 : description을 추가하며, 부차적인 링크는 ## Optional 섹션으로 옮기세요.
한 번에 모두 잡아내기
파일을 validator로 검사해 보세요 — 구조, 링크 도달 가능성, 모범 사례를 점수화하고 위의 항목 중 무엇을 고쳐야 하는지 정확히 알려줍니다. 이 형식이 처음이라면 llms.txt 파일 만드는 방법부터 시작하세요.