mdBook SUMMARY 생성기

브라우저 처리

선택한 Markdown 파일로 mdBook의 SUMMARY.md를 만듭니다. README는 번호 없는 머리말 장으로 맨 앞에 두고, 나머지 장은 번호 순서대로 - [제목](파일.md) 목록이 됩니다.

사용 전 확인

파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.

도구 실행입력 후 결과 확인

mdBook SUMMARY 생성기 샘플 실행

mdBook은 Rust 커뮤니티에서 많이 쓰는 Markdown 책 생성기로, src/SUMMARY.md 파일이 책의 목차와 장 순서를 정합니다. 장 파일이 많아지면 SUMMARY.md를 손으로 관리하기 번거로운데, 이 생성기가 선택한 파일로 만들어 줍니다.

브라우저 처리

샘플 입력

선택한 파일: 10-faq.md (# 자주 묻는 질문), 2-setup.md (제목 없음), README.md (# 소개)

샘플 결과

# Summary

[소개](README.md)

- [setup](2-setup.md)
- [자주 묻는 질문](10-faq.md)

자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

mdBook SUMMARY 생성기 사용 가이드

결과는 '# Summary' 제목으로 시작하고, README·index·introduction 파일이 있으면 글머리표 없는 머리말 장([소개](README.md))으로 맨 앞에 둡니다. 나머지 파일은 01-, 2- 같은 앞 번호를 크기로 비교해 정렬하고, 각 장 이름은 문서의 # 제목을 씁니다.

제목이 없는 파일은 파일 이름에서 번호와 확장자를 떼어 장 이름으로 씁니다. 하위 장(들여쓰기)은 만들지 않으므로 필요하면 결과에서 들여써 추가하세요.

사용 방법

'Markdown 파일'에서 책에 들어갈 장 파일(README.md 포함)을 모두 고릅니다.
'실행'을 누르면 SUMMARY.md 내용이 나옵니다.
결과를 src/SUMMARY.md로 저장하고 mdbook build로 책을 만듭니다.

예시: 머리말과 두 장

입력

선택한 파일: 10-faq.md (# 자주 묻는 질문), 2-setup.md (제목 없음), README.md (# 소개)

결과

# Summary

[소개](README.md)

- [setup](2-setup.md)
- [자주 묻는 질문](10-faq.md)

README는 글머리표 없는 머리말 장이 되고, 나머지는 2 → 10 숫자 순서입니다.

이럴 때 쓰면 좋아요

mdBook으로 사내 가이드북을 만들 때
장 파일을 추가한 뒤 SUMMARY.md를 다시 만들 때
강의 자료를 번호 순서대로 책 목차로 묶을 때
GitBook 형식 목차를 mdBook으로 옮길 때

문제가 생겼을 때

mdbook build가 파일을 못 찾음

SUMMARY.md의 경로는 src/ 폴더 기준입니다. 장 파일이 하위 폴더에 있으면 링크 앞에 'chapters/' 같은 폴더를 붙이세요.

README가 일반 장처럼 번호가 붙음

파일 이름이 README.md, index.md, introduction.md, intro.md일 때만 머리말 장으로 봅니다. 다른 이름이면 결과에서 맨 위로 옮기고 '- '를 지우세요.

활용 팁

장 파일 이름에 01-, 02- 번호를 붙여 두면 목차 순서가 자동으로 맞고, 장 이름에는 번호가 보이지 않습니다.
하위 장은 상위 장 아래에 공백 두 칸 또는 네 칸으로 들여써 '- [하위 장](sub.md)'을 추가하면 됩니다.

자주 묻는 질문

제목이 영어인 파일은 어떻게 되나요?

문서의 # 제목을 그대로 장 이름으로 씁니다. 제목이 없을 때만 파일 이름에서 장 이름을 만듭니다.

부(Part) 제목도 넣을 수 있나요?

자동으로는 넣지 않습니다. mdBook의 '# 1부 기초' 같은 부 제목은 결과의 목록 사이에 직접 추가하세요.

EPUB으로도 만들 수 있나요?

mdBook 플러그인을 쓰거나, 장 파일을 Markdown 파일 합치기로 합친 뒤 Markdown → EPUB 변환기로 만들 수 있습니다.