아래 순서로 확인하면 대부분의 렌더링 문제를 빨리 찾을 수 있다.

1. 구조 확인

  • 홈이 정상적으로 열리는가
  • 소개/블로그/카테고리/태그/연락처가 서로 연결되는가
  • 언어별 하위 경로가 유지되는가

2. 토큰 확인

  • 색상, 배경, 테두리, 그림자가 theme-vars를 읽는가
  • 폰트가 언어별로 바뀌는가
  • 버튼과 CTA의 톤이 일관적인가

3. 문법 확인

  • 헤딩, 표, 코드, 인용, 목록이 깨지지 않는가
  • collapse 내부에서 markdownify가 유지되는가
  • ltr/rtl 블록이 다른 요소를 밀어내지 않는가

4. 미디어 확인

  • figure 캡션이 길어도 화면이 무너지지 않는가
  • page bundle 리소스가 상대경로로 읽히는가
  • 인라인 이미지가 baseline을 깨지 않는가

5. 배포 전 승인 기준

기준 확인 결과
링크 실제 존재하는 경로만 연결
디자인 값은 중앙 토큰에서 관리
언어 ko 우선 검증 후 다른 언어도 같은 규칙
유지보수 다음 변경 때도 로그를 이어 쓸 수 있음

이 체크리스트는 기능 테스트가 아니라, “프런트엔드가 의도한 대로 읽히는가”를 보는 검증표다.