Markdown 목차 생성기
문서 내 헤딩에서 GitHub 스타일 Markdown 목차를 생성합니다.
Keep your original file until you have checked the downloaded result. Browser memory and format support vary by device.
Headings inside fenced code blocks are ignored. The generated anchors follow GitHub-style slug rules.
Markdown 목차 생성기 FAQ
코드 블록 안의 헤딩은 포함되나요?
아니요. 예시 헤딩이 문서 섹션으로 오인되지 않도록 fences가 있는 코드 블록은 무시됩니다.
H1부터 H6까지 지원하나요?
네. 표시자 뒤에 공백이 따르는 한 # 하나부터 # 여섯 개까지의 표준 ATX 헤딩이 인식됩니다.
문서 제목을 포함할 수 있나요?
네. 목차를 생성하기 전에 ‘H1 제목 포함’ 옵션을 켜세요.
링크가 모든 Markdown 사이트에 작동하나요?
GitHub 스타일 링크이지만 slug 동작은 다를 수 있습니다. 구두점이나 비라틴 문자가 포함된 헤딩의 경우 대상 렌더러에서 반드시 출력을 테스트하세요.
이 도구가 Markdown 소스를 수정하나요?
아니요. 별도의 목차 결과물을 생성하며 입력 텍스트는 편집용으로 그대로 유지됩니다.
Markdown 목차 생성기
문서 내 헤딩에서 Markdown 목차를 생성합니다. Markdown을 붙여넣거나 파일을 열고, H1 제목을 포함할지 여부를 선택한 후 독립된 앵커 링크 목록을 생성할 수 있습니다. 이 도구는 README 파일, 기술 문서, 노트, 정적 사이트 콘텐츠 등에 특화된 개요 생성기입니다.
이 안내에서는 브라우저 작업 흐름 전체, 결과에 포함되어야 할 항목, 공유 전에 확인할 내용을 설명합니다. 이 도구는 하나의 명확한 파일 작업에 집중하도록 설계되었습니다. silently(무음으로) 관련 없는 편집, 변환, 업로드, 클라우드 저장 기능은 추가하지 않습니다. 이렇게 범위를 좁게 유지하면 입력과 출력이 이해하기 쉬워지고, 다운로드한 파일을 확인하는 실용적인 방법을 제공할 수 있습니다.
사용 방법
처리할 파일의 사본을 준비하세요. 페이지가 동작 가능해질 때까지 브라우저 라이브러리를 로드해야 할 수 있으며, 특히 PDF나 비디오 작업의 경우 더 오래 걸릴 수 있습니다. 다음 단계대로 진행하세요:
- 입력 편집기에 Markdown을 붙여넣거나, 열기(Open)를 클릭하여 .md 또는 .markdown 파일을 로드합니다.
- 소스 헤딩을 확인하고 ## 섹션과 같은 표준 ATX 구문을 사용하고 있는지 확인합니다.
- 문서 제목을 목록에 표시해야 할 경우 ‘H1 제목 포함’ 옵션을 켭니다.
- ‘목차 생성’을 클릭하고 출력 패널의 링크를 검토합니다.
- 결과를 문서에 복사하거나 독립된 Markdown 파일로 다운로드합니다.
문서가 중요하거나 특히 복잡한 경우 먼저 대표할 수 있는 작은 파일로 시작하세요. 탭을 닫기 전에 상태 메시지가 처리 완료되었음을 알려줄 때까지 기다립니다. 브라우저가 디코딩, 메모리, 호환성 오류를 보고하면 더 작은 파일이나 일반적인 소스 형식으로 시도하세요. 다운로드가 원본을 덮어쓰지 않으므로 결과가 확인될 때까지 원본을 보관하세요.
적합한 사용 사례
이 도구는 다음과 같은 집중적이고 반복 가능한 파일 준비 작업에 유용합니다:
- GitHub README나 프로젝트 문서 페이지를 위한 탐색 목록 만들기
- 회의록, 강의 자료, 긴 기술 가이드에서 빠른 개요 만들기
- 헤딩이 추가되거나 재정렬된 후 목차 갱신하기
- 정적 사이트 생성기나 지식 데이터베이스용으로 Markdown 콘텐츠 준비하기
다중 트랙 타임라인, 고급 타이포그래피, 복잡한 PDF 양식, 전문적인 색상 관리, forensic한 메타데이터 보장, 모든 독점 파일 기능에 대한 정밀한 순환 보장(round-trip guarantee) 등이 필요할 때 이 도구는 완전한 데스크톱 편집기를 대체할 수 없습니다. 목표에 맞는 특정 작업을 선택하고, 신뢰하기 전에 다운로드한 파일을 소스와 비교하세요.
출력 형식
출력은 UTF-8 Markdown이며, 감지된 각 헤딩당 불릿 링크가 포함됩니다. H1부터 H6까지의 표준 ATX 헤딩은 fences가 있는 코드 블록 외부에서 인식됩니다. 들여쓰기는 발견된 첫 번째 헤딩을 기준으로 한 헤딩 깊이를 나타내며, 동일한 헤딩 텍스트에는 숫자 접미사가 추가되어 링크가 고유하게 유지됩니다. 앵커 규칙은 GitHub, GitLab, Markdown 라이브러리, 정적 사이트 생성기 간에 약간씩 다르므로, 게시할 플랫폼에서 완성된 문서를 미리 보세요. 소스 Markdown은 다시 작성되지 않습니다.
다운로드는 새 파일 또는 패키지로, 입력 패널에서 선택한 파일을 수정하지 않습니다. 가능한 경우 파일명은 소스 이름에서 파생되며 작업 특화 접미사가 붙어 원본과 결과를 쉽게 구분할 수 있습니다. ZIP 결과물에는 하나 이상의 생성된 자산이 포함될 수 있으므로, 예상한 파일이 포함되어 있는지 확인하려면 압축을 풀어보세요. 텍스트 결과의 경우 다운로드 후 줄 바꿈, 인코딩, 들여쓰기, 그리고 플랫폼별 구문을 검토하세요. 시각적 결과물이나 문서 결과물의 경우 목적지에 중요한 해상도, 페이지 순서, 재생, 글꼴, 링크, 투명도, 그리고 기타 기능을 확인하세요.
개인정보 보호
이 작업 흐름에서는 텍스트가 브라우저 내에서 파싱되며 AI 쓰기 서비스나 원격 Markdown API로 전송되지 않습니다. 선택한 파일은 탭을 닫을 때까지 페이지 메모리에 남아 있을 수 있습니다. 공개 컴퓨터에 기밀 자격증명, 개인 고객 정보, 미출간 법률 자료 등 민감한 텍스트를 붙여넣지 마세요. 출력물은 결과를 생성하는 데 사용된 장치와 브라우저 세션만큼만 비공개로 유지됩니다.
브라우저 처리는周囲의 모든 웹사이트, 브라우저 확장 프로그램, 운영체제, 공용 컴퓨터가 비공개라는 보장을 의미하지 않습니다. 신뢰할 수 있는 장치를 사용하고, 민감한 작업 후에는 탭을 닫으며, 기밀 자료에는 공개 컴퓨터를 사용하지 마세요. 소유하거나 편집 권한이 없는 파일을 선택하지 마세요. 조직에서 문서화된 데이터 처리 계약, 보존 정책, 감사 trail이 필요한 경우 대중용 브라우저 도구에만 의존하지 말고 승인된 내부 작업 흐름을 사용하세요.
품질 및 호환성 참고사항
이 생성기는 의도적으로 보수적인 헤딩 감지를 사용합니다. 모든 Markdown 확장자를 렌더링하거나,굵은 텍스트에서 헤딩을 추론하거나, HTML 제목 요소를 검사하거나, 사용자 정의 slug 규칙이 게시 플랫폼과 일치한다는 보장을 제공하지 않습니다. fences가 있는 코드 블록 안의 헤딩은 무시되지만, 비정상적인 fence 중첩이나 생성된 HTML은 수동 확인이 필요할 수 있습니다. 게시 전 구두점, 중복 헤딩, 링크 대상 등을 검토하세요.
다운로드가 성공했다는 것은 브라우저가 결과를 생성했다는 뜻이지, 모든 대상 애플리케이션이 예상한 대로 정확히 받아들이거나 표시한다는 보장은 아닙니다. 결과가 사용될 애플리케이션, 웹사이트, 장치에서 결과를 열어보세요. 정확도가 중요한 경우 소스와 출력을 나란히 비교하고, 복구 가능한 마스터로서 소스를 보관하세요.