워드프레스 목차 설정 가이드: LuckyWP·코어 블록·앵커 링크 비교
기존 LuckyWP 사이트의 안전한 유지·이전 기준과 신규 사이트의 목차 구현 방식을 현재 호환성, 링크 안정성, 접근성과 운영 비용 관점에서 비교합니다.
워드프레스 목차는 플러그인을 설치하면 끝나는 기능이 아닙니다. 목차가 읽기 흐름을 실제로 돕는지, 제목 계층이 올바른지, 앵커 링크가 안정적인지, 사용 중인 워드프레스와 테마에서 계속 유지되는지까지 확인해야 합니다.
특히 기존 사이트에서 LuckyWP Table of Contents를 사용하고 있다면 ‘지금 잘 보인다’와 ‘신규 사이트에도 그대로 추천할 수 있다’를 구분해야 합니다. 2026년 7월 27일 기준 WordPress.org 플러그인 목록에서 LuckyWP는 10만 개 이상의 활성 설치를 유지하지만 호환성 표시는 최신 워드프레스 계열보다 뒤처져 있습니다. 기존 설치는 스테이징에서 검증한 뒤 유지할 수 있지만, 신규 설치는 최근 업데이트와 현재 호환 범위를 함께 비교하는 편이 안전합니다.
먼저 결론: 상황별 권장 방식
| 상황 | 권장 방식 | 이유 |
|---|---|---|
| 글 수가 적고 구조를 직접 통제할 수 있음 | 코어 Heading 블록 + HTML 앵커 + List 블록 | 추가 플러그인 없이 가장 예측 가능함 |
| 긴 글을 자주 발행하고 자동 목차가 필요함 | 현재 유지보수되는 자동 목차 플러그인 | 새 소제목을 자동 반영하고 운영 시간을 줄임 |
| 기존 사이트가 LuckyWP에 강하게 의존함 | 즉시 교체보다 스테이징 검증 후 유지 또는 단계적 이전 | 기존 앵커와 CSS 변경으로 내부 링크가 깨질 수 있음 |
| 테마·템플릿 전체에서 일관된 목차가 필요함 | 커스텀 블록 또는 서버 측 생성 | 표시 규칙과 마크업을 코드로 통제할 수 있음 |
세 가지 구현 방식 비교
1. LuckyWP Table of Contents를 유지하는 방식
LuckyWP는 자동 삽입, 쇼트코드, 위젯과 블록 방식으로 목차를 생성할 수 있어 기존 사이트에서 널리 사용돼 왔습니다. 이미 수백 개 글에 적용되어 있고 현재 환경에서 정상 동작한다면 무작정 삭제할 이유는 없습니다.
다만 신규 설치 여부는 별도로 판단해야 합니다. WordPress.org의 플러그인 페이지에서 마지막 업데이트 시점, ‘Tested up to’ 버전, 최근 지원 게시판과 변경 이력을 확인하세요. 현재 워드프레스 버전보다 호환성 표기가 오래됐다면 운영 사이트에 바로 설치하지 말고 스테이징 복제본에서 편집기, 캐시, 페이지 빌더와 모바일 동작을 시험합니다.
2. 코어 블록과 HTML 앵커로 직접 만드는 방식
워드프레스 Heading 블록의 고급 설정에는 HTML Anchor 입력란이 있습니다. 각 H2·H3에 짧고 고유한 앵커를 지정한 뒤, 글 상단의 List 블록에서 #anchor-name 형식으로 연결하면 플러그인 없이 목차를 만들 수 있습니다.
- 장점: 마크업과 링크를 직접 통제하고 플러그인 의존성을 줄입니다.
- 단점: 소제목을 바꿀 때 목차 링크도 수동으로 수정해야 합니다.
- 적합: 핵심 랜딩 페이지, 문서 수가 적은 사이트, 장기 유지 문서
앵커는 한 글 안에서 중복되지 않아야 하며, 한글 문자열보다 짧은 영문·숫자·하이픈 조합이 이전과 디버깅에 편리합니다. 이미 외부나 내부에서 사용되는 앵커를 바꾸면 딥링크가 깨질 수 있으므로 변경 전 로그와 링크를 확인합니다.
3. 현재 유지보수되는 자동 목차 플러그인 또는 커스텀 블록
신규 사이트라면 WordPress.org의 ‘table of contents’ 분류에서 현재 버전 호환성, 활성 설치, 최근 변경 이력과 지원 상태를 비교합니다. 예를 들어 검토 시점에는 Easy Table of Contents 등 일부 대안이 최신 워드프레스 버전까지 호환성 정보를 갱신하고 있었습니다. 설치 수나 평점만 보지 말고 실제 사용 중인 테마·페이지 빌더·다국어 플러그인과의 충돌 사례를 함께 봅니다.
기업 문서나 대형 콘텐츠 사이트라면 커스텀 블록이나 서버 측 렌더링으로 제목을 수집하는 방식도 고려할 수 있습니다. 초기 개발 비용은 들지만 출력 HTML, 캐시, 접근성과 디자인 규칙을 한곳에서 관리할 수 있습니다.
목차가 SEO에 직접 점수를 주는 것은 아닙니다
목차 플러그인을 설치했다고 검색 순위가 자동으로 오르지는 않습니다. 목차의 가치는 긴 문서에서 사용자가 원하는 구간으로 이동하도록 돕고, 제목 구조와 앵커 링크를 명확하게 만드는 데 있습니다. 검색 결과에 점프 링크가 표시되는지와 형태는 검색엔진이 결정하며 보장할 수 없습니다.
상위노출을 위해 더 중요한 것은 검색 의도에 맞는 핵심 답, 논리적인 H2·H3 계층, 실제 경험과 검증 가능한 근거, 빠른 로딩, 모바일 가독성과 중복 없는 내용입니다. 목차는 이 구조를 보여 주는 탐색 장치이지 부족한 본문을 보완하는 순위 장치가 아닙니다.
상위노출을 고려한 제목 구조
- 페이지 제목은 글 전체 질문을 담당하고 본문에서 H1을 반복하지 않습니다.
- H2는 독자가 검색 후 실제로 묻는 큰 하위 질문을 담당합니다.
- H3는 H2의 절차, 조건이나 예외를 나눌 때만 사용합니다.
- 글자 크기를 바꾸려고 제목 수준을 건너뛰지 않습니다.
- 목차 항목만 보고도 글의 답변 흐름을 이해할 수 있게 작성합니다.
‘소개’, ‘추가 정보’, ‘마무리’처럼 검색 의도를 설명하지 못하는 소제목보다 ‘LuckyWP를 계속 써도 되는가’, ‘목차 링크가 작동하지 않을 때’, ‘플러그인 없이 만드는 법’처럼 독자의 질문을 직접 드러내는 소제목이 좋습니다.
LuckyWP 기존 사용자를 위한 이전 절차
- 전체 파일과 데이터베이스를 백업하고 복구 방법을 확인합니다.
- 스테이징 사이트를 만들어 현재 목차 HTML, CSS와 앵커 값을 기록합니다.
- 자동 삽입 위치, 포함할 제목 수준, 제외 규칙과 스크롤 오프셋을 문서화합니다.
- 후보 플러그인이나 수동 목차를 일부 글에서만 시험합니다.
- 기존 앵커 URL과 새 앵커 URL이 같은지 비교합니다.
- 모바일, 키보드 탐색, 캐시 적용 상태와 누적 레이아웃 이동을 확인합니다.
- 문제가 없을 때 작은 묶음부터 전환하고 검색·서버 로그의 404를 점검합니다.
플러그인을 먼저 삭제하면 쇼트코드가 본문에 노출되거나 자동 생성된 앵커가 사라질 수 있습니다. 새 방식의 출력을 확인하고 기존 링크 보존 계획을 세운 다음 비활성화하세요.
접근성과 사용성 점검
- 목차에 ‘이 페이지의 내용’처럼 이해 가능한 제목을 제공합니다.
- 링크 텍스트가 소제목을 정확히 설명하는지 확인합니다.
- 키보드만으로 모든 목차 링크에 접근할 수 있어야 합니다.
- 고정 헤더가 이동한 제목을 가리지 않도록 스크롤 오프셋을 검증합니다.
- 접기 기능은 JavaScript가 실패해도 핵심 링크를 잃지 않도록 구성합니다.
- H2와 H3의 들여쓰기를 색상만으로 구분하지 않습니다.
자주 발생하는 오류
목차가 표시되지 않습니다
포함할 최소 제목 수, H2·H3 선택, 게시물 유형, 자동 삽입 위치와 캐시를 확인합니다. 페이지 빌더 안의 동적 콘텐츠는 플러그인이 제목을 수집하는 시점에 존재하지 않을 수 있습니다.
클릭해도 제목 위치가 어긋납니다
고정 헤더 높이, 관리자 바, CSS의 scroll-margin-top 또는 플러그인 오프셋 설정을 확인합니다. 데스크톱과 모바일 헤더 높이가 다르면 각각 시험합니다.
같은 앵커가 여러 번 생성됩니다
동일한 소제목이 반복되거나 테마와 플러그인이 동시에 ID를 부여할 때 발생할 수 있습니다. 렌더링된 HTML에서 실제 id 중복을 확인하고 한쪽 생성 기능만 사용합니다.
선택 체크리스트
- 검토일 기준 현재 워드프레스 버전과 호환되는가
- 최근 업데이트와 지원 응답이 이어지고 있는가
- 기존 앵커와 딥링크를 보존할 수 있는가
- 페이지 빌더·캐시·다국어 환경에서 시험했는가
- 필요한 제목만 포함하고 계층을 올바르게 표현하는가
- 플러그인 비활성화 시 복구 경로가 있는가
공식 확인 경로
- WordPress.org: Heading 블록과 HTML Anchor 설정
- WordPress.org: Table of Contents 플러그인 비교 목록
- WordPress.org: LuckyWP Table of Contents 현재 정보
- WordPress.org: Easy Table of Contents 현재 정보
기존 LuckyWP 사이트는 검증 없이 서둘러 교체하지 말고, 신규 사이트는 현재 유지보수 상태를 확인한 뒤 선택하세요. 목차 방식보다 더 중요한 것은 제목 계층, 링크 안정성, 접근성과 실제 본문 품질입니다.