마크다운 TOC
마크다운 헤딩(#)을 읽어 목차(TOC) 링크 목록을 만듭니다.
마크다운 TOC 생성
값을 입력한 뒤 계산하기를 눌러주세요.
사용 방법
- 마크다운란에 본문을 붙여 넣습니다. ATX 헤딩(# 제목)이 있는 문서여야 합니다.
- 최소 레벨·최대 레벨을 고릅니다. 기본은 H2부터 H4까지입니다.
- TOC 생성을 누르면 들여쓰기 목록과 앵커 링크가 만들어집니다.
- 복사해 README나 위키 상단에 붙입니다. 초기화로 입력을 비울 수 있습니다.
- 코드 블록 안의 #은 구분하지 않으니, 주석처럼 보이는 헤딩이 TOC에 섞이면 본문을 손보세요.
핵심 개념
마크다운 TOC는 GitHub README, 기술 블로그, 문서 사이트에서 목차 링크를 빠르게 만들 때 씁니다. 줄 단위로 #~######를 찾고, 선택한 레벨만 – [제목](#슬러그) 형태로 출력합니다. 슬러그는 소문자화 후 공백을 하이픈으로 바꾸며 한글은 유지합니다. 같은 제목이 반복되면 -2, -3을 붙입니다. GitHub README 목차, 위키 사이드바, 기술 문서 점프 링크를 ATX 헤딩만으로 만드는 마크다운 TOC 생성기입니다.
밑줄 Setext 헤딩(===, —)은 인식하지 않습니다. GitHub·일부 정적 사이트 생성기의 앵커 규칙과 100% 같지 않을 수 있어, 미리보기에서 클릭이 안 되면 렌더러 규칙을 확인하세요. 변환은 브라우저에서만 이뤄집니다. 최소·최대 레벨로 H1 제목을 빼고 H2–H4만 넣을 수 있습니다. 코드 펜스 안의 #은 헤딩으로 오인될 수 있습니다.
예시
본문에 ## 설치, ### 요구 사항, ## 사용법을 넣고 최소 H2·최대 H4로 생성하면 설치와 사용법이 같은 들여쓰기, 요구 사항은 한 단계 들어간 목록이 됩니다. 링크는 #설치, #요구-사항처럼 한글 제목을 유지한 슬러그입니다. H1만 있고 최소가 H2면 목차가 비어 있을 수 있습니다.## 시작하기와 ### 설치를 넣으면 시작하기 아래 설치가 한 단 들어가고 링크는 #시작하기, #설치가 됩니다.
자주 묻는 질문
Setext 헤딩(===)도 마크다운 TOC에 들어가나요?
아니요. # 스타일(ATX)만 지원합니다. Setext 밑줄 제목은 목차에 안 들어가니 #을 붙이세요.
한글 제목 앵커 슬러그는 어떻게 되나요?
한글을 유지한 채 공백을 하이픈으로 바꿉니다. 렌더러마다 다를 수 있습니다. 한글 앵커가 깨지는 정적 사이트는 슬러그 플러그인 규칙을 확인하세요.
코드 블록 안의 # 주석도 TOC에 잡히나요?
단순 줄 단위 파싱이라 코드 블록은 구분하지 않습니다. 주석용 # TODO가 TOC에 섞이면 본문에서 빼 주세요.
GitHub README 목차와 동일한가요?
유사하지만 특수문자 제거·중복 규칙이 완벽히 같지 않을 수 있습니다. GitHub과 특수문자 제거 규칙이 다를 수 있어 미리보기에서 클릭 테스트를 하세요.
최소·최대 헤딩 레벨은 언제 쓰나요?
문서 제목(H1)을 빼고 H2–H4만 목차에 넣을 때 기본값처럼 사용합니다. H1부터 넣으려면 최소 레벨을 H1로 바꾸면 됩니다.
같은 제목이 두 번이면 앵커가 겹치나요?
두 번째부터 슬러그 뒤에 -2처럼 번호를 붙여 구분합니다. 제목이 같으면 두 번째 링크에 -2가 붙어 충돌을 피합니다. 관련: 마크다운 미리보기 · 마크다운 → HTML
최종 검토일: 2026년 9월 4일