Input Markdown

Generated TOC

Markdown TOC 생성기란?

탐색하기 어려워진 문서나 긴 README를 작성하고 있나요? 목차(TOC)가 있으면 독자가 원하는 섹션으로 쉽게 이동할 수 있습니다. 이 도구는 Markdown 파일을 스캔하여 모든 헤딩(H1~H6)을 찾고, 적절한 앵커 링크를 생성하며, 문서 상단에 바로 붙여넣을 수 있는 구조화된 TOC를 만듭니다.

생성기는 GitHub 호환 앵커 형식을 사용하므로 TOC가 GitHub, GitLab, 기타 Markdown을 렌더링하는 플랫폼에서 완벽하게 작동합니다. 헤딩 레벨을 지능적으로 처리하여 TOC 깊이를 제어(H2~H3만 표시하거나 H6까지 모든 레벨 포함)할 수 있고, 구조가 명확하도록 적절한 들여쓰기와 중첩을 자동으로 생성합니다.

TOC는 항상 헤딩과 동기화되어 있어 깨진 앵커 링크나 오래된 섹션 참조 문제가 발생하지 않습니다. 헤딩의 특수 문자도 올바르게 처리되며, 출력은 즉시 붙여넣을 수 있는 상태입니다. 모든 처리가 브라우저에서 즉시 이루어지며, 서버 업로드는 전혀 없습니다.

Markdown TOC 생성기 사용 방법

Markdown 헤딩에서 목차를 생성하는 단계별 안내입니다. 이 페이지의 실제 컨트롤을 사용합니다.

붙여넣기, 업로드 또는 샘플 불러오기

왼쪽 Markdown 입력 패널에 Markdown을 붙여넣거나, 업로드를 클릭해 .md 파일을 불러옵니다. 샘플을 클릭하면 예제 API 문서가 표시됩니다. 도구가 헤딩(# ~ ######)을 스캔합니다.

최소/최대 레벨 설정

최소 H와 최대 H 드롭다운으로 TOC에 표시할 헤딩 레벨을 제어합니다. 출력이 즉시 업데이트됩니다. GitHub 호환 앵커 링크가 생성됩니다.

복사 또는 다운로드

복사 또는 다운로드를 클릭하여 출력을 사용합니다. 문서 상단에 붙여넣으세요. 초기화로 처음부터 다시 시작할 수 있습니다. 모든 처리는 브라우저에서 실행됩니다.

실제 활용 사례

GitHub README 파일

프로젝트를 위한 포괄적인 README를 작성하고 있나요? TOC가 있으면 사용자가 설치, 구성, API 문서, 기여 섹션을 빠르게 찾을 수 있습니다. GitHub는 동작하는 앵커 링크가 포함된 TOC를 자동으로 렌더링하여 완벽한 탐색 환경을 제공합니다.

문서 사이트

20페이지 이상의 대규모 문서 프로젝트에는 구조가 필요합니다. 각 페이지의 TOC를 생성하고 전체 사이트의 마스터 TOC를 만드세요. 명확한 구조로 독자가 문서를 자신 있게 탐색할 수 있습니다.

Wiki 페이지

긴 아티클이 있는 회사 Wiki나 지식 베이스를 만들고 있나요? 각 페이지 상단의 TOC가 사용성을 향상시킵니다. GitHub Wiki, GitLab Wiki, 기타 Markdown 기반 Wiki에서 작동합니다.

장문 콘텐츠

블로그 포스트, 튜토리얼, 가이드, 기타 긴 Markdown 문서는 TOC가 있으면 유용합니다. 빠르게 스캔하는 독자가 관련 섹션으로 바로 이동할 수 있습니다. 여러 단계와 섹션이 있는 기술 튜토리얼에 특히 도움이 됩니다.

자주 묻는 질문

앵커 링크를 수동으로 만들어야 하나요?

아니요. 도구가 자동으로 생성합니다. GitHub, GitLab, 대부분의 CommonMark 호환 플랫폼은 헤딩에서 앵커를 자동 생성하므로, 생성된 TOC 링크는 추가 작업 없이 즉시 작동합니다.

앵커 형식이 모든 플랫폼에서 작동하나요?

생성기는 가장 널리 지원되는 GitHub 호환 앵커 형식을 사용합니다. GitHub, GitLab, 대부분의 다른 Markdown 플랫폼이 이 형식을 네이티브로 지원합니다. 특정 앵커 동작은 해당 플랫폼의 문서를 확인하세요.

헤딩의 특수 문자는 어떻게 처리되나요?

생성기가 특수 문자를 자동으로 앵커 안전 형식으로 변환합니다. 공백은 하이픈으로, 대문자는 소문자로 변환되고, 특수 구두점은 변환되거나 제거됩니다. 생성된 앵커는 항상 유효하고 올바르게 작동합니다.

TOC 깊이를 조정할 수 있나요?

물론입니다. "최소 H" 드롭다운은 최소 헤딩 레벨(H1, H2 등)을, "최대 H"는 최대를 제어합니다. H2~H3만 원하면 최소를 H2, 최대를 H3으로 설정하세요. 완전한 TOC가 필요하면 H1~H6의 모든 레벨을 포함하세요.

헤딩에 숫자나 기호가 포함되어 있으면 어떻게 되나요?

올바르게 처리됩니다. "1단계: 시작하기"와 같은 헤딩은 #1단계-시작하기와 같은 앵커로 변환됩니다. 특수 문자는 표준 Markdown 앵커 규칙에 따라 처리되므로 링크는 항상 작동합니다.

Markdown 콘텐츠가 저장되나요?

아니요. 모든 TOC 생성은 브라우저에서 JavaScript를 사용해 이루어집니다. 여러분의 Markdown은 컴퓨터 밖으로 나가지 않으며 데이터를 저장하거나 분석하지 않습니다. 완전한 프라이버시와 보안을 보장합니다.

Markdown TOC Generator