Markdown Front Matter 편집·검사기

Markdown Front Matter 편집·검사기 사용 가이드

Jekyll, Hugo, Astro 같은 정적 사이트 생성기는 글 맨 앞의 --- 사이에 적은 Front Matter(YAML)로 제목, 날짜, 태그를 읽습니다. 여기서 콜론 하나만 잘못 써도 빌드가 멈추거나 글이 목록에서 사라지는데, 오류 메시지가 불친절해 원인을 찾기 어렵습니다.

이 검사기는 첫 줄의 --- 블록을 읽어 'key: 값' 형식이 아닌 줄, 같은 키가 두 번 나온 경우, 'title: Hello: World'처럼 따옴표 없이 ': '가 들어간 값, 탭으로 들여쓴 줄을 줄 번호와 함께 알려 줍니다. 문제가 없으면 '통과: Front Matter 키 3개.'처럼 키 개수가 나옵니다.

빈 줄, # 주석, ' - 태그'처럼 들여쓴 목록 줄은 올바른 YAML이라 오류로 보지 않습니다. 날짜 형식이나 값의 종류까지는 검사하지 않습니다.

사용 방법

1. 1'.md·.txt 파일'에서 글 파일을 고르거나 'Markdown 내용'에 Front Matter가 포함된 원고를 붙여 넣습니다.
2. 2'실행'을 누르면 '2행: 값에 ': '가 들어 있어 따옴표로 감싸야 합니다'처럼 문제가 줄 번호와 함께 나옵니다.
3. 3'Markdown 내용' 칸에서 해당 줄을 바로 고치고 다시 실행해 '통과'가 나오는지 확인합니다.

---
title: Hello: World
	tags: x
title: again
---
# 본문

2행: 값에 ': '가 들어 있어 따옴표로 감싸야 합니다
3행: YAML 들여쓰기에 탭을 쓸 수 없습니다. 공백으로 바꾸세요
중복 키: title

이럴 때 쓰면 좋아요

• 정적 사이트 빌드가 YAML 오류로 멈췄을 때 원인 줄을 찾을 때
• 새 글을 올리기 전에 머리말의 중복 키를 확인할 때
• 다른 블로그에서 옮겨 온 글의 Front Matter 형식을 점검할 때
• 제목에 콜론이 들어간 글의 따옴표 처리를 확인할 때

문제가 생겼을 때

활용 팁

• 값에 콜론, #, 따옴표가 들어가면 큰따옴표로 감싸는 습관을 들이면 대부분의 YAML 오류를 피할 수 있습니다.
• 여러 글의 키를 한꺼번에 추가·삭제해야 하면 Markdown Front Matter 일괄 편집기를 쓰세요.

자주 묻는 질문