2026년 3월 게시

Markdown용 자동 생성 목차

긴 Markdown 파일에는 탐색이 필요합니다. 제목에서 생성된 목차는 모든 문서를 스캔 가능하게 만듭니다. ShowMeMyMD는 자동으로 생성합니다 — 태그 없음, 플러그인 없음, CLI 도구 없음.

## 문제점

Markdown에는 내장 TOC가 없습니다

Markdown에는 목차 구문이 없습니다. 스펙에 [TOC] 태그가 없습니다. 일부 도구는 지원하지만 대부분은 아닙니다.

그래서 우회 방법을 사용합니다. markdown-toc이나 doctoc 같은 CLI 생성기가 파일에 TOC Markdown을 주입합니다. VS Code에는 확장이 있습니다. GitHub는 웹에서 README 파일에 자동 생성합니다.

어느 것도 자동이 아닙니다. 파일을 수정하거나 도구를 설치해야 합니다. 그리고 제목을 변경하면 무언가를 다시 실행할 때까지 TOC가 오래됩니다.

## ShowMeMyMD의 방식

파일을 열면. TOC가 이미 있습니다.

제목이 있는 아무 .md 파일을 열면 — #부터 ######까지 — ShowMeMyMD가 클릭 가능한 목차를 자동으로 생성합니다.

삽입할 태그 없음. 설치할 플러그인 없음. 실행할 CLI 도구 없음. 설정 없음. 파일을 열고 탐색하세요.

핵심 사항

TOC는 렌더링 시점에 생성됩니다. .md 파일은 절대 수정되지 않습니다. 제목을 변경하면 다음에 파일을 열 때 TOC가 즉시 업데이트됩니다.

## 왜 중요한가

긴 문서에는 탐색이 필요합니다

구조가 있는 모든 문서는 클릭 가능한 TOC의 혜택을 받습니다. 수백 줄을 스크롤하는 대신 필요한 섹션으로 바로 이동하세요.

README 파일

설치, 사용법, API 문서, 기여 섹션이 있는 오픈소스 프로젝트. 필요한 곳으로 바로 이동.

문서

기술 사양, API 참조, 런북. TOC가 텍스트 벽을 탐색 가능한 리소스로 변환합니다.

회의록

안건, 결정 사항, 액션 아이템. 전체 문서를 다시 읽지 않고 지난주 결정을 찾으세요.

기술 사양

아키텍처 결정, 설계 문서, RFC. 복잡한 문서를 섹션별로 탐색하세요.

## 대안

Markdown TOC를 얻는 다른 방법

수동 TOC

제목 앵커에 대한 Markdown 링크를 수동으로 작성합니다. [설치](#installation) 같은 형태입니다. 작성이 번거롭고, 제목이 변경되면 깨지며, 직접 유지보수해야 합니다.

markdown-toc (npm)

TOC를 생성하여 파일에 Markdown 텍스트로 삽입하는 CLI 도구입니다. 작동하지만 Node.js, npm 설치가 필요하고, 제목이 변경될 때마다 명령어를 다시 실행해야 합니다. 소스 파일을 수정합니다.

VS Code 확장

여러 VS Code 확장이 TOC 생성을 추가합니다. VS Code 안에서 작동하지만, 문서를 탐색하기 위해 전체 IDE가 필요합니다.

GitHub

GitHub는 웹에서 README 파일의 TOC를 자동 생성합니다. 파일명 옆의 햄버거 아이콘을 클릭하세요. 하지만 GitHub.com에서만 작동합니다 — Mac의 로컬 파일에서는 작동하지 않습니다.

## 간단한 방법

그냥 파일을 열면 됩니다

ShowMeMyMD는 제목에서 자동으로 목차를 생성합니다. 파일을 수정하지 않습니다. 비파괴적입니다. #부터 ######까지 모든 제목 구조에서 작동합니다.

TOC는 항상 최신입니다. 현재 파일 그대로에서 생성되기 때문입니다 — 캐시된 스냅샷이나 오래될 수 있는 주입된 블록이 아닙니다.

## 계속 읽기

스크롤하지 마세요. 탐색하세요.

$2.99. 일회성 구매. 구독 없음. 계정 없음.

다운로드:Mac App Store