Markdown 파일 작성
Markdown 작성 후 .md 다운로드. Front Matter / 표 / 코드 블록 / 목록 / 제목 단축키, 실시간 미리보기, 템플릿 (README / Blog / ADR / Changelog).
완전 무료
가입 불필요
브라우저 완결
즉시 다운로드
5 개 언어
다크 모드
AI 코딩 어시스턴트용은:
AGENTS.md / CLAUDE.md 생성기 →
0 문자 / 0 단어 / 0 줄
📖 자주 걸리는 지점
Markdown 을 써서 .md 파일로 내려받습니다. Front Matter 견본도 준비되어 있어 정적 사이트 생성기나 AI 코딩 어시스턴트의 설정 파일을 바로 만들 수 있습니다. 여기 보이는 미리보기는 기본적인 Markdown 해석이며, 공개 대상이 GitHub 인지 Hugo 인지 Notion 인지에 따라 표 · 각주 · 체크박스의 처리는 달라집니다.
| 사례 | 무슨 일이 일어나는가 | 어떻게 하면 되는가 |
|---|---|---|
| Front Matter 가 읽히지 않는다 | YAML 은 서식에 엄격하고 조용히 깨집니다. 들여쓰기에 탭을 쓰는 것, : 뒤에 공백이 없는 것, 값에 : 가 들어 있는데 따옴표를 치지 않은 것이 3대 원인입니다. 또 구분자 --- 는 파일의 첫 줄이어야 하며 앞에 빈 줄이나 BOM 이 있기만 해도 본문의 수평선으로 취급됩니다. |
들여쓰기는 공백 2칸으로 통일하고 제목 같은 자유 입력은 반드시 "…" 로 감쌉니다. 날짜는 2026-07-26 형태로 쓰세요(2026/07/26 은 문자열로 취급되어 정렬이 깨집니다). 다 쓴 뒤 YAML 파서에 한 번 통과시키는 것이 확실합니다. |
| 줄바꿈했는데 한 줄로 붙는다 | Markdown 은 단일 줄바꿈을 공백으로 취급합니다. 원고에서는 줄을 바꿨는데 렌더링 결과에서는 앞줄의 연속이 되는 것은 이 때문입니다. 사양대로의 동작이며 버그가 아닙니다. | 문단을 나누고 싶다면 빈 줄을 한 줄 넣습니다. 문단 안에서 줄만 바꾸고 싶다면 줄 끝에 공백 2칸을 두거나 <br> 을 씁니다. 다만 줄 끝 공백은 에디터의 저장 시 끝 공백 제거 설정으로 사라지므로 팀 개발에서는 <br> 이 더 안전합니다. |
| Git 차분이 전 행으로 나온다 | 한 글자만 고쳤는데 전 행이 차분이 되는 것은 거의 줄바꿈 코드가 CRLF 와 LF 사이에서 바뀌었기 때문입니다. 윈도우 에디터로 저장하면 CRLF 가 되고 리눅스 쪽 도구가 LF 로 되돌리는 왕복이 일어납니다. 문자 코드가 UTF-8 with BOM 인 경우에도 첫 줄만 알 수 없는 차분이 됩니다. | 저장은 UTF-8(BOM 없음) + LF 로 통일합니다. 리포지터리 루트에 .gitattributes 를 두고 *.md text eol=lf 라고 써 두면 각자의 환경 설정과 무관하게 맞춰집니다. 기존 파일의 일괄 변환은 줄바꿈 코드 변환으로 할 수 있습니다. |
Markdown 에는 유일한 사양이 없습니다. CommonMark 가 공통의 토대에 있고 그 위에 GitHub Flavored Markdown 이 표 · 취소선 · 태스크 리스트 · 자동 링크를 더합니다. 나아가 Hugo 나 Jekyll, Obsidian, Notion 이 각각 독자 문법을 가지며 각주나 수식, 콜아웃의 표기는 호환되지 않습니다. 손안의 미리보기에서 정돈되어 보여도 공개할 곳에서 한 번 확인하세요. 특히 표 안에서 줄바꿈하고 싶다, 셀 안에 코드를 쓰고 싶다 같은 요구는 구현에 따라 가능 여부가 갈립니다.
📖 사용법
-
1
템플릿 선택목적에 맞는 템플릿 선택
-
2
편집 + 미리보기왼쪽 작성, 오른쪽 GFM 미리보기. 삽입 버튼으로 표 / 코드 / 링크 한번에
-
3
.md 다운로드파일명 변경 후 "⬇ .md" 클릭
❓ 자주 묻는 질문
Front Matter？
Blog 템플릿에 YAML Front Matter 포함
GitHub 스타일？
GFM 호환. 표 / 체크리스트 / 취소선 / 자동 링크
개인정보？
완전 브라우저 내
🐛 이 도구에서 문제가 발생했나요?
무료 · 가입 불필요. 재현 절차만이라도 도움이 됩니다. 보고는 운영자에게 직접 전달되어 개선에 사용됩니다.
✅
보고 감사합니다!
운영자에게 전달되었습니다. 개선에 사용됩니다.