문서 사이트를 위한 llms.txt
게시일:
문서 사이트는 llms.txt의 가장 이상적인 활용 사례입니다. 사람들은 AI 도구에게 "당신의 제품에서 X를 어떻게 하나요"라고 끊임없이 묻는데, 잘 정리된 파일은 그런 모델을 정확한 페이지로 곧장 안내합니다.
문서가 가장 큰 혜택을 받는 이유
여러분의 문서는 이미 그 답 자체입니다. llms.txt를 사용하면 모델이 내비게이션, 검색 UI, 마케팅 페이지를 크롤링하게 두는 대신, 시작하기, 가이드, API 레퍼런스 같은 깔끔한 색인을 모델에게 건넬 수 있습니다.
사이트 구조에서 생성하기
대부분의 문서 사이트에는 이미 sitemap.xml이 있습니다. 그 URL들을 한 줄로 나열해 쏟아내기보다, 몇 개의 합리적인 섹션으로 묶으세요:
# Acme Docs > Documentation for the Acme API: setup, guides, and the full endpoint reference. ## Getting started - [Quickstart](https://acme.com/docs/quickstart): First request in 5 minutes - [Authentication](https://acme.com/docs/auth): API keys and scopes ## Reference - [Endpoints](https://acme.com/docs/api): Every endpoint and parameter ## Optional - [Changelog](https://acme.com/docs/changelog): Release history
Markdown 버전 연결하기
많은 문서 프레임워크(Docusaurus, MkDocs, Mintlify, GitBook 등)는 각 페이지의 Markdown 또는 일반 텍스트 버전을 제공할 수 있습니다. 그런 버전 — page.md — 을 연결하여, 모델이 내비게이션과 사이드바가 포함된 렌더링된 HTML 대신 깔끔한 콘텐츠를 파싱하도록 하세요.
전체 컨텍스트를 위해 llms-full.txt 추가하기
규모가 큰 문서 모음의 경우, 전체 텍스트를 인라인으로 담은 동반 파일 llms-full.txt를 게시하여 에이전트가 단 한 번의 가져오기로 모든 것을 수집할 수 있도록 하세요. llms.txt는 간결한 색인으로 유지하세요.
큐레이션한 다음 검증하기
파일을 직접 작성하든 플러그인으로 생성하든, 결과물을 검토하세요 — 자동 생성기는 너무 많은 내용을 포함하는 경향이 있습니다. 패턴은 llms.txt 예시를 참고한 다음, 검증하여 구조가 올바른지와 모든 링크가 정상적으로 연결되는지 확인하세요.