블록 마크업 레퍼런스
이 페이지는 각 인터랙티브 블록이 발송되는 HTML에 무엇을 넣는지, 그리고 수신자의 답이 어떻게 MailInApp에 도착하는지 보여 줍니다. 개발자와 HTML을 내보내 다른 플랫폼에서 보내는 분을 위한 문서입니다. 수신자에게 보이는 것과 받게 되는 것은 각 블록 페이지에서 설명합니다. 단계 자체는 폴백 작동 방식에서 설명합니다.
예시는 줄여 두었습니다. 실제 출력에는 인라인 스타일, 다크 모드용 클래스, 테마 색상이 더 들어갑니다. 모든 링크는 수신자의 서명된 라이브 뷰 토큰(/v/[token])을 가리키며, 이 토큰이 이메일과 개인화 발송의 경우 수신자를 식별합니다.
답이 기록되는 방식
두 가지 경로가 같은 기록 엔드포인트로 이어지고 같은 이벤트를 만듭니다. 따라서 수신자가 어디서 답했든 결과는 달라지지 않습니다.
- 확인 링크. 탭 한 번으로 하는 답은 블록, 액션, 값을 쿼리에 담은
/v/[token]/act링크(<a href>)입니다. 열린 페이지에서 수신자에게 확인을 요청하고, 그 확인 양식 제출이 답을 기록합니다. 단순한 GET은 아무것도 기록하지 않으므로, 모든 링크를 미리 여는 링크 스캐너와 보안 도구는 투표할 수 없습니다. 스캐너에 안전한 인터랙션 기록을 참고하세요. - 양식 제출. 입력형이나 다중 답변 블록은
/api/interactions로application/x-www-form-urlencoded를 보내는<form method="post">를 담습니다. 웹용 Gmail과 iOS·Android용 Outlook 앱은 이메일에서 바로 보냅니다. 이런 양식에는 라이브 뷰의 같은 블록으로 가는 웹에서 답변하기 링크가 항상 보이며, 라이브 뷰에서는 일반 웹 양식으로 작동합니다.
수신자의 답은 이메일, 블록, 수신자 조합마다 한 번만, 이 세 가지로 만든 문서 ID로 저장됩니다. 그래서 탭을 반복하거나 페이지를 새로 고쳐도 달라지지 않습니다. 수신자 토큰이 없는 내보낸 이메일의 답은 연결할 사람이 없으므로 대신 IP, 캠페인, 분 단위로 횟수가 제한됩니다.
피드백 블록
투표
각 선택지는 칩 모양의 확인 링크이며, 모든 메일 앱에서 항상 보입니다.
<div id="em-poll-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Which do you prefer?</p>
<div>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=poll-1&blockType=poll&action=vote&option=Option+A&optionId=poll-option-2"
style="display:inline-block;margin:0 6px 6px 0;padding:8px 14px;border:1px solid #d1d5db;border-radius:6px;background-color:#ffffff;color:#111827;font-size:14px;text-decoration:none">
Option A
</a>
<a href="...option=Option+B&optionId=poll-option-3" ...>
Option B
</a>
</div>
</div>
여러 답변 허용을 켜면 투표는 체크박스 양식으로 발송되어 체크한 선택지마다 optionId를 하나씩 보내고(저장 시 option과 optionId 병렬 목록), 웹에서 답변하기 링크도 함께 붙습니다. 기타 선택지는 라이브 뷰의 투표로 가는 링크이며, 수신자는 거기서 답을 입력합니다. 섞인 투표의 순서는 수신자의 토큰에서 정해지므로 열 때마다 같습니다. 실시간 결과 이미지는 /api/results-image의 <img>로, 수신자별이 아니라 투표 선택지별로 서명됩니다.
평점
기본 형식인 별은 별마다 확인 링크를 하나씩, 높은 점수부터 오른쪽에서 왼쪽 순서로 발송합니다. 각 링크에는 빈 별과 채운 별이 들어 있습니다. 앱이 지원하면 :hover 규칙이 포인터 위치까지 별을 채우고, 그 밖의 앱에서는 빈 별이 보입니다. 별 이미지는 /api/rating-icon에서 제공합니다.
<div id="em-rating-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">How did we do?</p>
<div dir="rtl" style="direction:rtl;text-align:left;line-height:0">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rating-1&blockType=rating&action=rate&rating=5"
class="em-rating-1-s" aria-label="5 out of 5 stars" style="display:inline-block;padding:6px;line-height:0">
<img src="https://mailinapp.com/api/rating-icon?f=0&c=f59e0b&s=32" alt="5★" width="32" height="32" class="em-rating-1-o">
<!--[if !mso]><!-->
<img src="https://mailinapp.com/api/rating-icon?f=1&c=f59e0b&s=32" alt="" width="32" height="32" class="em-rating-1-f" style="display:none">
<!--<![endif]-->
</a>
<!-- …rating=1까지 별마다 링크 하나 -->
</div>
</div>
다른 형식(이모지 얼굴, 좋아요/싫어요, 숫자 척도, NPS, 기존 별 칩)은 rating=<n>이 담긴 확인 링크의 나열입니다. 점수가 블록의 추가 질문 기준 이하이면 확인 페이지가 /v/[token]/followup으로 이어집니다.
퀴즈
퀴즈는 문제마다 라디오 버튼 그룹이 있는 양식으로 발송되어 q0, q1…(문제를 만든 순서상의 위치)을 /api/interactions로 보내며, 웹에서 답변하기 링크도 함께 붙습니다.
<div style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:700;font-size:18px;color:#111827">
Test your knowledge!
</p>
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
문제마다 라디오 버튼 그룹 하나와 "See my score" 버튼 -->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-quiz-1">Answer on the web</a>
</p>
</div>
채점은 서버에서 저장된 이메일의 정답으로 합니다. 클라이언트가 보낸 점수는 받아들이지 않습니다. 이벤트 값은 점수형 퀴즈에서 {answers, score, total, bucket}, 성격 유형 퀴즈에서 {answers, outcome, outcomeTitle}입니다. 정답 여부 바로 표시를 켜면 각 답의 레이블에 :checked 규칙이 보여 주는 숨은 메모가 들어가므로, 정답이 발송된 HTML에 포함됩니다. 표지 화면은 라이브 뷰에서 :target 앵커 뒤에 문제를 둡니다.
양식
한 페이지 양식은 모든 필드를 /api/interactions로 보내는 <form> 하나에 담고 웹에서 답변하기 링크를 붙여 발송합니다.
<div id="em-form-1" style="margin:12px 0;background-color:transparent">
<!-- <form method="post" action="https://mailinapp.com/api/interactions">:
모든 필드와 제출 버튼 하나 -->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-form-1">Answer on the web</a>
</p>
</div>
여러 페이지 양식은 필드를 보내지 않고, 시작 버튼 레이블이 붙은 버튼 모양 링크만 보내 /v/[token]/form/[blockId]의 설문 마법사로 안내합니다. 마법사에서는 페이지마다 초안을 저장하고(결과와 웹훅에 영향을 주지 않는 form-page 액션), 마지막 페이지의 submit이 초안을 응답으로 바꿉니다. 이메일에서 단계별로를 켜면 양식 앞에 페이지마다 라디오 버튼을 두고 :checked 규칙으로 한 페이지씩 보여 줍니다. 이 규칙을 지원하지 않는 앱에서는 모든 페이지가 보입니다. 파일은 브라우저에서만 추가할 수 있으므로 파일 필드는 라이브 뷰로 연결됩니다. 조건부 질문은 발송된 양식에 모두 표시되며, 수신자의 앞선 답 때문에 숨겨지는 질문의 답은 서버가 버립니다.
서버는 무엇이든 기록하기 전에 저장된 이메일의 양식과 대조해 각 답을 확인합니다. 잘못된 답을 보낸 브라우저는 /v/[token]?invalid=<fieldId>&why=<problem>으로 돌아가고, JSON 호출에는 400 invalid-answer가 반환됩니다.
쇼핑과 리뷰 블록
이 블록들의 링크는 /v/[token]/click을 거치며, 클릭을 기록한 뒤 목적지로 리디렉션합니다. 같은 서명 링크를 5분 안에 반복해도 한 번으로 셉니다.
카운트다운
카운트다운은 /api/countdown에서 불러오는 <img> 하나입니다. URL은 종료와 색상에 대해 서명되며, 불러올 때마다 남은 시간으로 60프레임(초당 1프레임)짜리 GIF를 새로 그리고 마지막 프레임에서 멈춥니다. 같은 서명 요청은 최대 10초 동안 렌더링을 공유합니다. alt 텍스트에는 스크린 리더와 이미지를 늦게 불러오는 앱을 위해 남은 시간이 글로 들어갑니다.
<div style="margin:12px 0">
<p style="margin:0 0 6px;font-size:16px;font-weight:700;color:#111827">Offer ends in</p>
<img src="https://mailinapp.com/api/countdown?t=1753401600000&c=111827&s=9f2a..."
width="207" height="34" alt="Offer ends in 2d 4h"
style="display:block;max-width:100%;height:auto">
</div>
연락처별 종료(발송 후 경과 시간 또는 연락처 데이터의 날짜)는 발송 때 계산되어 수신자 행에 countdown_ends_<blockId>로, 그리고 라이브 뷰 토큰에 저장되므로 열 때마다 같은 종료가 보입니다. 렌더링 시점에 이미 끝난 카운트다운은 이미지 대신 종료 메시지를 텍스트로 보냅니다. 클릭에는 수신자의 종료가 담기므로, 카운트다운 집계는 각 클릭을 그 수신자 자신의 마감 전후로 셉니다.
상품
MailInApp 체크아웃에서 지금 구매는 /v/[token]/act?action=buy로 가는 확인 링크입니다. 확인 페이지는 저장된 이메일에서 상품을 다시 읽고, 그 POST가 /api/checkout을 통해 Stripe Checkout 세션을 만듭니다. 단순한 GET은 아무것도 만들지 않습니다. 가격, 이름, 재고는 언제나 서버의 사본에서 가져옵니다. 주문은 Stripe의 서명된 웹훅으로만 결제 완료가 되며, 웹훅은 트랜잭션 안에서 재고를 다시 확인하고 재고를 넘는 결제는 환불합니다. 재고를 설정하면 카드에 /api/product-status의 재고 배지가 붙고, 결제된 수량으로 최대 1분에 한 번 다시 그려집니다.
<div id="em-product-1" style="margin:12px 0;padding:16px;border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Limited edition tote bag</p>
<p class="pd-price" style="margin:0 0 10px;font-weight:700;font-size:18px">$29.00</p>
<img src="https://mailinapp.com/api/product-status?p=proj123&b=product-1&s=..."
width="180" height="30" alt="" style="display:block;margin-bottom:8px">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Buy now
</a>
</div>
외부 스토어 체크아웃으로 가는 링크에서 지금 구매는 상품 페이지로 가는 클릭 링크(가져온 Shopify 옵션은 ?variant= 포함)이거나, 상품별 할인이 켜져 있으면 발송 때 만든 수신자 전용 할인 링크입니다.
옵션은 가격 앞에 옵션 값마다 숨겨진 라디오 버튼, 칩 줄(.pv-opts, 라디오 버튼을 가리키는 <label for>), 옵션마다 가격과 구매 링크가 있는 패널(.pv-panels)을 보냅니다. #<id>-a<i>:checked:not(:disabled) ~ … 형태의 규칙이 칩과 고른 옵션의 패널을 보여 주고 .pd-price와 .pv-list를 숨깁니다. 이 규칙이 적용되지 않는 곳에서는 가격과 .pv-list가 보입니다: 옵션마다 해당 옵션을 구매하는 링크(&variant=<variantId>)입니다. 추가 사진은 이미지 갤러리의 썸네일을 쓰고, 대체로 링크가 걸린 작은 사진을 보여 줍니다. 나중에 보기는 action=save 확인 링크이며, 수신자마다 한 번 기록됩니다.
<div class="pv-list">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=buy&variant=product-variant-2" ...>S / Navy · $56.00</a>
<a href="...&variant=product-variant-3" ...>L / Navy · $60.00</a>
</div>
<p style="margin:10px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=product-1&blockType=product&action=save">♡ Save for later</a>
</p>
상품 그리드
그리드는 카드의 표이며, 각 카드는 테두리가 있는 자신의 표입니다. 셀은 휴대폰에서 쌓입니다. 각 카드의 버튼은 카드 자신의 ID를 가진 클릭 링크(blockType=product-card)입니다. 가져온 카드의 가격과 기본 옵션은 렌더링 때 동기화된 카탈로그에서 읽습니다.
<td width="181" class="mia-stk" style="width:33%;vertical-align:top">
<table role="presentation" width="100%" style="border:1px solid #e5e7eb;border-radius:8px;background-color:#ffffff">
<tr><td style="padding:12px 12px 0;text-align:center">
<img src="https://shop.example.com/tee.jpg" alt="Linen tee" width="155" style="display:block;width:100%;height:auto">
<p style="margin:0 0 4px;font-weight:600;font-size:15px">Linen tee</p>
<p style="margin:0 0 10px;font-weight:700;font-size:15px">$28.00</p>
</td></tr>
<tr><td style="padding:0 12px 12px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=product-card-1&blockType=product-card&dest=https%3A%2F%2Fshop.example.com%2Fproducts%2Ftee&sig=..." ...>Shop now</a>
</td></tr>
</table>
</td>
장바구니에 담기가 켜져 있으면 장바구니 카드의 버튼은 대신 장바구니 페이지 /v/[token]/cart/[blockId]?add=<cardId>로 연결됩니다. 이 페이지와 라이브 뷰의 그리드는 고른 item ID와 qty_<cardId>를 /api/cart로 보내고, /api/cart는 저장된 이메일에서 카드와 스토어를 읽어 Shopify 장바구니 퍼머링크나 WooCommerce 결제 링크로 리디렉션합니다. 결제는 고른 카드와 수량을 값으로 가진 그리드 클릭으로 기록됩니다.
쿠폰
코드는 user-select:all이 적용된 상자 안의 일반 텍스트라서, 탭이나 더블클릭으로 전체가 선택됩니다. 스토어로 가는 버튼은 클릭 링크입니다. 라이브 뷰, 받은편지함, 앱에서는 상자가 코드를 복사하는 <button data-copy>가 됩니다.
<div style="background-color:#fff7ed;text-align:center">
<p style="margin:0 0 10px;font-size:15px;font-weight:700;color:#111827">Your exclusive discount</p>
<p style="display:inline-block;margin:0;padding:12px 24px;border:2px dashed #4f46e5;border-radius:8px;background-color:#ffffff;font-size:26px;font-weight:800;letter-spacing:3px;color:#4f46e5;-webkit-user-select:all;user-select:all">SAVE20</p>
<p style="margin:12px 0 0;font-size:13px;color:#6b7280">20% off until Sunday. Applied at checkout.</p>
</div>
병합 태그의 코드는 수신자마다 풀이되며, 비어 있으면 블록을 렌더링하지 않습니다.
스토어 리뷰
스토어 리뷰는 정적 텍스트입니다: 별은 aria-label이 붙은 문자이고, 각 리뷰 본문에는 dir="auto"가 붙습니다. 리뷰는 렌더링 때 동기화된 storeReviews에서 고르며, 이메일 트리에는 저장되지 않습니다. 상품 하나일 때 "모든 리뷰 보기" 링크는 상품 페이지로 가는 클릭 링크입니다.
<p style="margin:0 0 14px;font-size:15px;color:#111827">
<span role="img" aria-label="Rated 4.6 out of 5" style="color:#f59e0b">★★★★★</span> 4.6 from 212 reviews
</p>
<table role="presentation" width="100%">
<tr><td style="padding:0 0 14px;border-bottom:1px solid #e5e7eb">
<p style="margin:0 0 6px"><span role="img" aria-label="Rated 5.0 out of 5" style="color:#f59e0b">★★★★★</span></p>
<p dir="auto" style="margin:0 0 4px;font-weight:700">Bright and floral</p>
<p dir="auto" style="margin:0">Blueberry and jasmine notes, exactly as described.</p>
<p dir="auto" style="margin:6px 0 0;font-size:12px;color:#6b7280">Amira H. · Verified buyer · Nov 2, 2026</p>
</td></tr>
</table>
라이브 뷰, 받은편지함, GET /api/v1/liveview/[token]은 열 때마다 리뷰를 다시 읽습니다.
이벤트 블록
참석 여부와 회의 예약은 피드백 블록처럼 확인 링크로 기록합니다. 회의 링크의 참여 버튼과 웨비나 신청의 지금 등록 버튼은 쇼핑 블록의 링크처럼 /v/[token]/click을 거치는 클릭 링크입니다.
회의 링크
상태 줄("… 후 시작", 시작 후에는 "지금 진행 중")은 이메일을 렌더링할 때 쓰입니다. 그 아래의 /api/countdown <img>는 카운트다운 블록과 같은 방식으로 서명되어, 이메일을 열 때마다 남은 시간을 그립니다. 이메일에서 참여 버튼은 항상 활성 클릭 링크입니다.
<div style="margin:12px 0;text-align:left;background-color:transparent">
<p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">Starts in 2d 3h 30m</p>
<img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=..."
width="357" height="81" alt="Starts in 2d 3h 30m" style="display:inline-block;max-width:100%;height:auto;margin-bottom:8px">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=meeting-link-1&blockType=meeting-link&dest=https%3A%2F%2Fmeet.google.com%2Fabc-defg-hij&sig=..."
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Join on Google Meet
</a>
<p style="margin:8px 0 0;font-size:13px;color:#4b5563">Dial in: +1 555-0100, PIN 1234</p>
</div>
라이브 뷰, 받은편지함, 모바일 앱은 startsAt의 시작 전 참여 링크가 열리는 시간 분 전부터 참여 버튼을 보여 줍니다. 이는 렌더링할 때 블록의 속성으로 계산하며 저장된 상태는 없습니다. 그전에는 "시작 N분 전에 열려요"라는 비활성 칩을 보여 줍니다. startsAt이 없는 블록은 항상 열려 있습니다.
참석 여부
각 답은 response=yes, no, maybe를 담은 확인 링크입니다. 동반자 허용을 켜면 예는 라이브 뷰로 연결되고, 수신자는 그곳에서 동반자 수를 고릅니다. 참석 인원 표시는 /api/rsvp-count의 <img>를 더합니다. 블록, 색상, 너비별로 서명되며 수신자별 서명은 없고, 열 때 참석 여부 집계에서 그려집니다.
<div id="em-rsvp-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Coming to the launch?</p>
<p style="margin:0 0 10px;font-size:12px;color:#6b7280">Limited to 80 spots</p>
<img src="https://mailinapp.com/api/rsvp-count?p=proj123&b=rsvp-1&c=4f46e5&w=320&s=..."
alt="How many people are going" width="320" height="28" style="display:block;width:100%;max-width:320px;height:auto;border:0">
<div>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=yes" ...>Yes</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=maybe" ...>Maybe</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=rsvp-1&blockType=rsvp&action=rsvp&response=no" ...>No</a>
</div>
</div>
정원 확인과 수신자별 중복 제거는 하나의 Firestore 트랜잭션에서 실행되므로 자리가 초과 판매되는 일은 없습니다. 정원을 넘는 예는 waitlisted, 아니요는 declined, 미정은 자리를 차지하지 않는 maybe로 기록됩니다. 예라고 답한 뒤의 질문은 블록 ID에 __details를 붙인 대상으로 submit되며, 서버는 기록된 답이 예인 수신자에게서만 받아 양식의 답처럼 검증합니다.
회의 예약
시간은 예약 유형의 다음 빈 시간으로, 이메일을 렌더링할 때 계산되어 예약 유형의 시간대로 표기됩니다. 이메일에서 각 시간은 action=book&slot=<epoch ms>를 담은 확인 링크이고, 다른 시간 보기는 라이브 예약 페이지 /v/[token]/book/[blockId]를 엽니다.
<div id="em-booking-1" style="margin:12px 0;background-color:transparent">
<p style="margin:0 0 10px;font-weight:600;font-size:16px;color:#111827">Book a time with us</p>
<p style="margin:0 0 8px;font-size:13px;color:#6b7280">Times in Eastern Time</p>
<div class="bk-panels">
<div id="em-booking-1-g0" class="bk-p">
<p class="bk-dh" style="margin:6px 0 4px;font-size:12px;font-weight:600;color:#374151">Monday, January 19</p>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768831200000" ...>9:00 AM</a>
<a href="https://mailinapp.com/v/eyJhbGci.../act?blockId=booking-1&blockType=booking&action=book&slot=1768834800000" ...>10:00 AM</a>
</div>
</div>
<p style="margin:8px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci.../book/booking-1" style="color:inherit;text-decoration:underline">See more times</a>
</p>
</div>
날짜를 탭으로 표시를 켜면 날짜마다 숨긴 라디오(#<id>-d<i>)가 탭 막대(.bk-bar) 앞에 놓이고, #<id>-d<i>:checked:not(:disabled) ~ … 형태의 규칙이 하루치 패널(.bk-p)을 보여 줍니다. 이 규칙이 적용되지 않는 곳에서는 각 패널이 날짜 제목(.bk-dh) 아래에 표시됩니다. 라이브 뷰, 받은편지함, 앱에서는 시간이 하나의 양식 안의 라디오 칩이며, 고른 slot과 action=book을 /api/interactions로 보냅니다.
예약 전에 서버는 캘린더의 빈 시간을 다시 읽고 트랜잭션으로 시간을 확보하므로, 한 시간은 한 번만 예약됩니다. 수신자는 자신의 연락처로, 블록당 한 번 예약됩니다. 연락처가 없는 토큰은 예약 페이지로 보내지며, 그곳에서 봇 확인 후 이름과 이메일을 묻습니다.
웨비나 신청
카드는 어디서나 같습니다. 날짜는 블록의 시간대로 시간대 이름과 함께 표기되고, 지금 등록은 세션의 공개 페이지 /webinar/<liveSessionId>로 가는 클릭 링크입니다. 이 링크는 세션 ID로 만들어지며 발송 시 조회가 없습니다.
<div style="margin:12px 0;background-color:transparent">
<img src="https://example.com/webinar-cover.jpg" alt="Office hours"
style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px">
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Office hours</p>
<p style="margin:0 0 8px;font-size:13px;color:#6b7280">Mar 1, 2026, 12:00 PM EST</p>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=webinar-signup-1&blockType=webinar-signup&dest=https%3A%2F%2Fmailinapp.com%2Fwebinar%2Fsess_abc123&sig=..."
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
Register now
</a>
</div>
신청은 세션 페이지가 기록하므로, 블록 자체는 클릭만 기록합니다.
쇼케이스 블록
이 블록들은 답을 기록하지 않습니다. 각 블록은 그 자체로 잘 읽히는 형태로 내용을 보내고, 메일 앱이 실행할 수 있는 곳에서는 그것을 인터랙티브 버전으로 바꾸는 :checked 규칙을 더합니다. 규칙은 <head>의 <style>에 있고, 규칙이 기대는 입력 요소는 <!--[if !mso]><!-->로 감싸져 있어 클래식 Outlook에는 보이지 않습니다.
일곱 블록은 두 가지 형태로 쓰입니다.
- 라디오 그룹(캐러셀, 탭, 이미지 갤러리): 내용 앞에 슬라이드, 탭, 사진마다 숨은 라디오를 두고, 그 라디오를 가리키는
for레이블을 점, 탭 막대, 썸네일로 씁니다. 규칙은 모두#<radio>:checked:not(:disabled) ~ …형태입니다. 입력 요소를 없애는 앱에서는 어떤 규칙도 맞지 않아 대체 표시가 그대로 남습니다. - 체크박스 토글(아코디언, 전 / 후, 이미지 핫스팟, 메뉴): 블록 앞에 항상 체크된 게이트 체크박스
#<id>-k를 두고, 탭하는<label>안에 토글#<id>-t를 둡니다. 무언가를 숨기는 규칙은#<id>-k:checked에서 시작하므로, 게이트를 없애는 앱에서는 모든 것이 보입니다.
이 블록들의 링크는 다른 링크처럼 /v/[token]/click을 거칩니다.
캐러셀
각 슬라이드는 두 번 그려집니다. 한 번은 .carousel-fallback 안에(첫 슬라이드와 슬라이드 N개 모두 보기 링크, 또는 모든 슬라이드를 담은 .carousel-grid 표), 한 번은 라디오 규칙이 보여 주는 숨은 .lv-frame으로입니다. .lv-px 띠는 두 번째 이후 각 슬라이드의 규칙에서 슬라이드 조회 비콘 /v/[token]/nv/<blockId>/<slide>를 불러옵니다. 인사이트는 이것으로 첫 슬라이드를 넘어간 수신자를 셉니다.
<div id="em-carousel-g1">
<input type="radio" name="em-carousel-g1" id="em-carousel-g1-s0" checked hidden style="display:none">
<input type="radio" name="em-carousel-g1" id="em-carousel-g1-s1" hidden style="display:none">
<div class="carousel-fallback">
<div class="lv-frame lv-frame-0">
<img src="https://cdn.example.com/slide1.jpg" alt="Slide 1" style="width:100%">
<p style="margin:8px 0 0;font-size:14px;color:#374151">Slide 1</p>
</div>
<p style="margin:8px 0 0;font-size:13px">
<a href="https://mailinapp.com/v/eyJhbGci..." style="color:#4f46e5">See all 2 slides →</a>
</p>
</div>
<div class="lv-frames">
<div class="lv-frame lv-frame-0" style="display:none">…</div>
<div class="lv-frame lv-frame-1" style="display:none">…</div>
</div>
<div class="lv-dots" style="display:none;text-align:center">
<label for="em-carousel-g1-s0" class="lv-dot lv-dot-0" aria-label="Slide 1"></label>
<label for="em-carousel-g1-s1" class="lv-dot lv-dot-1" aria-label="Slide 2"></label>
</div>
<div class="lv-px" style="height:4px"> </div>
</div>
#em-carousel-g1-s1:checked:not(:disabled) ~ .carousel-fallback{display:none!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-dots{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-frames .lv-frame-1{display:block!important}
#em-carousel-g1-s1:checked:not(:disabled) ~ .lv-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../nv/carousel-g1/1)}
화살표는 각 프레임 안에서 이웃 라디오를 가리키는 for 레이블입니다. 썸네일은 점을 .lv-tn 레이블로 바꿉니다. 자동 재생은 처음에 체크되는 라디오를 하나 더 두며, 그 규칙이 @media (prefers-reduced-motion:no-preference) 안의 @keyframes 애니메이션으로 프레임을 .lv-track을 따라 움직입니다. 슬라이드를 고르면 그 체크가 풀립니다. 슬라이드의 가격과 버튼은 슬라이드의 일부라 대체 표시에도 나오며, 버튼은 슬라이드 자신의 href로 연결됩니다.
아코디언
각 항목의 내용은 토글 다음, 항목의 <label> 안에 있으므로 규칙이 실행되지 않는 곳에서는 그대로 보입니다. 라이브 뷰, 받은편지함, 캔버스에서는 각 항목이 네이티브 <details>/<summary>입니다.
<div id="em-accordion-item-g2" style="border:1px solid #e5e7eb;border-radius:6px;padding:10px 14px">
<input type="checkbox" id="em-accordion-item-g2-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-accordion-item-g2-t" hidden style="display:none">
<span style="display:block;font-weight:600;font-size:15px">Do you offer refunds?</span>
<div class="acc-content" style="margin:8px 0 0;font-size:14px">Yes, within 30 days of purchase.</div>
</label>
</div>
#em-accordion-item-g2-k:checked ~ label .acc-content{display:none}
#em-accordion-item-g2-t:checked ~ div.acc-content{display:block}
탭
각 탭의 블록은 한 번만 쓰이며, 탭 제목을 .tb-h 머리글로 시작하는 .tb-p 패널에 들어갑니다. 이렇게 쌓인 패널이 대체 표시입니다. 라디오 규칙이 .tb-bar를 보이고, 머리글을 숨기고, 패널 하나를 보여 줍니다.
<div id="em-tabs-g1">
<input type="radio" name="em-tabs-g1" id="em-tabs-g1-r0" checked hidden style="display:none">
<input type="radio" name="em-tabs-g1" id="em-tabs-g1-r1" hidden style="display:none">
<div class="tb-bar" role="tablist" style="display:none">
<label for="em-tabs-g1-r0" id="em-tabs-g1-t0" class="tb-t" role="tab">Overview</label>
<label for="em-tabs-g1-r1" id="em-tabs-g1-t1" class="tb-t" role="tab">Details</label>
</div>
<div class="tb-panels">
<div id="em-tabs-g1-p0" class="tb-p"><p class="tb-h" style="font-weight:700">Overview</p>…</div>
<div id="em-tabs-g1-p1" class="tb-p"><p class="tb-h" style="font-weight:700">Details</p>…</div>
</div>
</div>
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-bar{display:block!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-h{display:none!important}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels .tb-p{display:none}
#em-tabs-g1-r1:checked:not(:disabled) ~ .tb-panels #em-tabs-g1-p1{display:block!important}
전 / 후
두 사진은 하나의 <label> 안에 각각 레이블 아래에 들어갑니다. 게이트 규칙이 후 사진을 숨기고 힌트를 보이며, 토글이 두 사진을 바꿉니다.
<div id="em-before-after-g1">
<input type="checkbox" id="em-before-after-g1-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-before-after-g1-t" hidden aria-label="Switch between the before and after pictures" style="display:none">
<div class="ba-before">
<p class="ba-cap">Before</p>
<img src="https://example.com/kitchen-before.jpg" alt="Before: The kitchen" width="568">
<p class="ba-hint" style="display:none">Tap to see after</p>
</div>
<div class="ba-after" style="margin-top:12px">
<p class="ba-cap">After</p>
<img src="https://example.com/kitchen-after.jpg" alt="After: The kitchen" width="568">
<p class="ba-hint" style="display:none">Tap to see before</p>
</div>
</label>
</div>
#em-before-after-g1-k:checked ~ label .ba-after{display:none}
#em-before-after-g1-k:checked ~ label .ba-hint{display:block!important}
#em-before-after-g1-t:checked ~ div.ba-before{display:none}
#em-before-after-g1-t:checked ~ div.ba-after{display:block;margin-top:0!important}
이미지 핫스팟
핀 위치는 게이트 뒤의 규칙으로만 정하고, 인라인 position(Gmail이 없앰)은 쓰지 않습니다. 각 핀은 자신의 체크박스와 메모를 감싸는 <label>입니다. 사진 아래의 번호 .hs-legend가 대체 표시이며, 게이트 규칙이 그것을 숨깁니다.
<div id="em-image-hotspots-g4">
<input type="checkbox" id="em-image-hotspots-g4-k" checked hidden style="display:none">
<div class="hs-stage">
<img src="https://example.com/bike.jpg" alt="Our commuter bike" width="568">
<label id="em-image-hotspots-g4-h0" class="hs-pin" style="display:none">
<input type="checkbox" id="em-image-hotspots-g4-h0-t" hidden aria-label="Hydraulic brakes" style="display:none">
<span class="hs-num">1</span>
<span class="hs-note" style="display:none"><strong>Hydraulic brakes</strong>Stop short in the wet.</span>
</label>
</div>
<div class="hs-legend">
<p><strong>1. Hydraulic brakes</strong> — Stop short in the wet.</p>
</div>
</div>
#em-image-hotspots-g4-k:checked ~ div.hs-stage{position:relative}
#em-image-hotspots-g4-k:checked ~ div.hs-legend{display:none}
#em-image-hotspots-g4-k:checked ~ div.hs-stage #em-image-hotspots-g4-h0{display:block!important;position:absolute;left:20%;top:30%;margin:-13px 0 0 -13px}
#em-image-hotspots-g4-h0-t:checked ~ .hs-note{display:block!important;position:absolute;left:-8px;top:32px}
메모가 왼쪽·오른쪽, 위·아래 중 어느 쪽으로 열릴지는 핀 위치로 정해집니다(가로 60%, 세로 65%가 기준).
이미지 갤러리
첫 사진은 항상 .gl-main에 있고, 나머지는 그 안의 숨은 프레임입니다. .gl-fallback은 그 사진들을 작게 보여 주고 각각 라이브 뷰로 연결하며, 라디오 규칙이 그것을 레이블 줄 .gl-thumbs로 바꿉니다. 상품 블록의 추가 사진도 같은 부품으로 그려집니다.
<div id="em-image-gallery-g4">
<input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r0" checked hidden style="display:none">
<input type="radio" name="em-image-gallery-g4" id="em-image-gallery-g4-r1" hidden style="display:none">
<div class="gl-main">
<div id="em-image-gallery-g4-f0" class="gl-f"><img src="https://example.com/chair-front.jpg" alt="Chair from the front" width="568"></div>
<div id="em-image-gallery-g4-f1" class="gl-f" style="display:none"><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="568"></div>
</div>
<div class="gl-fallback">
<a href="https://mailinapp.com/v/eyJhbGci..."><img src="https://example.com/chair-side.jpg" alt="Chair from the side" width="64" height="64"></a>
</div>
<div class="gl-thumbs" style="display:none">
<label for="em-image-gallery-g4-r0" id="em-image-gallery-g4-t0" class="gl-t" aria-label="Picture 1">…</label>
<label for="em-image-gallery-g4-r1" id="em-image-gallery-g4-t1" class="gl-t" aria-label="Picture 2">…</label>
</div>
</div>
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-fallback{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-thumbs{display:block!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main .gl-f{display:none!important}
#em-image-gallery-g4-r1:checked:not(:disabled) ~ .gl-main #em-image-gallery-g4-f1{display:block!important}
메뉴
링크는 하나의 .mn-row에 놓이고, 각각 고유한 자리(blockType=menu-item)를 가진 클릭 링크라 인사이트가 링크마다 이름을 보여 줍니다. .mn-bar와 줄을 접는 규칙은 휴대폰에서이면 @media only screen and (max-width:620px) 안에, 항상이면 최상위에 있습니다.
<div id="em-menu-g5">
<input type="checkbox" id="em-menu-g5-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="checkbox" id="em-menu-g5-t" hidden aria-label="Show or hide the links" style="display:none">
<div class="mn-bar" style="display:none"><span class="mn-open">☰</span><span class="mn-close" style="display:none">✕</span> Menu</div>
<div class="mn-row" style="text-align:center">
<span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g1&blockType=menu-item&dest=https%3A%2F%2Fshop.example.com%2F&sig=...">Shop</a></span>
<span class="mn-sep" aria-hidden="true">|</span>
<span class="mn-i"><a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=menu-item-g2&blockType=menu-item&dest=https%3A%2F%2Fshop.example.com%2Fnew&sig=...">New in</a></span>
</div>
</label>
</div>
@media only screen and (max-width:620px){
#em-menu-g5-k:checked ~ label .mn-bar{display:block!important}
#em-menu-g5-k:checked ~ label .mn-row{display:none}
#em-menu-g5-t:checked ~ div.mn-row{display:block}
#em-menu-g5-t:checked ~ div.mn-row .mn-i{display:block!important}
#em-menu-g5-t:checked ~ div.mn-row .mn-sep{display:none}
}
게임 블록
세 게임은 같은 형태로 작성됩니다. 항상 체크된 게이트 체크박스 #<id>-k가 <label> 앞에 있고, 그 <label> 안에 라디오, 커버(.sc-surface, 또는 룰렛 .stw-wheel과 버튼 .stw-go), 경품(.sc-prize, .stw-prize)이 들어 있습니다. 게이트의 규칙이 커버를 보여 주고 경품을 숨깁니다. 레이블을 탭하면 라디오가 체크되고, 그 규칙이 커버를 숨기고 경품을 보여 줍니다.
체크박스가 아니라 라디오이므로, 두 번째 탭으로 경품이 다시 숨지 않습니다. 입력 요소는 <!--[if !mso]><!--> 안에 있고, 게이트를 제거하는 앱에서는 규칙 밖에 있는 것이 보입니다.
각 블록은 reveal을 기록합니다. 메일에서는 라디오의 규칙이 공개 비콘 /v/[token]/rv/<blockId>를 4px 띠(.sc-px, .stw-px)의 배경으로 불러오고, 라이브 뷰는 인라인 스크립트에서 공개를 보냅니다. 경품 링크는 /v/[token]/click을 거칩니다.
경품. game-prize 자식이 있으면, 서버가 이메일을 생성하기 전에 수신자별 경품을 고릅니다. 프로젝트, 블록, 수신자의 HMAC을 시드로 쓰는 가중 추첨이며, 결과는 코드와 함께 gamePrizes/{projectId}_{blockId}_{recipient}에 한 번만 기록됩니다. 결과는 수신자 행에 prize_<blockId>, prize_label_<blockId>, prize_code_<blockId>, prize_url_<blockId>로 실리므로, 메일, 라이브 뷰, 받은편지함, 앱이 같은 경품을 보여 줍니다.
이때 경품 패널은 인터랙티브 부분 안에만 있고, 라이브 뷰로 가는 내 경품 확인하기 링크(.stw-reveal, .sc-reveal)는 그 밖에 있으며 게이트의 규칙으로 숨겨집니다. 행에 결과 없이 생성된 이메일(내보내기, 실패한 할당)은 그 링크만 보여 주고, 경품은 라이브 뷰에서 할당됩니다. 공개 이벤트에는 기록된 경품이 실리며, 전송된 값은 쓰지 않습니다.
경품 룰렛
룰렛은 240px conic-gradient이며 경품마다 같은 크기의 칸이 있고, 다크 모드에서도 읽히도록 그림자가 있는 흰 글자로 레이블을 붙입니다. @keyframes가 3.2초 동안 수신자의 경품 각도까지 돌린 뒤 경품 패널이 서서히 나타납니다. 클래식 Outlook에는 공개 링크가 VML 버튼으로 전달됩니다.
<div id="em-spin-to-win-g5" style="text-align:center">
<p style="font-weight:700;font-size:18px">Spin for a summer treat</p>
<!--[if !mso]><!-->
<input type="checkbox" id="em-spin-to-win-g5-k" checked hidden style="display:none">
<label style="display:block;cursor:pointer">
<input type="radio" id="em-spin-to-win-g5-spin" hidden aria-label="Spin the wheel to reveal your prize" style="display:none">
<span class="stw-ptr" aria-hidden="true" style="display:none">▼</span>
<span class="stw-wheel" aria-hidden="true" style="display:none;width:240px;height:240px;border-radius:50%;
background:conic-gradient(#4f46e5 0deg 90deg,#847eed 90deg 180deg,#3b35ac 180deg 270deg,#f59e0b 270deg 360deg)">
<span style="position:absolute;transform:rotate(45deg)">10% off</span>
…
</span>
<span class="stw-go" style="display:none">Spin the wheel</span>
<div class="stw-prize" role="status" style="display:none">
<p style="font-weight:700">You won: 10% off!</p>
<p>Your next order is 10% off.</p>
<p aria-label="Your code" style="border:2px dashed currentColor;font-family:monospace">SPIN10-AB12</p>
</div>
<div class="stw-px" style="height:4px"> </div>
</label>
<!--<![endif]-->
<div class="stw-reveal">
<a href="https://mailinapp.com/v/eyJhbGci...">Reveal my prize</a>
</div>
</div>
#em-spin-to-win-g5-k:checked ~ label .stw-wheel{display:block!important}
#em-spin-to-win-g5-k:checked ~ label .stw-go{display:inline-block!important}
#em-spin-to-win-g5-k:checked ~ .stw-reveal{display:none!important}
#em-spin-to-win-g5-spin:checked ~ span.stw-wheel{animation:stw-em-spin-to-win-g5 3200ms cubic-bezier(.17,.67,.21,1) both}
#em-spin-to-win-g5-spin:checked ~ div.stw-prize{display:block!important;animation:stw-in-em-spin-to-win-g5 .4s ease-out 3200ms both}
#em-spin-to-win-g5-spin:checked ~ .stw-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/spin-to-win-g5)}
@keyframes stw-em-spin-to-win-g5{from{transform:rotate(0deg)}to{transform:rotate(2115deg)}}
경품이 없으면 룰렛은 64px 🎡이며, 0.9초 동안 두 바퀴 돌고 경품 링크로 가는 추적 버튼을 보여 줍니다. 같은 링크로 가는 두 번째 버튼 경품 확인하기는 인터랙티브 부분 밖에 있어 그 밖의 앱에 보입니다(경품 링크가 비어 있으면 라이브 뷰 링크). 라이브 뷰에는 제목과 경품 버튼이 보입니다.
스크래치 카드
경품이 없으면 경품이 인터랙티브 부분 밖에 있으므로, 규칙을 제거하는 앱에서는 바로 보입니다. 커버는 display:none인 <span>으로, 게이트의 규칙만 이를 보여 줍니다. 은색 줄무늬, 커버 색상, 또는 표지 이미지용 <img>(CSS url()은 쓰지 않음)입니다. 공개 버튼은 레이블 안에 .sc-go span을 추가합니다.
<div id="em-scratch-card-g1" style="text-align:center">
<p style="font-weight:700;font-size:18px">Scratch to reveal your prize!</p>
<!--[if !mso]><!-->
<input type="checkbox" id="em-scratch-card-g1-k" checked hidden style="display:none">
<!--<![endif]-->
<label style="display:block;cursor:pointer">
<!--[if !mso]><!-->
<input type="radio" id="em-scratch-card-g1-scratch" hidden aria-label="Scratch to reveal the hidden reward" style="display:none">
<span class="sc-surface" style="display:none;padding:24px;border-radius:8px;
background:repeating-linear-gradient(45deg,#9ca3af,#9ca3af 10px,#d1d5db 10px,#d1d5db 20px)">Scratch here</span>
<div class="sc-px" style="height:4px"> </div>
<!--<![endif]-->
<div class="sc-prize" style="margin-top:10px">
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=scratch-card-g1&blockType=scratch-card&dest=…&sig=…">🎉 20% off your next order!</a>
</div>
</label>
</div>
#em-scratch-card-g1-k:checked ~ label #em-scratch-card-g1-scratch{display:block!important;position:absolute;width:1px;height:1px;opacity:0}
#em-scratch-card-g1-k:checked ~ label .sc-surface{display:block!important}
#em-scratch-card-g1-k:checked ~ label .sc-prize{display:none!important}
#em-scratch-card-g1-scratch:checked ~ span.sc-surface{display:none!important}
#em-scratch-card-g1-scratch:checked ~ div.sc-prize{display:block!important}
#em-scratch-card-g1-scratch:focus ~ .sc-surface{outline:3px solid #4f46e5;outline-offset:2px}
#em-scratch-card-g1-scratch:checked ~ .sc-px{background-image:url(https://mailinapp.com/v/eyJhbGci.../rv/scratch-card-g1)}
게이트의 규칙이 라디오를 1px의 포커스 가능한 요소로 만들기 때문에, Tab으로 카드에 도달하고 스페이스 키로 공개할 수 있습니다. 카드 아래 버튼이면 추적 버튼이 </label> 뒤, 모든 규칙 밖에 있어 긁기 전후 모두 보입니다.
미스터리 박스
스크래치 카드와 같은 마크업과 규칙에, 커버만 선물 상자입니다. 72px 🎁(또는 상자 이미지)과 탭 안내 문구입니다. 닫혀 있는 동안 규칙 하나가 더 상자를 흔듭니다.
<label style="display:block;cursor:pointer">
<input type="radio" id="em-mystery-box-g1-scratch" hidden aria-label="Open the mystery box to reveal your prize" style="display:none">
<span class="sc-surface" style="display:none;padding:8px 0">
<span class="sc-box" aria-hidden="true" style="display:inline-block;font-size:72px">🎁</span>
<span style="display:block;font-weight:700">Tap the box to open it</span>
</span>
…
</label>
#em-mystery-box-g1-k:checked ~ label .sc-box{animation:mb-em-mystery-box-g1 2.4s ease-in-out infinite}
@keyframes mb-em-mystery-box-g1{0%,70%,100%{transform:rotate(0deg)}76%{transform:rotate(-8deg)}82%{transform:rotate(7deg)}88%{transform:rotate(-4deg)}94%{transform:rotate(2deg)}}
학습 블록
플래시카드 묶음은 아무것도 기록하지 않습니다. 과제는 수신자마다 제출 한 건을 기록합니다.
플래시카드 묶음
카드마다 전 / 후와 같은 형태입니다. 항상 체크된 게이트 체크박스 #<card>-k 다음에 <label>이 있고, 그 안에 카드 자신의 체크박스 #<card>-f, 앞면 .fc-front, 뒷면 .fc-back이 들어 있습니다. 게이트의 규칙이 뒷면과 면 레이블 .fc-l을 숨깁니다. 카드의 체크박스를 체크하면 앞면이 숨고 뒷면이 보입니다.
모든 규칙에 :checked가 들어 있으므로, 규칙을 버리는 앱은 앞면과 뒷면을 위아래로 보여 주고 뒷면은 점선 아래에 놓이며, 각 면은 레이블("질문: ", "답: ", 이메일 언어)로 시작합니다. 이미 레이블로 시작하는 카드는 레이블을 한 번만 씁니다. 앞면에만 이미지가 있는 카드는 뒤집혀도 높이 200px을 유지하므로, 독자의 손가락 아래에서 묶음이 움직이지 않습니다. 라이브 뷰도 같은 마크업을 그리며, 일반 텍스트 부분은 카드마다 두 줄로 씁니다.
<div id="em-flashcard-g2" style="border:1px solid #e5e7eb;border-radius:8px;padding:14px;margin-bottom:8px;text-align:center">
<!--[if !mso]><!-->
<input type="checkbox" id="em-flashcard-g2-k" checked hidden style="display:none">
<!--<![endif]-->
<label style="display:block;cursor:pointer">
<!--[if !mso]><!-->
<input type="checkbox" id="em-flashcard-g2-f" hidden style="display:none">
<!--<![endif]-->
<div class="fc-front">
<p style="margin:0;font-weight:600;font-size:16px"><span class="fc-l">Q: </span>What is the powerhouse of the cell?</p>
</div>
<div class="fc-back" style="margin-top:10px;padding-top:10px;border-top:1px dashed #e5e7eb">
<p style="margin:0;font-size:16px"><span class="fc-l">A: </span>The mitochondria</p>
</div>
</label>
</div>
#em-flashcard-g2-k:checked ~ label .fc-back{display:none}
#em-flashcard-g2-k:checked ~ label .fc-l{display:none}
#em-flashcard-g2-f:checked ~ div.fc-front{display:none}
#em-flashcard-g2-f:checked ~ div.fc-back{display:block;margin-top:0!important;padding-top:0!important;border-top:0!important}
과제
마감일은 카운트다운 블록의 이미지로, 기한에 맞춰 서명한 /api/countdown을 "마감" 줄 아래에 둡니다. 메일은 생성된 뒤에 읽히므로 남은 시간을 글로 쓰지 않으며, 이미지의 대체 텍스트는 "마감까지 남은 시간"입니다. 마감 뒤에 생성된 이메일에는 대신 "기한 지남"이 표시됩니다. 라이브 뷰는 남은 시간을 글로 씁니다("2일 4시간 10분 후 마감"). 자료 링크는 일반 링크이고, 배점은 제목에 "(10점)"을 붙입니다.
완료로 표시는 투표와 같은 선택지입니다. 메일에서는 /v/[token]/act?action=complete로 가는 링크 하나이며, 독자는 그곳에서 확인합니다. 짧은 텍스트나 링크로 답하는 방식은 <form>으로, action: "submit-answer"와 answer(세 줄 <textarea> 또는 <input type="url">)를 /api/interactions로 보냅니다. <!--[if !mso]> 안에 있으며, 그 아래에는 모든 앱에서 라이브 뷰(#em-<id>)로 가는 웹에서 답변하기 링크가 있습니다.
제출은 투표처럼 수신자마다 중복이 제거되고, 라이브 뷰가 이를 다시 읽어 "완료로 표시됨 ✓" 또는 답과 함께 "제출 완료 ✓"를 보여 줍니다. dueAt 이후의 제출도 다른 제출과 똑같이 기록되며, 인사이트는 제출 시각으로 기한 내인지 늦었는지 판단합니다(homeworkBlocks).
<div id="em-assignment-g2">
<p style="margin:0 0 4px;font-weight:700;font-size:18px">Read chapter 4 (10 pts)</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">Summarize the main themes in 2-3 sentences.</p>
<p style="margin:0 0 6px;font-size:13px;font-weight:600">Due</p>
<img src="https://mailinapp.com/api/countdown?t=1768663800000&c=111827&s=…" width="357" height="81"
alt="Time left before it's due" style="display:block;max-width:100%;height:auto;margin-bottom:8px">
<div style="margin:0 0 10px">
<p style="margin:0 0 4px;font-size:13px"><a href="https://example.com/ch4.pdf">Chapter 4 PDF</a></p>
</div>
<div>
<!--[if !mso]><!-->
<form method="post" action="https://mailinapp.com/api/interactions?campaignId=…&blockId=assignment-g2&redirect=…">
<!-- hidden campaignId, blockId, blockType, action=submit-answer, rcpt, redirect -->
<textarea name="answer" rows="3" placeholder="Your answer" required></textarea>
<button type="submit">Submit answer</button>
</form>
<!--<![endif]-->
<p style="margin:8px 0 0;font-size:13px;text-align:center">
<a href="https://mailinapp.com/v/eyJhbGci...#em-assignment-g2">Answer on the web</a>
</p>
</div>
</div>
콘텐츠 블록
이 블록들은 응답을 기록하지 않습니다. 동영상, 오디오, 장소, 캘린더에 추가는 클릭 슬롯입니다. 개인화된 발송에서는 각 링크가 /v/[token]/click?blockId=…&blockType=…&dest=…&sig=…를 거쳐 블록에 click을 기록하고 dest로 리디렉션합니다. 수신자 토큰이 없는 내보낸 이메일은 목적지로 바로 연결됩니다. 발송되는 마크업은 모든 메일 앱에서 같으며, 동영상과 오디오의 라이브 뷰만 다릅니다.
동영상 및 오디오
이메일은 클릭 링크 안에 이미지를 그립니다. 포스터나 커버를 설명을 alt로 둔 일반 <img>로 보여 주고, 이미지가 없으면 ▶ 또는 ♪, 설명, 동영상이라면 M:SS 형식의 길이가 담긴 어두운 패널을 그립니다. 블록의 너비, 안쪽 여백, 테두리, 배경은 바깥 <div>에 붙으므로 패널은 자체 여백을 유지합니다.
라이브 뷰와 MailInApp 받은편지함은 포스터를 poster로 둔 <video controls>, 또는 커버 <img> 아래의 <audio controls>를 그리며, 둘 다 설명을 aria-label로 씁니다. 모바일 앱은 파일을 엽니다. src가 없는 블록은 아무것도 출력하지 않습니다.
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=video-g1&blockType=video&dest=https%3A%2F%2Fexample.com%2Fpromo.mp4&sig=…">
<div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
<img src="https://example.com/promo-poster.jpg" alt="Product demo" style="display:block;width:100%;max-width:100%" />
</div>
</a>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=audio-g2&blockType=audio&dest=https%3A%2F%2Fexample.com%2Fno-cover.mp3&sig=…">
<div style="box-sizing:border-box;overflow:hidden;width:100%;max-width:100%">
<div style="background-color:#111827;color:#ffffff;text-align:center;padding:40px 16px;font-size:18px;font-weight:600">♪ Audio</div>
</div>
</a>
수식
수식은 GET /api/formula의 PNG입니다. 표기(300자로 자름), 표시 방식, 색상이 서명된 쿼리에 직렬화되므로 엔드포인트는 Firestore를 읽지 않고 변경 불가 캐시 헤더로 응답합니다. 전달은 엣지 워커가 맡습니다. 이미터는 수식을 한 번 배치해 <img>의 width와 height를 쓰므로 이메일이 로딩 중에 흔들리지 않고, 배치 과정에서 이미지 크기 한도에 맞도록 배율을 낮춥니다. alt는 표기 그 자체이며, 일반 텍스트 부분도 같습니다.
파서는 MailInApp 자체 구현입니다(TeX 엔진 없음). 알 수 없는 매크로는 글자 그대로 그려지고 렌더러는 예외를 던지지 않으므로, 수식 때문에 발송이 멈추는 일은 없습니다. \ce{…}는 원소 수를 아래 첨자로, 끝의 전하를 위 첨자로 바꾸고 ->를 화살표로 그립니다. 표기가 비어 있으면 아무것도 출력하지 않습니다. 이메일, 라이브 뷰, 받은편지함은 같은 이미지를 그리며, URL의 오리진만 다릅니다.
<div style="margin:8px 0;text-align:center">
<img src="https://mailinapp.com/api/formula?d=eyJub3RhdGlvbiI6…&s=…" width="385" height="91"
alt="x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}"
style="display:inline-block;max-width:100%;height:auto;vertical-align:middle" />
</div>
장소
사진, 이름, 주소는 일반 HTML이며, 주소의 줄바꿈은 그대로 유지됩니다. 길찾기 링크는 붙여 넣은 Google 지도 링크, 없으면 좌표가 0이 아니고 범위 안일 때 https://maps.google.com/?q=<lat>,<lng>, 그것도 없으면 https://maps.google.com/?q=<주소>입니다. Maps API 키는 쓰지 않습니다. 셋 다 없으면 버튼을 그리지 않습니다. 버튼은 모든 블록이 쓰는 방탄 버튼으로, 클래식 Outlook용 VML v:roundrect와 그 밖의 앱용 mso-hide:all이 붙은 <a>로 이루어지며, 둘 다 클릭 슬롯을 거칩니다.
<div style="margin:12px 0">
<img src="https://example.com/venue.jpg" alt="Grand Hall" style="width:100%;max-width:100%;border-radius:6px;display:block;margin-bottom:10px" />
<p style="margin:0 0 4px;font-weight:600;font-size:16px;color:#111827">Grand Hall</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">123 Main St, Springfield</p>
<!--[if mso]><v:roundrect href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&…" …><center>Get Directions</center></v:roundrect><![endif]-->
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=venue-g2&blockType=venue&dest=https%3A%2F%2Fmaps.google.com%2F%3Fq%3D123%2520Main%2520St%252C%2520Springfield&sig=…"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;mso-hide:all">Get Directions</a>
</div>
캘린더에 추가
세 버튼은 유효한 시작 시각이 있을 때만 그려집니다. 종료가 없거나 시작보다 이르면 시작 1시간 뒤가 됩니다. 제목, 설명, 장소는 링크를 만들기 전에 각각 200, 2,000, 300자로 잘리므로 세 링크는 항상 일치합니다. 세 버튼은 블록의 클릭 슬롯 하나를 함께 씁니다.
- .ics 다운로드는
GET /api/calendar이며, 이벤트 전체가 쿼리에 서명되어 있습니다(calendar:접두사를 붙인 입력에 대한 HMAC이므로 다른 서명 URL 계열은 여기서 검증되지 않고, Firestore도 읽지 않습니다).DTSTART/DTEND를 UTC 시점(끝에Z,VTIMEZONE없음)으로 둔 RFC 5545 파일을 보내므로, 모든 캘린더가 손님 자신의 시간으로 표시합니다.UID는 이벤트 필드의 SHA-256이라, 다시 저장하면 일정 하나가 업데이트됩니다. 텍스트는 §3.3.11에 따라 이스케이프하고, 줄은 75옥텟에서 접습니다. - Google Calendar에 추가는
calendar.google.com/calendar/render?action=TEMPLATE&…링크, Outlook.com에 추가는outlook.live.com/calendar/0/action/compose?…링크이며, 둘 다 렌더링할 때 만듭니다.
참석 응답 후에만 표시(afterRsvp)가 켜져 있으면 이메일은 아무것도 출력하지 않습니다. 라이브 뷰, 받은편지함, 모바일 앱은 수신자가 그 이메일에서 기록한 참석 여부가 confirmed가 되는 즉시 블록을 출력합니다. 서버 비밀 키가 없는 스튜디오 캔버스는 .ics 버튼을 # 링크로 그립니다.
<div style="margin:12px 0">
<p style="margin:0 0 8px;font-weight:600;font-size:16px;color:#111827">Q3 Product Launch, Webinar</p>
<p style="margin:0 0 10px;font-size:14px;color:#4b5563">Join us for the big reveal & Q&A.</p>
<a href="https://mailinapp.com/v/eyJhbGci.../click?blockId=add-to-calendar-g2&blockType=add-to-calendar&dest=https%3A%2F%2Fmailinapp.com%2Fapi%2Fcalendar%3Fd%3D…&sig=…"
style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;border-radius:6px;text-decoration:none;font-size:14px;font-weight:600;margin:0 8px 8px 0;mso-hide:all">Download .ics</a>
<!-- Add to Google Calendar and Add to Outlook.com follow, each through the same click slot -->
</div>
차트 블록
차트, KPI 카드, 순위표는 아무것도 기록하지 않으며 링크도 없습니다. 메일, 라이브 뷰, MailInApp 받은편지함은 같은 마크업을 쓰고, 이미지 URL의 출처만 다릅니다. 이 블록들이 더하는 말(표 머리글, 게이지 구간, 순위표 열, 모아 둔 기타)은 모두 이메일 언어의 emailBlocks.json chart.*와 standings.*에서 옵니다.
- 이미지. 각 차트와 KPI 카드의 스파크라인은
GET /api/analytics/chart?d=…&s=…&r=2가 돌려주는 PNG 한 장입니다.d는 차트 명세 전체(종류, 크기, 라벨, 값, 색상)를 base64url JSON으로 담고,s는LIVEVIEW_SECRET으로 만든 HMAC,r은 픽셀 비율입니다. 이 엔드포인트는 Firestore에서 아무것도 읽지 않으므로 응답은 서명된 쿼리만으로 정해지고 바뀌지 않는 캐시 헤더가 붙습니다. 그리기와 전달은 엣지 워커가 맡습니다. 6,000자를 넘거나 차트별 한도를 넘는 명세는 거부됩니다. 라벨은 서명 전에 명세의 라벨 길이로 잘립니다. - 이미지 옆의 텍스트.
<img>의alt는 차트 종류와 그린 값을 모두 나열합니다(“Bar chart: North (Revenue 12,400); …”). 게이지를 뺀 모든 차트는 그 뒤에 같은 수치의<table aria-label="<제목>">을 항상 보여 주고, 필요한 곳(여러 계열, 조각, 타일, 색 눈금)에는 범례를 붙입니다. 표는 이미지가 그린 것을 담지만, 생키 다이어그램의 표만은 입력한 모든 흐름을 담습니다. - 연동한 차트. KPI 카드와 막대·선·원형 차트는
binding을 받습니다. 데이터 소스 연동은 블록의filter(값에 수신자 병합 태그를 쓸 수 있음)를 거친 뒤, 연동한 행을groupByField로 묶고 계열마다 집계합니다(sum,avg,count,latest;src/lib/charts/aggregate.ts).@response:연동은 프로젝트의 결과 집계(src/lib/charts/responseSource.ts)를 읽습니다. 둘 다 렌더링할 때 정해지며, 메일에서는 발송할 때, 라이브 뷰에서는 불러올 때마다입니다. 수신자 태그가 든 필터는 수신자마다 다른 명세, 곧 수신자마다 다른 이미지 URL을 만듭니다. - 데이터가 없을 때. 쓸 수 있는 행이 없는 차트는 이미지 대신 제목과 안내(
chart.emptyRows등)를 쓰므로, 만들다 만 블록이 발송을 멈추는 일은 없습니다.
| 차트 | 표의 열 | 한도 |
|---|---|---|
| 막대, 선, 방사형 | 범주, 이어서 이름 있는 계열마다 한 열 | 범주 24개, 계열 3개. 방사형은 축 3~8개 |
| 원형, 트리맵 | 범주, 값, 비율 | 조각 8개: 큰 7개와 기타 |
| 분산형 | 계열, X, Y, 버블 차트에서는 크기 | 점 120개, 계열 8개 |
| 히스토그램 | 구간, 개수 | 값 500개, 구간 2~20개 |
| 히트맵 | 행, 열, 값(입력한 칸만) | 12행 × 24열 |
| 퍼널 | 단계, 값, 첫 단계 대비 %, 이전 단계 대비 % | 8단계 |
| 폭포 | 레이블, 값, 유형, 누계 | 막대 8개 |
| 생키 | 출발, 도착, 값 | 노드 12개, 연결 24개 |
한도를 넘는 행은 빠지며 합쳐지지 않습니다. 예외는 원형 차트와 트리맵의 가장 작은 조각입니다. 퍼널과 폭포는 입력한 순서를 지키는데, 그 순서가 곧 의미이기 때문입니다.
표가 있는 차트
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 8px;font-weight:600;font-size:15px;color:#111827">Revenue by region</p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiYmFyIi…&s=Ev3iTLfo…&r=2" width="560" height="280"
alt="Bar chart: North (Revenue 12,400); South (Revenue 9,800); East (Revenue 14,200)"
style="display:block;max-width:100%;height:auto;margin:8px 0" />
<table aria-label="Revenue by region" style="width:100%;border-collapse:collapse;margin-top:4px">
<tr><th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Category</th>
<th scope="col" style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280;font-weight:600">Revenue</th></tr>
<tr><td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">North</td>
<td style="text-align:left;padding:4px 8px;font-size:12px;color:#6b7280">12,400</td></tr>
<!-- one row per category -->
</table>
</div>
KPI 카드
라벨, 값(숫자, 미국 달러, 백분율 형식), 변화는 텍스트입니다. 변화는 previousValue와 trendDirection이 모두 있을 때만 보입니다. 비율은 두 값으로 계산하고, 화살표와 상태 색(상승 초록, 하락 빨강, 유지 호박색)은 입력한 방향을 따릅니다. 스파크라인 이미지는 점이 두 개 이상 필요하고 최대 60개까지 받으며, 색은 화살표를 따릅니다. 흐린 한 줄이 스크린 리더와 텍스트 버전을 위해 결과를 텍스트로 되풀이합니다.
GET /api/v1/liveview/[token]은 메일과 같은 kpiDisplay/gaugeDisplay로 계산한 이 말들을 모바일 앱에 추가 props로 넘깁니다(attachChartImageUrls, src/lib/liveview/chartImages.ts): displayValue, displayChange/displayChangeColor 또는 displayStatus/displayStatusColor, displaySummary, 숫자가 없는 게이지에는 displayNotice. 그 밖의 차트는 같은 마크업에서 읽은 항상 보이는 표를 chartTable(JSON {headers, rows})로 받습니다.
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Monthly revenue</p>
<p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">$48,210 <span style="font-size:14px;font-weight:600;color:#16a34a">▲ +17.6%</span></p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoic3BhcmtsaW5lIi…&s=…&r=2" width="160" height="40"
alt="Trend sparkline, upward: 10, 14, 12, 18, 22, 27" style="display:block;max-width:100%;height:auto;margin:4px 0" />
<p style="margin:4px 0 0;font-size:11px;color:#6b7280">Monthly revenue — $48,210 — ▲ +17.6% vs previous</p>
</div>
게이지 차트
게이지는 표가 없는 유일한 차트로, 값과 구간은 계기판 옆의 텍스트입니다. 구간은 오름차순입니다. 기본적으로 구간은 오름차순입니다. value <= goodMax는 양호, <= warningMax는 주의, 그 밖은 심각이며 테마의 상태 색으로 그려집니다. higherIsBetter에서는 value >= goodMin이 양호, >= warningMin이 주의, 그보다 낮으면 심각입니다. 이미지는 여전히 오름차순 띠 세 개를 그리므로(src/lib/charts/gauge.ts의 gaugeSpecBands가 warningMin과 goodMin을 양호·심각 색을 바꾸어 넘김) 서명된 형식은 그대로입니다. 세 props에는 기본값이 없어, 이것이 없는 게이지는 전과 같이 발송됩니다. min >= max이거나 순서가 뒤바뀐 경계값은 거부하지 않고 범위 안으로 맞춥니다. 숫자로 읽히지 않는 값(풀리지 않은 병합 태그 등)이면 계기판 대신 chart.emptyGauge를 씁니다.
<div style="margin:0;padding:0;background-color:#ffffff">
<p style="margin:0 0 4px;font-weight:600;font-size:13px;color:#6b7280">Score</p>
<p style="margin:0 0 6px;font-weight:700;font-size:32px;color:#111827">72 <span style="font-size:14px;font-weight:600;color:#d97706">Warning</span></p>
<img src="https://mailinapp.com/api/analytics/chart?d=eyJ0eXBlIjoiZ2F1Z2Ui…&s=…&r=2" width="320" height="200"
alt="Gauge: 72 of 0–100 (Warning)" style="display:block;max-width:100%;height:auto;margin:8px 0" />
<p style="margin:4px 0 0;font-size:11px;color:#6b7280">Score — 72 (Warning) — scale 0–100</p>
</div>
순위표
이미지 없는 평범한 <table>입니다. 행은 안정 정렬로 승점이 높은 순서대로 놓이므로 동점 팀은 입력한 순서를 지키고, 1~3위에는 🥇🥈🥉이 붙습니다. showDraws: false는 머리글과 모든 행에서 무승부 열을 뺍니다. highlightTeamName은 대소문자를 가리지 않고 팀을 찾아 그 행을 굵게 하고 색을 칠합니다. 팀이 없으면 standings.empty를 씁니다.
<table aria-label="Standings" style="width:100%;border-collapse:collapse">
<tr><th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">#</th>
<th scope="col" style="text-align:left;padding:4px 8px;font-weight:600">Team</th>
<!-- P, W, D, L, PF, PA -->
<th scope="col" style="padding:4px 8px;text-align:right;font-weight:600">Pts</th></tr>
<tr><td style="text-align:left;padding:4px 8px">🥇 1</td>
<td style="text-align:left;padding:4px 8px">Eagles</td>
<!-- 10, 7, 2, 1, 24, 10 -->
<td style="padding:4px 8px;text-align:right">23</td></tr>
</table>