Vary: Accept 없는 Markdown 응답

짧은 답변

페이지가 원래 URL에서 Accept: text/markdown에 Markdown으로 응답하지만, 그 응답에 Vary: Accept 헤더가 없습니다. CDN이나 브라우저 캐시가 Markdown을 저장해 다음 방문자에게 보여 주거나, HTML을 저장해 두고 에이전트에 줄 수 있습니다.

agent.markdown_no_vary · 우선순위: P3

의미

페이지는 text/markdown을 요청받으면 같은 URL에서 Markdown을 반환하지만, 그 응답에 Vary: Accept 헤더가 없습니다. 그러면 CDN이나 브라우저 캐시가 방문자에게 Markdown을 보여 줄 수 있습니다.

AI 검색에서 중요한 이유

캐시는 저장한 응답을 URL로 구분합니다. Vary: Accept는 응답이 Accept 헤더에 따라 달라진다고 캐시에 알려 주므로, HTML과 Markdown이 따로 보관됩니다. 이 헤더가 없으면 먼저 캐시된 버전이 모두에게 제공됩니다.

이 문제는 캐시를 비운 뒤 첫 요청이 에이전트에서 왔을 때만 가끔 나타나므로, 브라우저로는 알아차리기 어렵습니다.

수정 방법

  1. Markdown 응답과 같은 URL의 HTML 응답 모두에 Vary: Accept를 추가합니다.
  2. 변환이 CDN이나 프레임워크 미들웨어에서 실행된다면 같은 곳에서 헤더를 설정합니다.
  3. 변경 후 해당 페이지의 캐시를 비웁니다.
  4. 페이지 리포트에서 "다시 점검"을 실행해 결과를 확인합니다.

예시

# both answers of the same URL
Content-Type: text/markdown; charset=utf-8
Vary: Accept

수정 확인 방법

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

내 페이지 점검 →

관련 가이드

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