Markdown 템플릿 변수 렌더러

Markdown 템플릿 변수 렌더러 사용 가이드

매달 비슷한 공지문이나 고객별 안내문을 쓸 때는 바뀌는 부분만 변수로 두고 값을 갈아 끼우면 빠릅니다. 이 렌더러는 Markdown 템플릿 안의 {{제목}}, {{user.name}} 같은 자리를 JSON으로 적은 값으로 채워 완성된 문서를 만들어 줍니다.

변수 이름에는 한글·영문·숫자·밑줄·하이픈을 쓸 수 있고, 점(.)으로 JSON 안쪽 값을 찾아 들어갑니다. 값이 목록이나 객체면 JSON 글자로 들어가며, JSON에 없는 변수는 원래 모양 그대로 남겨 빠뜨린 값을 찾기 쉽게 합니다.

결과 끝에는 '<!-- 채운 변수 3개 · 값이 없는 변수: 없음 -->' 같은 확인용 주석이 붙습니다. 조건문이나 반복문 같은 템플릿 문법은 지원하지 않습니다.

사용 방법

1. 1'Markdown 템플릿' 칸에 바꿀 자리를 {{변수}}로 표시한 원고를 적습니다.
2. 2'변수 값 (JSON)' 칸에 {"제목": "안내", "user": {"name": "김"}}처럼 값을 적습니다.
3. 3'실행'을 누르고 끝 주석에서 값이 없는 변수가 없는지 확인한 뒤 주석을 지우고 '결과 복사'합니다.

Markdown 템플릿:
# {{제목}}
안녕하세요 {{user.name}}님. 다음 회의는 {{date}}입니다.

변수 값 (JSON):
{"제목": "10월 공지", "user": {"name": "김민지"}}

# 10월 공지
안녕하세요 김민지님. 다음 회의는 {{date}}입니다.

<!-- 채운 변수 2개 · 값이 없는 변수: date -->

이럴 때 쓰면 좋아요

• 고객 이름과 날짜만 바뀌는 안내문을 여러 장 만들 때
• 매주 같은 형식의 회의록·주간 보고 틀을 채울 때
• README나 문서 틀에 프로젝트 이름과 버전을 넣을 때
• 다른 시스템에서 내보낸 JSON 값으로 문서를 자동 작성할 때

문제가 생겼을 때

활용 팁

• 변수 이름은 영어 소문자보다 '고객명'처럼 한글로 쓰면 템플릿만 봐도 무엇을 넣을지 알기 쉽습니다.
• 여러 명에게 보낼 문서라면 JSON만 바꿔 가며 다시 실행하면 됩니다. 템플릿 칸은 그대로 두세요.

자주 묻는 질문