마크다운 목차 생성기

마크다운으로 작성된 문서의 목차(TOC)를 자동으로 생성하는 무료 도구입니다. GitHub README 또는 블로그 등 플랫폼에 기술 문서를 작성할 때 수동으로 목차를 만드는 수고를 덜어줍니다.

제목 레벨(h1-h6)의 추출 범위와 기호 목록(-) 또는 번호 목록(1.)과 같은 출력 형식을 세밀하게 사용자 정의할 수 있습니다.

모든 처리는 브라우저 내에서 완료되므로 입력한 텍스트 데이터가 외부 서버로 전송되지 않습니다. 정보 유출 걱정 없이 기밀 문서나 개인 메모에 안전하게 사용할 수 있습니다.

마크다운 (Markdown)

텍스트 서식을 지정하기 위한 경량 마크업 언어입니다. 기호를 사용하여 제목, 목록, 링크 등을 쉽게 표현하며 프로그래머들 사이에서 특히 널리 사용됩니다.

TOC (목차)

긴 문서의 시작 부분에 배치되어 독자가 원하는 섹션에 빠르게 액세스할 수 있도록 하여 가독성을 향상시킵니다.

제목 레벨

HTML의 h1에서 h6 태그에 해당하는 문서의 계층 구조를 나타내는 지표입니다. 마크다운에서는 "#"의 수로 레벨을 표현합니다.

앵커 링크

페이지 내의 특정 위치로 점프하기 위한 링크입니다. 마크다운 목차에서는 제목 텍스트를 기반으로 자동 생성된 ID(예: `#heading`)를 지정하여 점프합니다.

클라이언트 측 처리

서버와 통신하지 않고 사용자의 브라우저 내에서만 프로그램을 실행하는 메커니즘입니다. 데이터 유출 위험이 없으며 뛰어난 보안을 제공합니다.

Q.입력한 마크다운 데이터는 서버에 저장되나요?

아니요, 저장되지 않습니다. 이 도구는 브라우저 내에서 완전히 실행되는 클라이언트 측 처리를 사용하므로, 입력한 텍스트가 외부 서버로 전송되지 않습니다. 기밀 정보가 포함된 문서에도 안전하게 사용할 수 있습니다.

Q.생성된 목차 링크를 클릭해도 이동하지 않습니다.

플랫폼(GitHub 등)에 따라 제목에서 앵커 ID를 자동으로 생성하는 규칙이 다를 수 있습니다. 이 도구는 일반적인 규칙(소문자 변환, 공백을 하이픈으로 변경 등)을 기반으로 ID를 생성하지만, 플랫폼의 특정 규칙에 맞게 수동으로 수정해야 할 수도 있습니다.

Q.목차에서 특정 제목만 제외할 수 있나요?

현재 버전에서는 지정된 '최대 제목 레벨' 이하의 모든 제목이 추출됩니다. 특정 제목만 제외하는 기능은 없으므로 생성 후 수동으로 삭제해 주시기 바랍니다.

Q.코드 블록 안에 있는 '#' 기호도 추출되나요?

아니요. 이 도구의 추출 알고리즘은 3개의 백틱(```)으로 둘러싸인 코드 블록 내의 텍스트를 무시하도록 설계되어 있습니다. 따라서 코드 내의 주석 등이 목차로 잘못 추출되지 않습니다.

Q.영어 이외의 제목도 지원되나요?

네, 지원됩니다. 한국어, 영어 및 기타 언어의 제목도 올바르게 추출되어 목차로 생성됩니다. 단, 앵커 링크 ID 생성 규칙은 영어를 기본으로 하므로, 영어가 아닌 제목의 경우 경우에 따라 URL 인코딩될 수 있습니다.