AI 에이전트용 Markdown 버전이 없습니다

짧은 답변

Accept: text/markdown으로 페이지를 요청했지만 서버는 HTML을 보냈고, 페이지에 Markdown 사본 링크도 없습니다. 그러면 AI 에이전트는 메뉴, 푸터, 스크립트까지 포함된 HTML 전체를 읽습니다. Markdown 버전 제공은 선택 사항입니다. 아직 새로운 관행이므로 P3입니다.

agent.no_markdown · 우선순위: P3

의미

Accept: text/markdown으로 요청했지만 페이지는 HTML로 응답했고, Markdown 사본 링크(<link rel="alternate" type="text/markdown">)도 없습니다. 그러면 에이전트는 메뉴와 스크립트까지 포함된 HTML 전체를 읽어야 합니다. 선택 사항: 에이전트용 Markdown은 아직 새로운 관행이며 표준이 아닙니다.

AI 검색에서 중요한 이유

사용자를 대신해 웹을 탐색하는 에이전트(그리고 페이지를 모델의 컨텍스트에 불러오는 도구)는 레이아웃이 아니라 텍스트를 다룹니다. 깔끔한 Markdown 버전은 HTML보다 몇 배 작으면서도 중요한 제목, 목록, 링크는 그대로 유지합니다. 일부 CDN과 프레임워크는 이미 Accept: text/markdown에 이런 버전으로 응답하며, llmstxt.org는 각 페이지 옆에 .md 사본을 두라고 제안합니다.

없어도 망가지는 것은 없습니다. 크롤러는 여전히 HTML을 읽습니다. 접근, robots.txt, 콘텐츠 발견 항목을 고친 뒤라면 적은 노력으로 할 수 있는 개선입니다.

수정 방법

  1. Markdown을 제공할 방법을 하나 고릅니다. 페이지의 원래 URL에서 Accept: text/markdown에 응답하거나, /guide/index.md 같은 사본을 게시합니다.
  2. CDN을 쓴다면 에이전트용 Markdown 변환 기능이 있는지 확인하고 켭니다. 프레임워크에서는 Accept 헤더가 text/markdown을 요청할 때 Markdown 버전을 반환하는 미들웨어를 추가합니다.
  3. Content-Type: text/markdown; charset=utf-8을 보내고, URL이 HTML 페이지와 같다면 Vary: Accept도 보냅니다.
  4. HTML head에서 <link rel="alternate" type="text/markdown">으로 사본을 연결해, 콘텐츠 협상을 하지 않는 에이전트도 찾을 수 있게 합니다.
  5. 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.

예시

<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">

# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept

수정 확인 방법

변경한 뒤 리포트에서 "다시 점검"을 누르세요. 무엇이 수정되었고 점수가 어떻게 바뀌었는지 보여 줍니다.

내 페이지 점검 →

관련 가이드

모든 발견 사항과 점수 산정 방식