Markdown 제목·파일명·슬러그 검사기
브라우저 처리Markdown 문서의 # 제목으로 만든 권장 파일 이름(슬러그.md)과 실제 파일 이름이 같은지 확인합니다. 문서 사이트의 주소와 제목을 맞출 때 씁니다.
- 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
문서 사이트나 블로그는 파일 이름이 곧 주소(슬러그)가 되는 경우가 많습니다. 제목은 '설치 안내'로 바꿨는데 파일은 여전히 'setup-old.md'라면 주소와 내용이 어긋나 찾기 어렵습니다. 이 검사기는 문서의 H1 제목과 파일 이름이 맞는지 확인합니다.
H1 제목: 설치 안내 파일 이름: 설치-안내.md 권장 파일 이름: 설치-안내.md 일치: 예
Markdown 제목·파일명·슬러그 검사기 사용 가이드
문서 사이트나 블로그는 파일 이름이 곧 주소(슬러그)가 되는 경우가 많습니다. 제목은 '설치 안내'로 바꿨는데 파일은 여전히 'setup-old.md'라면 주소와 내용이 어긋나 찾기 어렵습니다. 이 검사기는 문서의 H1 제목과 파일 이름이 맞는지 확인합니다.
H1 제목을 앵커 규칙(소문자, 공백→하이픈, 기호 제거)으로 바꿔 '권장 파일 이름'을 만들고, 입력한 파일 이름과 대소문자를 무시하고 비교해 '일치: 예/아니요'를 보여 줍니다. 파일 이름에 폴더 경로가 붙어 있으면 마지막 이름만 봅니다.
한글 제목은 '설치-안내.md'처럼 한글 그대로 권장합니다. 영문 주소가 필요하면 URL 슬러그 생성기로 로마자 이름을 따로 만드세요.
사용 방법
- 'Markdown 내용 (# 제목 포함)' 칸에 문서 내용이나 첫 줄 # 제목을 붙여 넣습니다.
- '파일 이름' 칸에 현재 파일 이름(예: docs/설치-안내.md)을 적습니다.
- '실행'을 누르고 '일치: 아니요'라면 권장 파일 이름으로 바꾸거나 제목을 고칩니다.
예시: 폴더 경로가 붙은 한글 파일
Markdown 내용 (# 제목 포함): # 설치 안내 파일 이름: docs/설치-안내.md
H1 제목: 설치 안내 파일 이름: 설치-안내.md 권장 파일 이름: 설치-안내.md 일치: 예
앞의 docs/ 폴더는 빼고 파일 이름만 비교합니다.
이럴 때 쓰면 좋아요
- 문서 사이트에 올리기 전 파일 이름과 제목을 맞출 때
- 제목을 바꾼 뒤 파일 이름도 바꿔야 하는지 확인할 때
- 블로그 글 파일의 슬러그 규칙을 점검할 때
- 여러 사람이 만든 문서의 파일 이름 규칙을 통일할 때
문제가 생겼을 때
문서에 # 제목(H1)이 없습니다. ## 제목만 있으면 비교하지 않으니 맨 위에 '# 제목' 한 줄을 넣으세요.
괄호와 기호는 권장 이름에서 지워집니다. '자주 묻는 질문 (FAQ)'은 '자주-묻는-질문-faq.md'가 되니 파일 이름도 이 규칙을 따르세요.
활용 팁
- 파일 이름을 바꾸면 그 문서로 가는 링크가 끊길 수 있습니다. 바꾼 뒤 Markdown 경로 재작성기로 다른 문서의 링크를 함께 고치세요.
- 제목이 길면 파일 이름도 길어집니다. 제목은 그대로 두고 핵심 단어만 남긴 짧은 이름을 쓰는 사이트라면 이 결과는 참고로만 보세요.
자주 묻는 질문
아니요. 대소문자는 무시하고 비교합니다. 다만 리눅스 서버는 대소문자를 구분하므로 소문자로 통일하는 편이 안전합니다.
권장 이름은 .md까지 포함하므로 확장자를 빼면 '아니요'로 나옵니다. 실제 파일 이름 전체를 적으세요.
아니요. 본문의 # 제목만 기준으로 합니다. Front Matter 점검은 Markdown Front Matter 편집·검사기를 쓰세요.