마크다운 목차 생성기
Markdown 제목에서 링크가 포함된 목차를 자동으로 생성 — README, 문서, 긴 위키 페이지에 최적입니다.
마크다운 입력
생성된 목차
마크다운 목차 예시
제목에서 앵커 링크를 생성합니다. 예시:
프로젝트 핸드북 제목
마크다운 입력:
생성된 목차:
위의 샘플을 사용하여 더 많은 제목을 불러오세요.
마크다운 목차 생성기란?
목차(TOC)는 독자가 긴 문서를 탐색하는 데 도움을 줍니다. 마크다운에서 제목은 #부터 ######을 사용합니다. TOC 생성기는 제목을 스캔하여 각 섹션으로 이동하는 링크 목록을 생성합니다. GitHub Flavored Markdown과 많은 정적 사이트 생성기는 제목 텍스트에서 생성된 앵커 링크를 지원합니다.
이 도구는 브라우저에서 실행됩니다. 마크다운을 붙여넣거나 파일을 업로드하면 편집하는 동안 TOC가 업데이트됩니다. 최소 및 최대 제목 수준을 설정할 수 있습니다(예: H2–H4만). 앵커 슬러그는 제목 텍스트에서 생성되고 제목이 반복되면 중복 제거됩니다. 마크다운 형식 지정에는 마크다운 포매터를 사용하세요. HTML로 변환하려면 마크다운 HTML 변환을 사용하세요.
이 도구 사용 방법
마크다운 붙여넣기 또는 업로드
마크다운을 왼쪽 편집기에 붙여넣거나 업로드를 클릭하여 .md, .markdown 또는 .txt 파일을 불러오세요. 샘플을 사용하여 예시 제목을 불러오세요. TOC는 자동으로 업데이트됩니다.
제목 수준 범위 설정
최소 H1–H4와 최대 H3–H6를 사용하여 특정 제목 수준만 포함하세요. 예를 들어, 최소 H2와 최대 H4는 H1과 H5–H6를 건너뜁니다. 이렇게 하면 긴 문서에 집중할 수 있습니다.
TOC 복사 또는 다운로드
생성된 TOC를 클립보드에 복사하거나 다운로드하세요. README 또는 문서 상단에 붙여넣으세요. 마크다운 린팅에는 마크다운 린터를 사용하세요. 문법 도움말에는 마크다운 치트 시트를 사용하세요.
TOC 생성이 도움이 되는 경우
GitHub의 README 파일, 문서 사이트, 위키는 TOC의 혜택을 받습니다. 독자가 스크롤 없이 섹션으로 이동할 수 있습니다. CommonMark 명세는 제목 구문을 정의합니다. GFM과 대부분의 렌더러는 #anchor-slug 링크를 지원합니다. Eleventy와 VitePress 같은 정적 생성기는 종종 앵커를 자동으로 생성합니다.
CSV 또는 구분된 데이터에서 표를 만들려면 마크다운 표 생성기를 사용하세요. 빠른 문법 참조에는 마크다운 치트 시트를 사용하세요. 마크다운을 HTML로 변환하려면 마크다운 HTML 변환을 사용하세요.
자주 묻는 질문
앵커 링크는 어떻게 생성되나요?
앵커 링크는 제목 텍스트를 소문자로 변환하고, 공백을 하이픈으로 바꾸고, 특수 문자를 제거하여 생성됩니다 — GitHub Flavored Markdown 앵커 형식을 따릅니다. 예를 들어, "시작하기"는 #시작하기가 됩니다.
TOC 링크가 GitHub에서 작동하나요?
예 — 앵커 형식이 GitHub Flavored Markdown 규칙과 일치하므로 TOC 링크는 GitHub README 파일, 위키, 풀 리퀘스트 설명에서 올바르게 작동합니다.
어떤 제목 레벨을 포함할지 선택할 수 있나요?
예 — TOC에 포함할 최소 및 최대 제목 깊이를 구성할 수 있습니다. 예를 들어, 최상위 H1 제목을 건너뛰고 H2와 H3만 포함할 수 있습니다.
제목에 특수 문자가 있으면 어떻게 되나요?
#, *, ?와 같은 특수 문자와 구두점은 앵커 링크에서 제거됩니다. 이모지도 보통 제거됩니다. 이 도구가 자동으로 처리하므로 TOC 링크가 유효한 상태로 유지됩니다.
관련 도구
자세히 알아보기: CommonMark, CommonMark 명세, GitHub Flavored Markdown, Markdown Guide, GitHub, W3C HTML, Eleventy, VitePress.