Markdown 목차 생성기

마크다운 문서 내에 포함된 소제목 헤더(#)들을 정밀 파싱하여, 페이지 스크롤 이동이 가능한 SEO 친화적인 목차(TOC) 계층형 리스트를 자동 생성해 줍니다.

언제 사용하나요?

기술 블로그 포스팅, 개발 프로젝트 README.md 파일, 기획서 등을 마크다운 서식으로 작성할 때, 독자의 가독성을 돕기 위해 문서 맨 처음에 각 단락으로 점프할 수 있는 편리한 이동 링크 목차 목록을 일일이 수동 연결하는 번거로움 없이 1초 만에 자동 완성하고 싶을 때 유용합니다.

사용 방법

제목 헤더(#)가 들어있는 마크다운 문서 내용을 복사하여 왼쪽 에디터에 붙여넣습니다.
목차 추출 단계 제한(예: H1~H3 설정) 및 들여쓰기 탭 깊이 기준을 적용합니다.
생성된 계층형 리스트 마크다운 코드를 복사하여 문서 최상단 영역에 안치합니다.

입력값 안내

#, ##, ### 등 마크다운의 표준 6단계 제목 머리글 서식이 포함된 아티클 텍스트를 입력받습니다.

계산·변환 기준

정규표현식 매칭 방식을 따릅니다. 각 행의 선두 패턴 `^(#{1,6})\s+(.+)`을 식별하여 샵의 개수로 위계 레벨을 판정하고, 제목 자구에 깃허브(GitHub) 스타일의 URI 앵커 인코딩 룰(소문자화, 특수기호 탈락, 공백 하이픈 치환)을 개별 부여하여 `- [제목](#앵커ID)` 폼의 들여쓰기 중첩 마크다운 목록을 조립합니다.

사용 예시

GitHub README 및 Wiki 목차 구성 - 오픈소스 프로젝트 설명 문서의 장황한 내용을 한 화면에 정리하는 상단 인덱스를 깔끔히 식립합니다.
티스토리/벨로그 블로그 가독성 증대 - 긴 지식 아티클 서론에 페이지 스크롤 앵커 목차를 달아 검색엔진 노출 지수(SEO) 및 이용자 편의를 높입니다.
회사 개발 업무 가이드 정돈 - 사내 Notion이나 Wiki에 탑재할 매뉴얼 문서의 요약 조항 인덱스를 신속하게 가공 빌드합니다.

예시

# 1. 소개\n## 1.1 개요 입력 → \n- [1. 소개](#1-소개)\n - [1.1 개요](#11-개요) 형태로 위계 변환

주의사항

제목에 특수 부호나 하이퍼링크가 중첩 탑재되어 있거나, 한글/영문 혼합 구성인 경우 파싱하는 플랫폼(GitLab, Notion, Jekyll 등)의 내부 파서 파라미터 규격에 따라 앵커 해시 이동이 간혹 다르게 매칭될 수 있으니 최종 동선 체크를 권장합니다.

계산·사용 가이드

검색엔진 최적화(SEO) 관점에서 마크다운 목차의 영향력

구글이나 네이버 검색엔진은 페이지 내부에서 해시(#) 링크로 구획이 정돈된 페이지 구성도를 선호합니다. 소제목 헤더들과 논리적으로 연동된 계층 구조 목차를 문서 상단에 두면, 로봇이 본문의 가치를 높이 사 검색 상위 노출에 긍정적인 가점을 매깁니다.

깃허브(GitHub) 리드미 문서 앵커 이동 깨짐 해결법

깃허브 마크다운 렌더러는 소제목 속의 특수기호나 대소문자를 소문자 대시 형태로 변환해 해시 아이디를 부여합니다. 목차 내 링크를 손으로 기재할 때 발생하는 오타 누수를 막기 위해, 본 변환기가 GitHub 표준 앵커 룰에 맞춘 링크셋을 안전하게 제공합니다.

자주 묻는 질문

특정 하위 헤더들(H4 이하)은 목차에서 빼고 싶어요.

예. 필터 상세 설정에서 추출 대상 헤더 깊이를 조절(예: 최대 H3까지만 추출)하시면, 지나치게 세세한 소단락들은 목차 후보에서 무시되고 메인 줄기 헤더만 가독성 좋게 추출됩니다.

목차 링크를 누르면 하단 소제목으로 진짜 화면이 이동하나요?

예. 대부분의 표준 마크다운 렌더러는 헤더 텍스트를 파싱할 때 제목 값을 고유 ID 앵커로 자동 변환하여 내부 앵커 타깃으로 지정하므로, 본 도구가 뽑아낸 하이퍼링크 해시(#)와 정상적으로 자동 연동됩니다.