Markdown 제목 계층 검사기
브라우저 처리Markdown 제목이 H1 하나로 시작해 한 단계씩 내려가는지 검사합니다. H1→H3 건너뛰기, H1 여러 개, H2로 시작하는 문서를 줄 번호와 함께 알려 줍니다.
- 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
제목 단계가 H1 다음 바로 H3으로 건너뛰거나 H1이 여러 개인 문서는 화면에서는 멀쩡해 보여도 목차가 어긋나고, 화면 낭독기 사용자는 문서 구조를 잘못 이해하게 됩니다. 검색 엔진도 제목 구조로 내용을 파악합니다.
1행: 문서가 H2로 시작합니다 3행: H1 다음에 H4로 건너뛰었습니다 H1은 하나여야 하는데 2개입니다.
Markdown 제목 계층 검사기 사용 가이드
제목 단계가 H1 다음 바로 H3으로 건너뛰거나 H1이 여러 개인 문서는 화면에서는 멀쩡해 보여도 목차가 어긋나고, 화면 낭독기 사용자는 문서 구조를 잘못 이해하게 됩니다. 검색 엔진도 제목 구조로 내용을 파악합니다.
이 검사기는 세 가지를 봅니다. 첫 제목이 H1인지, 제목이 한 번에 두 단계 이상 깊어지지 않는지(H2→H4 같은 건너뛰기), H1이 정확히 하나인지입니다. 문제가 없으면 '통과: 제목 N개의 계층이 올바릅니다.'가 나옵니다.
H4에서 H2로 올라가는 것처럼 얕아지는 방향은 문제가 아니므로 경고하지 않습니다.
사용 방법
- '.md·.txt 파일'에서 검사할 문서를 고르거나 'Markdown 내용'에 제목 구조를 볼 문서를 붙여 넣습니다.
- '실행'을 누르면 '3행: H1 다음에 H4로 건너뛰었습니다'처럼 문제 줄과 내용이 나옵니다.
- 알려 준 줄의 # 개수를 고친 뒤 다시 실행해 '통과'가 나오는지 확인합니다.
예시: 세 가지 문제가 한꺼번에 있는 문서
## 소개 # 제목 #### 세부 # 또 다른 제목
1행: 문서가 H2로 시작합니다 3행: H1 다음에 H4로 건너뛰었습니다 H1은 하나여야 하는데 2개입니다.
첫 제목이 H2이고, 2행 H1 다음 3행에서 H4로 건너뛰었으며, H1이 두 개입니다.
이럴 때 쓰면 좋아요
- 블로그 원고를 올리기 전에 제목 구조를 검색 엔진 친화적으로 맞출 때
- 웹 접근성 점검에서 제목 단계 건너뛰기를 찾을 때
- 여러 문서를 합친 뒤 H1이 여러 개 남았는지 확인할 때
- 목차가 이상하게 들여써질 때 원인이 되는 제목을 찾을 때
문제가 생겼을 때
문서에 # 제목이 없다는 뜻입니다. 블로그나 문서 사이트가 글 제목을 H1으로 따로 붙이는 경우라면 이 경고는 무시해도 됩니다.
합친 문서마다 # 제목이 있었기 때문입니다. 대표 제목 하나만 #으로 두고 나머지 문서 제목은 ##로 한 단계씩 내리세요.
활용 팁
- 제목 단계를 한꺼번에 내려야 하면 편집기의 찾기·바꾸기로 줄 맨 앞 '## '를 '### '로 바꾸는 식으로 처리하면 빠릅니다.
- 검사를 통과한 뒤 Markdown 제목 구조 뷰어로 보면 들여쓰기가 계단처럼 고르게 나오는지 눈으로도 확인할 수 있습니다.
자주 묻는 질문
H1은 문서 전체의 제목이라 하나일 때 구조가 분명합니다. 여러 개면 목차와 검색 엔진이 무엇이 대표 제목인지 판단하기 어렵습니다.
아니요. ``` 또는 ~~~로 감싼 코드 블록 안의 줄은 제목으로 보지 않아 검사에서 빠집니다.
아니요. 얕은 단계로 돌아가는 것은 새 절이 시작된 것이라 정상입니다. 깊어질 때 한 단계씩만 내려가면 됩니다.