에이전트용 마크다운 응답 지원
브라우저용 HTML 대신 에이전트가 읽기 쉬운 마크다운을 같은 URL에서 제공하도록 했습니다.
교안에 영향
예전에는 브라우저용 HTML만 전제로 안내한 글이 있다면, 이제 Accept: text/markdown 요청과 markdown sitemap 안내가 추가되어 그 설명이 맞지 않을 수 있습니다.
요약
- 블로그와 changelog 페이지가 content negotiation을 지원하도록 업데이트됐습니다. - Accept 헤더에 따라 HTML 대신 text/markdown 응답을 반환하도록 Next.js 구현 방식을 소개합니다. - markdown sitemaps를 추가해 에이전트가 콘텐츠를 더 쉽게 발견하고 탐색할 수 있게 했습니다. - HTML의 link rel="alternate" 태그로 Accept 헤더를 보내지 않는 에이전트도 대체 경로를 찾을 수 있습니다.
바뀐 것
새 기능
- 블로그와 changelog 페이지에 content negotiation을 지원하도록 했습니다.
- Accept: text/markdown 요청을 받으면 같은 URL에서 마크다운을 반환하도록 했습니다.
- Next.js에서 Accept 헤더를 감지하는 rewrite rule과 markdown을 반환하는 route handler 구현 방식을 설명했습니다.
- CMS의 rich text를 마크다운으로 변환해 제공하는 방식을 사용했습니다.
- 블로그와 documentation에 markdown sitemaps를 제공해 콘텐츠 탐색을 돕습니다.
- documentation처럼 중첩된 콘텐츠는 recursive renderer로 계층을 보존해 마크다운 sitemap을 생성합니다.
- Accept 헤더를 보내지 않는 에이전트를 위해 HTML의 link rel="alternate" 태그를 대체 발견 경로로 제공했습니다.
개선
- 마크다운 응답은 코드 블록, 제목 계층, 링크 구조를 유지하도록 했습니다.
- HTML 버전과 마크다운 버전을 Next.js 16 remote cache와 shared slugs로 함께 동기화했습니다.