fix(blog): 본문 H1 중복 제거 (#98)#112
Merged
Merged
Conversation
ArticleHeader가 metadata.title을 페이지 H1로 렌더하므로, 본문 MDX의 마크다운 H1(# )은 문서당 H1이 중복되어 SEO/헤딩 위계를 깨뜨린다. 대상 11개 포스트의 본문 H1을 H2(## )로 강등했다. - frontend/monorepo: 3개 강등 (코드블록 내 sh 주석 1개는 보존) - frontend/execution-context: 3개 강등 - frontend/ts-why-use-typescript: 2개 강등 - frontend/ts-type-compatibility: 6개 강등 - frontend/ts-object-type-advanced: 3개 강등 - frontend/ts-type-vs-interface: 3개 강등 - ai/ai-tool: 2개 강등 - ai/git-worktree, ai/sse-exam, ai/antigravity, fullstack/nextjs-grid-app-1: 본문 H1 없음(코드블록 내 주석만 존재)으로 변경 없음 코드펜스 상태를 추적해 코드블록 내부 # 주석은 변경하지 않았다. ToC는 h2/h3를 수집하므로 강등된 섹션이 새로 노출된다(의도된 개선). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
요약
ArticleHeader가metadata.title을 페이지의<h1>로 렌더하기 때문에, 본문 MDX에서 마크다운 H1(#)을 사용하면 문서당 H1이 2개 이상이 되어 SEO/헤딩 위계가 깨집니다. 이 PR은 대상 11개 포스트의 본문 H1을 H2(##)로 강등하여 문서당 H1 1개 원칙을 복원합니다.# 헤딩→##로 강등. 기존 H2/H3는 그대로 둡니다(최소 변경).#줄(셸/주석)은 마크다운 헤딩이 아니므로 변경하지 않았습니다. 각 파일의 코드펜스 상태를 추적해 헤딩과 코드블록 주석을 구분했고, 검증 스크립트로 코드블록 밖 H1이 0개임을 확인했습니다.변경한 파일과 강등 내역
frontend/monorepo/page.mdxpnpm workspace로 monorepo를 구성하는 방법,Turborepo,마치며frontend/execution-context/page.mdxVariableEnvironment와 LexicalEnvironment,LexicalEnvironment,스코프 체인frontend/ts-why-use-typescript/page.mdx타입스크립트의 타입 시스템,정리frontend/ts-type-compatibility/page.mdx타입 호환성을 결정하는 규칙,함수에 대한 타입 호환성,Enum의 타입 호환성,클래스의 타입 호환성,제네릭의 타입 호환성,정리frontend/ts-object-type-advanced/page.mdx인덱스 시그니쳐(Index Signature),초과 속성 검사(Excess Property Checks),정리frontend/ts-type-vs-interface/page.mdxInterfaces vs Intersections(Type),Mapped Type,정리ai/ai-tool/page.mdx들어가며,Tool Calling 실습, Next.js에서 Tool Calling을 구현하여 채팅메시지로 차트 생성 및 수정하기ai/git-worktree/page.mdxai/sse-exam/page.mdxai/antigravity/page.mdxfullstack/nextjs-grid-app-1/page.mdx합계: 7개 파일에서 H1 22개를 H2로 강등, 삭제한 헤딩 0개, 변경 없는 파일 4개.
ToC에 미치는 영향
post-detail.tsx의 ToC는article.querySelectorAll('h2, h3')로 헤딩을 수집합니다. 따라서 H1에서 H2로 강등된 섹션은 이제 ToC에 새로 노출됩니다. 이는 의도된 개선입니다(기존에는 H1이라 ToC에서 누락됐던 최상위 섹션이 목차에 정상적으로 포함됨).검증 결과
pnpm run build성공 — MDX 컴파일 오류 없음, 모든 대상 포스트 정적 생성 확인 (✓ Compiled successfully)pnpm run lint통과 (exit 0,--max-warnings 0)pnpm run test통과 — 17개 스위트 / 63개 테스트 전부 성공Closes #98
🤖 Generated with Claude Code