본문 바로가기

Markdown 제목·파일명·슬러그 검사기

브라우저 처리

Markdown 문서의 # 제목으로 만든 권장 파일 이름(슬러그.md)과 실제 파일 이름이 같은지 확인합니다. 문서 사이트의 주소와 제목을 맞출 때 씁니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
Markdown 제목·파일명·슬러그 검사기 샘플 실행

문서 사이트나 블로그는 파일 이름이 곧 주소(슬러그)가 되는 경우가 많습니다. 제목은 '설치 안내'로 바꿨는데 파일은 여전히 'setup-old.md'라면 주소와 내용이 어긋나 찾기 어렵습니다. 이 검사기는 문서의 H1 제목과 파일 이름이 맞는지 확인합니다.

브라우저 처리
샘플 결과
H1 제목: 설치 안내
파일 이름: 설치-안내.md
권장 파일 이름: 설치-안내.md
일치: 예
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

Markdown 제목·파일명·슬러그 검사기 사용 가이드

문서 사이트나 블로그는 파일 이름이 곧 주소(슬러그)가 되는 경우가 많습니다. 제목은 '설치 안내'로 바꿨는데 파일은 여전히 'setup-old.md'라면 주소와 내용이 어긋나 찾기 어렵습니다. 이 검사기는 문서의 H1 제목과 파일 이름이 맞는지 확인합니다.

H1 제목을 앵커 규칙(소문자, 공백→하이픈, 기호 제거)으로 바꿔 '권장 파일 이름'을 만들고, 입력한 파일 이름과 대소문자를 무시하고 비교해 '일치: 예/아니요'를 보여 줍니다. 파일 이름에 폴더 경로가 붙어 있으면 마지막 이름만 봅니다.

한글 제목은 '설치-안내.md'처럼 한글 그대로 권장합니다. 영문 주소가 필요하면 URL 슬러그 생성기로 로마자 이름을 따로 만드세요.

사용 방법

  1. 'Markdown 내용 (# 제목 포함)' 칸에 문서 내용이나 첫 줄 # 제목을 붙여 넣습니다.
  2. '파일 이름' 칸에 현재 파일 이름(예: docs/설치-안내.md)을 적습니다.
  3. '실행'을 누르고 '일치: 아니요'라면 권장 파일 이름으로 바꾸거나 제목을 고칩니다.

예시: 폴더 경로가 붙은 한글 파일

입력
Markdown 내용 (# 제목 포함):
# 설치 안내

파일 이름:
docs/설치-안내.md
결과
H1 제목: 설치 안내
파일 이름: 설치-안내.md
권장 파일 이름: 설치-안내.md
일치: 예

앞의 docs/ 폴더는 빼고 파일 이름만 비교합니다.

이럴 때 쓰면 좋아요

  • 문서 사이트에 올리기 전 파일 이름과 제목을 맞출 때
  • 제목을 바꾼 뒤 파일 이름도 바꿔야 하는지 확인할 때
  • 블로그 글 파일의 슬러그 규칙을 점검할 때
  • 여러 사람이 만든 문서의 파일 이름 규칙을 통일할 때

문제가 생겼을 때

'(H1 제목이 필요합니다)'로 나옴

문서에 # 제목(H1)이 없습니다. ## 제목만 있으면 비교하지 않으니 맨 위에 '# 제목' 한 줄을 넣으세요.

제목에 괄호가 있어 이름이 달라짐

괄호와 기호는 권장 이름에서 지워집니다. '자주 묻는 질문 (FAQ)'은 '자주-묻는-질문-faq.md'가 되니 파일 이름도 이 규칙을 따르세요.

활용 팁

  • 파일 이름을 바꾸면 그 문서로 가는 링크가 끊길 수 있습니다. 바꾼 뒤 Markdown 경로 재작성기로 다른 문서의 링크를 함께 고치세요.
  • 제목이 길면 파일 이름도 길어집니다. 제목은 그대로 두고 핵심 단어만 남긴 짧은 이름을 쓰는 사이트라면 이 결과는 참고로만 보세요.

자주 묻는 질문

대소문자가 다르면 불일치인가요?

아니요. 대소문자는 무시하고 비교합니다. 다만 리눅스 서버는 대소문자를 구분하므로 소문자로 통일하는 편이 안전합니다.

.md 확장자를 안 적으면요?

권장 이름은 .md까지 포함하므로 확장자를 빼면 '아니요'로 나옵니다. 실제 파일 이름 전체를 적으세요.

Front Matter의 title도 보나요?

아니요. 본문의 # 제목만 기준으로 합니다. Front Matter 점검은 Markdown Front Matter 편집·검사기를 쓰세요.