개발
마크다운 목차 생성기
마크다운 문서에서 헤딩을 추출해 자동으로 목차를 만듭니다. GitHub 스타일 anchor·한글 슬러그·레벨 범위·본문 자동 삽입을 지원합니다.
출력 모드
포함 레벨 (H2 ~ H4)
~
번호 매기기
들여쓰기
마크다운 입력
목차 출력
헤딩 0개
사용 방법
- 왼쪽 입력창에 마크다운 본문을 붙여넣습니다.
- 포함 레벨로 H1~H6 범위를 정하고, 문서 제목으로 쓰는 첫 H1을 빼려면 첫 H1 제외를 켭니다.
- 번호 매기기로 불릿 형식 또는 1.1.1 데시멀 번호를, 들여쓰기 단위(2칸/4칸)를 선택합니다.
- 출력 모드를 고릅니다 — TOC만 받을지, 본문에 자동 삽입할지.
- 본문 삽입 모드에서 기존에
<!-- TOC -->마커가 있으면 그 사이가 교체됩니다 — 다시 실행해도 안전합니다. - 오른쪽 결과를 복사해 README·블로그 글에 붙여넣습니다.
마크다운 목차 생성기 자세히 알아보기
마크다운 목차 생성기는 README 파일이나 긴 블로그 글의 헤딩을 자동으로 모아 목차(TOC)를 만들어 주는 도구입니다. GitHub README, 정적 사이트 생성기(Jekyll·Hugo·Docusaurus), 옵시디언·노션 같은 노트 앱 모두 동일한 anchor 규칙을 따르므로 한 번 만든 목차는 여러 환경에서 재사용할 수 있습니다. 본문에 헤딩을 추가하거나 수정해도 다시 실행하면 마커 사이가 교체되어 항상 최신 상태로 유지됩니다. 본 도구는 GitHub 스타일 슬러그 규칙을 따릅니다 — 소문자 변환, 공백을 하이픈으로, 한글 음절은 그대로 보존, 그 외 특수문자는 제거합니다. 같은 제목이 여러 번 등장하면 자동으로 `-1`, `-2` 접미사가 붙습니다. 코드 펜스(\`\`\` ~ \`\`\`) 안의 `#` 주석은 헤딩으로 인식하지 않으므로 코드 예제가 많은 README에서도 안전합니다.
이럴 때 사용하세요
- •GitHub README에 "목차" 섹션을 추가해 긴 문서를 빠르게 탐색하기
- •긴 블로그 글에 자동 목차를 넣어 SEO·체류시간 개선 (네이버·티스토리)
- •기술 문서·튜토리얼에 1.1.1 형식의 번호 목차를 넣어 인쇄용 출력 준비
- •옵시디언·노션 노트의 헤딩 구조를 한 번에 파악해 글 구조 다듬기
- •정적 사이트(Jekyll·Hugo·Docusaurus)에 자동 사이드바 목차 데이터 만들기
마크다운 목차 생성기 자주 묻는 질문
anchor 링크 규칙이 GitHub과 동일한가요?
네. GitHub README가 사용하는 슬러그 규칙(소문자·공백→하이픈·한글 보존·특수문자 제거)을 그대로 따릅니다. 동일 제목 충돌 시 -1, -2 접미사를 붙이는 방식도 같습니다. GitLab·Bitbucket·Hugo·Jekyll(kramdown) 등 대부분의 마크다운 처리기도 같은 규칙을 사용하므로 한 번 만든 anchor는 여러 환경에서 그대로 작동합니다.
코드블록 안의 # 주석도 헤딩으로 잡히나요?
아니요. ``` 또는 ~~~ 펜스로 감싸인 코드 블록 안의 # 으로 시작하는 줄은 헤딩으로 인식하지 않습니다. 4-space 들여쓰기 코드도 헤딩 패턴(줄 시작이 #)에 매칭되지 않아 안전합니다. README의 bash·yaml·python 코드 예제가 많아도 정확히 본문 헤딩만 추출합니다.
본문에 자동 삽입할 때 매번 새 목차가 추가되나요?
아니요. <!-- TOC --> 와 <!-- /TOC --> 마커가 본문에 있으면 그 사이만 새 목차로 교체됩니다. 마커가 없으면 첫 H1 직후(없으면 첫 헤딩 직전)에 한 번만 삽입됩니다. 그래서 글을 수정한 뒤 다시 실행해도 목차가 중복되지 않으며, 최신 헤딩 구조로 안전하게 갱신됩니다.
첫 H1을 자동으로 제외하는 이유는?
블로그 플랫폼이나 정적 사이트 생성기 대부분이 글의 첫 H1을 "문서 제목"으로 따로 다루기 때문에, 목차에 다시 포함하면 중복으로 보입니다. 기본값으로 첫 H1 제외를 켜 두었으며, README처럼 헤딩 구조가 완전히 본문 안에 있는 경우에는 토글을 꺼서 H1부터 포함할 수 있습니다.
목차 길이는 얼마나 되어야 좋을까요?
독자가 목차로 점프해 본문을 탐색하려면 보통 5~15개 항목이 적당합니다. 그보다 적으면 목차의 가치가 낮고, 30개를 넘으면 오히려 가독성이 떨어집니다. 포함 레벨을 H2~H3으로 좁히면 큰 섹션만 보여줄 수 있고, H4까지 늘리면 세부 항목까지 잡힙니다 — 글 길이에 맞춰 조정해 주세요.