Command Palette

Search for a command to run...

마크

마크다운 TOC 생성기

Markdown 제목에서 연결된 목차를 생성합니다

마크다운 목차 생성기란 무엇입니까?

Markdown 목차 생성기는 Markdown 문서의 제목을 읽고 각 섹션으로 점프하는 중첩된 링크 목록을 생성합니다. Markdown 을 붙여 넣으면 도구는 모든 줄이 `[Heading](#anchor)` 링크인 글머리 기호 목록과 같은 즉시 사용 가능한 블록을 손으로 개요를 작성하고 렌더러가 각 제목에 할당할 앵커 ID 를 추측하지 못하게 합니다.

도구의 핵심은 앵커 slug입니다. GitHub,GitLab 및 대부분의 정적 사이트 생성기는 텍스트를 낮추고 구두점을 제거하고 하이픈으로 공백을 대체하여 "시작하기"와 같은 제목을 id `시작하기`로 바꿉니다. 이 생성기는 GitHub 가 두 제목이 slug를 공유할 때 추가하는 숫자 접미사 (`-1`,`-2`) 를 포함하여 동일한 규칙을 적용하므로 README 또는 docs 페이지가 렌더링할 정확한 ID 에 대한 resolve 를 생성합니다. ATX 제목 (`#`로 시작하는 줄) 과 Setext 제목 (`=` 또는 `-`로 밑줄 친 텍스트) 을 모두 읽고 울타리가 있는 코드 블록 내부에 나타나는 `#`을 무시합니다. 인라인 형식을 전달하는 제목은 동일한 방식으로 처리됩니다: 링크,굵은 텍스트,인라인 코드 또는 제목 내부의 이미지는 레이블의 일반 텍스트로 축소되고 앵커는 동일한 정리된 문자열로 구성되므로 두 사람은 항상 동의합니다.

모든 것이 브라우저에서 실행됩니다. 붙여넣은 Markdown 은 클라이언트 측 JavaScript 로 구문 분석되고 기기를 떠나지 않으므로 업로드,계정 및 콘텐츠 추적이 없습니다. 이 도구는 페이지가 로드되면 오프라인으로 작동하며 포함할 제목 수준을 선택하고 글머리 기호와 번호가 매겨진 목록 사이를 전환하고 들여쓰기를 제어할 수 있으며 옵션을 변경하는 순간 개요를 업데이트합니다.

Markdown TOC 생성기를 사용하는 방법은 무엇입니까?

  1. 마크다운 붙여넣기

    전체 Markdown 문서 또는 README 를 입력 상자에 넣습니다. 울타리가 있는 코드 블록 내부의 제목은 자동으로 건너뜁니다.

  2. 제목 수준을 선택합니다

    포함할 가장 얕고 깊은 레벨을 설정합니다. 일반적인 선택은 H2 에서 H3 로 모든 하위 섹션을 나열하지 않고도 윤곽을 읽을 수 있도록 유지합니다.

  3. 목록 스타일을 선택합니다

    글머리 기호 또는 번호가 매겨진 목록 사이를 전환하고 앵커 링크를 켜거나 끄고 2 칸, 4 칸 또는 탭 들여쓰기를 선택합니다.

  4. 목차를 복사합니다

    생성된 마크다운을 복사하여 문서 상단 근처에 붙여넣습니다. 각 항목은 일치하는 제목 앵커로 연결됩니다.

주요 특징

  • GitHub 호환 앵커

    Slugs 중복된 제목에 대한 숫자 접미사를 포함하여 ID GitHub 렌더링과 일치하므로 모든 링크가 올바르게 해결됩니다.

  • 레벨 필터링

    원하는 표제 수준만 포함하십시오. 중첩은 포함된 가장 얕은 표제에서 측정되므로 H2 에서 시작하는 목록은 왼쪽으로 플러시됩니다.

  • 주문 또는 주문되지 않음

    선택적 앵커 링크와 구성 가능한 들여쓰기를 사용하여 레벨별 카운터가 포함된 글머리 기호 목록 또는 번호가 매겨진 목록을 출력합니다.

  • 코드 차단 인식

    울타리가 있는 코드 블록 안에 쓰여진 표제는 무시되므로 예제 조각은 개요에 새어 들어가지 않습니다.

Frequently Asked Questions

마크다운 목차는 같은 페이지 내의 표제 앵커를 가리키는 링크의 목록입니다. 마크다운 문서의 각 표제에는 자동 id 가 주어지며, [Section](#section) 으로 작성된 링크가 해당 표제로 이동합니다. 이 도구는 표제를 읽고,일치하는 앵커를 빌드하고,중첩된 목록을 조립합니다.

Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!

markdown table of contentsmarkdown toc generatorgenerate tocmarkdown toctable of contents generatorgithub anchor linksreadme tocheading linksmarkdown outline