이메일 HTML 코딩 지옥에서 벗어나기—Email.md로 마크다운만 쓰면 끝

이메일 HTML, 왜 이렇게 힘든 걸까

웹 개발을 해본 분이라면 한 번쯤은 이메일 템플릿을 만들어본 적 있을 거예요. 그리고 그 경험이 얼마나 고통스러웠는지도 기억하실 거예요. 일반적인 웹 페이지에서는 Flexbox, Grid, 최신 CSS를 마음껏 쓸 수 있지만, 이메일 HTML은 완전히 다른 세계거든요.

이게 뭐냐면, 이메일 클라이언트(Gmail, Outlook, Apple Mail, 네이버 메일 등)마다 HTML과 CSS를 렌더링하는 방식이 전부 달라요. 특히 Outlook은 아직도 Microsoft Word의 렌더링 엔진을 사용하고 있어서, 2026년인 지금도 <table> 태그로 레이아웃을 짜야 하는 경우가 많아요. CSS float도 안 되고, margin이 무시되기도 하고, 외부 CSS 파일은 아예 로드를 안 하는 클라이언트도 있어요. 그래서 모든 스타일을 인라인으로 넣어야 하죠.

이런 고통을 해결하겠다고 나온 도구가 Email.md예요. 이름 그대로, 마크다운(Markdown)으로 이메일 내용을 작성하면 모든 이메일 클라이언트에서 제대로 보이는 반응형 HTML로 변환해주는 도구예요.

Email.md가 하는 일

사용법은 정말 간단해요. 그냥 마크다운으로 이메일 내용을 쓰면 돼요. 제목은 #, 볼드는 **, 리스트는 -, 링크는 텍스트. 평소에 README.md 쓰듯이 작성하면 되는 거죠.

Email.md는 이 마크다운을 파싱해서, 이메일 클라이언트 호환성을 고려한 HTML로 변환해줘요. 구체적으로 어떤 일을 하냐면, 모든 CSS를 인라인 스타일로 변환하고, 레이아웃을 테이블 기반으로 구성하고, 반응형 디자인을 위한 미디어 쿼리를 적절히 넣어주고, 각 이메일 클라이언트의 렌더링 quirk(특이한 동작)에 대한 핵(hack)을 자동으로 적용해요. 개발자가 일일이 Outlook용 조건부 주석(<!--[if mso]>)을 넣거나, Gmail이 무시하는 속성을 피하는 것 같은 삽질을 안 해도 되는 거예요.

웹사이트에서 바로 에디터를 사용해볼 수 있는데요, 왼쪽에 마크다운을 쓰면 오른쪽에 실시간으로 이메일 미리보기가 나와요. 결과물이 마음에 들면 HTML을 복사해서 이메일 발송 시스템에 붙여넣기만 하면 돼요.

기존 도구들과 비교하면

이메일 템플릿 문제를 풀려는 시도가 이전에도 있었어요. MJML은 자체 마크업 언어를 정의해서 이메일 호환 HTML을 생성하는데, 꽤 강력하지만 새로운 문법을 배워야 한다는 진입 장벽이 있어요. Foundation for Emails(구 Inky)도 비슷한 접근이고요. React Email은 React 컴포넌트로 이메일을 만드는 건데, React 생태계에 익숙한 사람에겐 좋지만 단순한 이메일 하나 보내려고 React 프로젝트를 세팅하는 건 과한 경우가 많죠.

Email.md의 강점은 바로 그 단순함에 있어요. 마크다운은 거의 모든 개발자가 이미 알고 있는 형식이잖아요. 새로운 걸 배울 필요가 전혀 없어요. 물론 MJML이나 React Email처럼 복잡한 레이아웃(2단 칼럼, 카드 그리드 등)을 만들기는 어렵겠지만, 실제로 개발팀에서 보내는 이메일 대부분은 텍스트 위주의 알림, 뉴스레터, 트랜잭션 이메일이잖아요. 이런 용도라면 마크다운으로 충분해요.

어디에 써볼 수 있을까

한국 개발자분들이 당장 활용할 수 있는 시나리오를 생각해보면요. 첫째, 사이드 프로젝트에서 회원가입 확인 이메일이나 비밀번호 재설정 이메일을 보내야 할 때요. 디자이너 없이 혼자 만드는 프로젝트에서 이메일 HTML을 직접 짜는 건 시간 낭비거든요. Email.md로 빠르게 만들 수 있어요.

둘째, 사내 자동화 이메일이에요. 배포 알림, 모니터링 경고, 주간 리포트 같은 걸 이메일로 보내는 경우가 많잖아요. 이런 건 화려한 디자인이 필요 없고, 내용만 깔끔하게 전달되면 되니까 마크다운이 딱이에요.

셋째, 개발팀 뉴스레터예요. 사내 기술 블로그나 위클리 다이제스트를 이메일로 발행하는 팀이라면, 마크다운으로 작성하고 바로 이메일용 HTML로 변환하는 워크플로우를 만들 수 있어요.

API나 CLI 도구로도 제공되기 때문에, CI/CD 파이프라인이나 백엔드 서비스에 통합하는 것도 가능해요. 마크다운 파일을 Git으로 관리하면서 자동으로 이메일 HTML을 생성하는 식으로 쓸 수 있죠.

핵심 정리

이메일 HTML 코딩은 2026년에도 여전히 2006년 방식을 써야 하는 기이한 영역이에요. Email.md는 "마크다운만 쓰면 나머지는 알아서 해줄게"라는 깔끔한 약속을 하고 있어요. 혹시 이메일 템플릿 때문에 고생한 경험이 있으신가요? 어떤 도구를 쓰고 계신지 공유해주세요.