문서 사이트 사이드바 생성기

브라우저 처리

선택한 Markdown 문서들로 문서 사이트 사이드바용 링크 목록(_sidebar.md 형식)을 만듭니다. README를 맨 앞에 두고 01-, 2- 같은 번호 순서를 지키며 제목은 문서의 # 제목을 씁니다.

사용 전 확인

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

도구 실행입력 후 결과 확인

문서 사이트 사이드바 생성기 샘플 실행

Docsify, GitBook처럼 Markdown 파일로 만드는 문서 사이트는 사이드바 메뉴를 _sidebar.md 같은 링크 목록으로 관리합니다. 문서를 추가할 때마다 이 목록을 손으로 고치기 번거로운데, 이 생성기가 선택한 파일들로 목록을 만들어 줍니다.

브라우저 처리

샘플 입력

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

샘플 결과

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

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

문서 사이트 사이드바 생성기 사용 가이드

각 문서의 # 제목(H1)을 메뉴 이름으로 쓰고, 제목이 없으면 파일 이름에서 확장자와 앞 번호(01-, 2_)를 떼고 하이픈을 공백으로 바꿔 씁니다. README·index·intro 파일은 맨 앞에, 나머지는 2-setup이 10-faq보다 앞에 오도록 숫자를 크기로 비교해 정렬합니다.

링크 주소의 공백은 %20으로 바꿔 깨지지 않게 합니다. 하위 폴더 구조는 만들지 않고 한 단계 목록으로 만듭니다.

사용 방법

'Markdown 파일'에서 사이드바에 넣을 .md 파일을 모두 고릅니다.
'실행'을 누르면 '- [제목](파일.md)' 형식의 목록이 나옵니다.
결과를 _sidebar.md나 사이트의 메뉴 설정에 붙여 넣고 필요하면 묶음 제목을 추가합니다.

예시: 번호가 붙은 문서 세 개

입력

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

결과

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

README가 맨 앞에 오고, 2-setup이 10-faq보다 앞에 옵니다. 제목이 없는 2-setup.md는 파일 이름에서 번호를 뗀 setup이 됩니다.

이럴 때 쓰면 좋아요

Docsify 문서 사이트의 _sidebar.md를 만들 때
문서를 추가한 뒤 메뉴 목록을 다시 정리할 때
파일 번호 순서대로 학습 자료 목차를 만들 때
README에 넣을 문서 바로가기 목록을 만들 때

문제가 생겼을 때

'목록을 만들 Markdown 파일을 선택하세요'

이 도구는 선택한 파일로 목록을 만듭니다. 붙여 넣은 글만으로는 만들 수 없으니 파일 칸에서 .md 파일을 고르세요.

폴더 구조가 반영되지 않음

브라우저는 파일 이름만 알려 주어 한 단계 목록이 됩니다. 폴더별 묶음은 결과에 '- 시작하기' 같은 상위 항목을 직접 넣고 들여쓰세요.

활용 팁

파일 이름 앞에 01-, 02- 같은 번호를 붙여 두면 원하는 메뉴 순서를 그대로 얻을 수 있고, 메뉴 이름에는 번호가 보이지 않습니다.
모든 문서에 # 제목을 넣어 두면 파일 이름이 영어여도 한국어 메뉴 이름을 얻을 수 있습니다.

자주 묻는 질문

VitePress·Docusaurus 설정 파일도 만드나요?

아니요. Markdown 링크 목록만 만듭니다. JS·JSON 사이드바 설정이 필요한 사이트는 이 목록을 보고 옮겨 적으세요.

README 대신 index.md를 첫 페이지로 쓰면요?

README, index, introduction, intro 파일을 모두 첫 페이지로 보고 맨 앞에 둡니다.

숫자 정렬은 어떻게 하나요?

파일 이름 속 숫자를 크기로 비교해 2-setup이 10-faq보다 앞에 옵니다. 다만 제목 없는 파일도 원래 파일 이름 순서로 정렬합니다.