AI 답변의 기준 · 공식 문서
llms.txt 형식과 예시, 직접 쓰는 작성 순서
llms.txt 는 # 사이트 이름, > 한 줄 요약, 설명 문단, ## 묶음별 - [이름](URL): 설명 순서로 쓰는 마크다운 파일이고, 필수는 H1 1줄입니다. 제안 문서는 링크가 각 페이지의 .md 판을 가리키게 하고, 파일은 맥락에 들어갈 만큼 작게 두라고 적었습니다.
llms.txt 는 형식이 단순한 대신 줄마다 자리가 정해져 있습니다. 제안 문서는 구성 요소를 정해진 순서로 쓰라고 적었습니다.
제안 문서 v2 원문을 줄 단위 문법으로 옮기고, 업종별 예시 파일을 실었습니다. 파일이 무엇이고 구글이 어떻게 대하는지는 「llms.txt 란? 제안 문서·구글 입장·국내 사용 현황」 편에 자세히 적었습니다.
발견 01
llms.txt 는 줄 모양 6가지로 쓰고, 필수는 H1 한 줄입니다
| 자리 | 줄 모양 | 필수 여부 | 제안 문서 원문 |
|---|---|---|---|
| 사이트 이름 | # 이름 | 필수 | An H1 with the name of the project or site. This is the only required section프로젝트나 사이트 이름을 적은 H1. 유일한 필수 부분이다. |
| 한 줄 요약 | > 요약 문장 | 선택 | A blockquote with a short summary of the project, containing key information necessary for understanding the rest of the file파일의 나머지를 이해하는 데 필요한 핵심 정보를 담은 짧은 프로젝트 요약 인용문(blockquote). |
| 설명 문단 | 제목 없는 문단·목록 | 선택 | Zero or more markdown sections (e.g. paragraphs, lists, etc) of any type except headings, containing more detailed information about the project and how to interpret the provided files제목을 뺀 아무 유형의 마크다운 단락(문단·목록 등) 0개 이상으로, 프로젝트에 대한 자세한 정보와 제공 파일을 해석하는 방법을 담는다. |
| 링크 묶음 | ## 묶음 이름 | 선택 | Zero or more markdown sections delimited by H2 headers, containing “file lists” of URLs where further detail is availableH2 제목으로 나뉜 마크다운 단락 0개 이상으로, 자세한 내용이 있는 URL 의 「파일 목록」을 담는다. |
| 링크 한 줄 | - [이름](URL): 설명 | 묶음 안에서는 링크 필수, 설명 선택 | Each “file list” is a markdown list, containing a required markdown hyperlink [name](url), then optionally a : and notes about the file.각 「파일 목록」은 마크다운 목록이며, 필수인 [이름](url) 링크 뒤에 선택으로 : 와 파일 설명을 붙인다. |
| 건너뛸 수 있는 묶음 | ## Optional | 선택 | The “Optional” section is used, by convention, for secondary information: links an agent can skip when a shorter context is needed.「Optional」 묶음은 관례상 부차 정보 자리다. 맥락을 짧게 써야 할 때 에이전트가 건너뛸 수 있는 링크다. |
설명 문단에는 제목(#·##)을 쓸 수 없습니다. H2 제목은 링크 묶음이 시작되는 자리이기 때문입니다.
Optional 묶음은 맥락이 짧을 때 에이전트가 건너뛰는 자리입니다. 연혁·소개처럼 없어도 답에 지장 없는 링크를 둡니다.
발견 02
업종이 달라도 뼈대는 같고, 링크 묶음 이름만 업종에 맞춥니다
The same structure works anywhere agents need a guided path into a site’s content: a business outlining its structure and policies, a personal site answering questions about someone’s CV, or a school providing access to course information.
같은 구조는 에이전트가 사이트 안내를 받아야 하는 어디서든 쓸 수 있다. 기업이 조직과 정책을 소개하거나, 개인 사이트가 이력을 답하거나, 학교가 강의 정보를 안내하는 경우다.
예시 ① 문의형 기업 사이트(B2B)
제품 묶음과 거래 안내 묶음으로 나눴습니다. 목록 링크는 5줄입니다.
| 줄 | 내용 |
|---|---|
| 1 | # 예시정밀 |
| 2 | > 예시정밀은 반도체 장비용 진공 부품을 설계·제조하는 기업입니다. |
| 3 | 모든 제품은 주문 제작이며, 견적은 문의 양식으로 받습니다. |
| 4 | ## 제품 |
| 5 | - [진공 밸브](https://example.com/products/valve.md): 구경별 사양과 표준 납기 |
| 6 | - [진공 챔버](https://example.com/products/chamber.md): 재질·크기 선택표 |
| 7 | ## 거래 안내 |
| 8 | - [견적·주문 절차](https://example.com/order.md): 문의부터 납품까지의 단계 |
| 9 | - [품질 인증](https://example.com/quality.md): 보유 인증과 출하 검사 기준 |
| 10 | ## Optional |
| 11 | - [회사 연혁](https://example.com/history.md) |
예시 ② 쇼핑몰(B2C)
상품 분류와 구매 정책으로 나눴습니다. 가격·재고처럼 자주 바뀌는 값은 파일에 적지 않고 상품 페이지로 보냅니다.
| 줄 | 내용 |
|---|---|
| 1 | # 예시리빙 |
| 2 | > 예시리빙은 원목 가구를 직접 만들어 파는 온라인 쇼핑몰입니다. |
| 3 | 가격과 재고는 상품 페이지가 기준이고, 배송·교환 규정은 아래 정책 링크가 기준입니다. |
| 4 | ## 상품 분류 |
| 5 | - [식탁](https://example.com/category/table.md): 크기·수종별 상품 목록 |
| 6 | - [의자](https://example.com/category/chair.md): 식탁 높이에 맞춘 의자 목록 |
| 7 | ## 구매 정책 |
| 8 | - [배송 안내](https://example.com/policy/shipping.md): 지역별 배송 기간과 비용 |
| 9 | - [교환·반품](https://example.com/policy/returns.md): 신청 기간과 절차 |
| 10 | ## Optional |
| 11 | - [브랜드 소개](https://example.com/about.md) |
예시 ③ 공공기관 누리집의 하위 경로 파일(B2G)
/minwon/llms.txt 에 둔 파일입니다. 그 경로 아래 페이지만 다루고, 기관 전체 안내는 루트 파일에 맡깁니다.
| 줄 | 내용 |
|---|---|
| 1 | # 예시시청 민원 안내 |
| 2 | > 예시시청 누리집 민원 분야의 서식과 처리 기간을 안내합니다. |
| 3 | 이 파일은 /minwon/ 아래 페이지만 다룹니다. 기관 전체 안내는 루트의 /llms.txt 에 있습니다. |
| 4 | ## 민원 서식 |
| 5 | - [전입 신고](https://example.com/minwon/move-in.md): 필요 서류와 처리 기간 |
| 6 | - [여권 발급](https://example.com/minwon/passport.md): 신청 장소와 수수료 |
| 7 | ## 기관 정보 |
| 8 | - [담당 부서](https://example.com/minwon/departments.md): 민원 분야별 담당 부서 |
발견 03
링크는 각 페이지의 .md 판을 가리키게 하고, 파일은 경로마다 둘 수 있습니다
| 항목 | 제안 문서 원문 |
|---|---|
| 둘 자리 | The file can be placed at the site root, or at any path within it, covering the pages under that path.파일은 사이트 루트나 그 안의 어느 경로에든 둘 수 있으며, 그 경로 아래 페이지를 다룬다. |
| 여러 파일이 겹칠 때 | A file covers the URLs under its path, and where more than one file applies, agents should use the most specific one.파일은 자기 경로 아래 URL 을 다루고, 여러 파일이 해당하면 에이전트는 가장 구체적인 파일을 쓴다. |
| 링크가 가리킬 곳 | The links in an llms.txt file should therefore point to LLM-friendly content, such as the markdown versions of pages described above.그래서 llms.txt 의 링크는 앞에서 말한 페이지의 마크다운 판처럼 LLM 이 읽기 쉬운 콘텐츠를 가리켜야 한다. |
| 파일 크기 | The file itself stays small enough to fit in context.파일 자체는 맥락에 들어갈 만큼 작게 유지한다. |
| .md 판 URL | We furthermore propose that pages with information that agents might need provide a clean markdown version of those pages at the same URL as the original page, either with .md appended (page.html.md) or with the extension replaced by .md (page.md). (URLs without file names should append index.html.md or index.md instead.)에이전트가 필요로 할 정보가 있는 페이지는 같은 URL 에 .md 를 붙이거나(page.html.md) 확장자를 .md 로 바꾼(page.md) 마크다운 판을 둘 것을 제안한다. 파일 이름이 없는 URL 은 index.html.md 나 index.md 를 붙인다. |
| 찾게 하는 링크 관계 | To help clients find these files, we recommend using standard link relations: rel="alternate" type="text/markdown" points to the markdown version of a page, and rel="describedby" points to the llms.txt file that covers it.이 파일들을 찾기 쉽게 표준 링크 관계를 권한다. rel="alternate" type="text/markdown" 은 페이지의 마크다운 판을, rel="describedby" 는 그 페이지를 다루는 llms.txt 를 가리킨다. |
| HTTP 헤더로 알리기 | The header form also works for non-HTML resources, such as the markdown files themselves, and can be added in web server or CDN configuration without modifying any pages.HTTP 헤더 방식은 마크다운 파일처럼 HTML 이 아닌 자원에도 쓸 수 있고, 페이지를 고치지 않고 웹 서버나 CDN 설정에서 더할 수 있다. |
| 파일 | H1 | H2 묶음 | 목록 링크 | 구성 |
|---|---|---|---|---|
| /llms.txt | # OpenAI Developers | 4개 | 40개 | 첫 묶음이 제품별 하위 경로 llms.txt 로 안내 |
| /api/llms.txt | # OpenAI API | 2개 | 3개 | API 문서 묶음과 Optional 묶음 |
페이지가 많은 사이트는 루트 파일 하나에 다 담기보다 경로별 파일로 나눕니다. 위 OpenAI 사이트가 그 모양입니다.
.md 판이 없으면 HTML 페이지 URL 을 그대로 링크해도 형식에는 어긋나지 않습니다. 제안 문서는 .md 판을 권장으로 적었습니다.
발견 04
제안 문서는 작성 지침 4가지를 적었고, 마지막은 에이전트에게 직접 물어보는 시험입니다
| 지침 | 원문 |
|---|---|
| 짧고 분명한 말 | Use concise, clear language.짧고 분명한 말을 쓴다. |
| 링크마다 짧은 설명 | When linking to resources, include brief, informative descriptions.자료를 링크할 때는 짧고 정보가 담긴 설명을 붙인다. |
| 모호한 말·설명 없는 전문어 피하기 | Avoid ambiguous terms or unexplained jargon.모호한 말이나 설명 없는 전문어를 피한다. |
| llms.txt 만 주고 에이전트에게 물어보기 | Test your file by asking an agent questions about your content, giving it only your llms.txt as a starting point.llms.txt 만 출발점으로 준 에이전트에게 콘텐츠에 관해 물어 파일을 시험한다. |
그럼 llms.txt 는 어떤 순서로 쓰나요?
- 에이전트가 물어볼 만한 질문 몇 개를 먼저 적습니다(요금, 절차, 정책처럼).
- 질문마다 답이 있는 페이지 URL 을 고르고, 크롤러에 허용된 페이지인지 봅니다.
- # 사이트 이름과 > 한 줄 요약을 쓰고, 꼭 알아야 할 전제를 설명 문단에 적습니다.
- 링크를 ## 묶음으로 나누고, 줄마다 - [이름](URL): 설명 모양으로 씁니다. 덜 중요한 링크는 ## Optional 로 보냅니다.
- 가능하면 각 페이지의 .md 판을 만들고 링크를 그쪽으로 바꿉니다.
- 루트(/llms.txt)에 올린 뒤, 파일만 준 에이전트에게 처음 적은 질문을 물어 답이 나오는지 봅니다. 올린 파일 점검은 「llms.txt 생성기·검사기 결과, 올리기 전 점검 순서」 편에 있습니다.
조사 방법
- llmstxt.org (Jeremy Howard) 「The /llms.txt file, v2」 (문서 수정일 2026-08-10) · 최종 확인일 2026-10-25 · https://llmstxt.org/
- OpenAI 「llms.txt (OpenAI Developers)」 · 최종 확인일 2026-10-25 · https://developers.openai.com/llms.txt
- 줄 모양 6가지는 제안 문서 「Format」 절의 목록과 그 뒤 두 문장을 줄 단위로 나눈 것입니다. 나누는 방식은 편집 판단입니다.
- OpenAI 파일 두 개는 줄 맨 앞이 「## 」인 줄과 「- [」로 시작하는 목록 링크를 받은 본문에서 셌습니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어 그대로 옮겼고, 표의 한국어 칸은 원문의 요지입니다.