Typography
제목, 본문, 강조, 말줄임 등 텍스트 표현을 위한 타이포그래피 컴포넌트입니다.
제목
typo_title-1 ~ typo_title-5 클래스로 5단계 제목 스케일을 적용합니다. 시맨틱 heading 태그와 함께 사용합니다.
h1. 제목 레벨 1
h2. 제목 레벨 2
h3. 제목 레벨 3
h4. 제목 레벨 4
h5. 제목 레벨 5
<div class="typo_stack-lg">
<h1 class="typo_title-1">h1. 제목 레벨 1</h1>
<h2 class="typo_title-2">h2. 제목 레벨 2</h2>
<h3 class="typo_title-3">h3. 제목 레벨 3</h3>
<h4 class="typo_title-4">h4. 제목 레벨 4</h4>
<h5 class="typo_title-5">h5. 제목 레벨 5</h5>
</div>
본문
기본 본문은 별도 클래스 없이 p 태그를 사용합니다. 단락 간격이 필요하면 typo_paragraph를 사용합니다.
기본 본문 텍스트입니다. 인라인으로 보조 설명을 함께 쓸 수 있습니다.
typo_paragraph — 첫 번째 단락입니다. 단락 사이에 일정한 간격이 적용됩니다.
두 번째 단락입니다. 마지막 단락은 하단 여백이 제거됩니다.
<!-- Muted -->
<p>기본 본문 텍스트입니다. 인라인으로 <span class="color_muted">보조 설명</span>을 함께 쓸 수 있습니다.</p>
<!-- typo_paragraph -->
<div>
<p class="typo_paragraph">typo_paragraph — 첫 번째 단락입니다. 단락 사이에 일정한 간격이 적용됩니다.</p>
<p class="typo_paragraph">두 번째 단락입니다. 마지막 단락은 하단 여백이 제거됩니다.</p>
</div>
색상 타입
color_muted, color_success 등 공통 색상 클래스를 적용합니다. 버튼·배지·알림 등 모든 컴포넌트에서 동일한 클래스명을 사용합니다.
기본 텍스트 (Default)
보조 텍스트 (Muted)
성공 메시지 (Success)
주의 메시지 (Warning)
오류 메시지 (Danger)
강조 텍스트 (Primary)
<!-- 기본 텍스트 (Default) -->
<p class="color_default">기본 텍스트 (Default)</p>
<!-- 보조 텍스트 (Muted) -->
<p class="color_muted">보조 텍스트 (Muted)</p>
<!-- 성공 메시지 (Success) -->
<p class="color_success">성공 메시지 (Success)</p>
<!-- 주의 메시지 (Warning) -->
<p class="color_warning">주의 메시지 (Warning)</p>
<!-- 오류 메시지 (Danger) -->
<p class="color_danger">오류 메시지 (Danger)</p>
<!-- 강조 텍스트 (Primary) -->
<p class="color_primary">강조 텍스트 (Primary)</p>
크기
base(0.875rem)는 클래스 없이 기본 적용됩니다. xs, sm, lg, xl만 size_* 클래스를 사용합니다.
Extra Small — 0.75rem
Small — 0.8125rem
Base — 0.875rem (기본)
Large — 1rem
Extra Large — 1.125rem
<!-- Extra Small — 0.75rem -->
<p class="size_xs">Extra Small — 0.75rem</p>
<!-- Small — 0.8125rem -->
<p class="size_sm">Small — 0.8125rem</p>
<!-- Base — 0.875rem (기본) -->
<p>Base — 0.875rem (기본)</p>
<!-- Large — 1rem -->
<p class="size_lg">Large — 1rem</p>
<!-- Extra Large — 1.125rem -->
<p class="size_xl">Extra Large — 1.125rem</p>
텍스트 스타일
strong · em · del · mark 등 의미 있는 태그와 밑줄·인라인 코드 스타일을 조합합니다.
굵은 텍스트와
기울임 텍스트,
밑줄 텍스트,
취소선 텍스트를 함께 사용할 수 있습니다.
형광펜 강조와
inline code 표현도 지원합니다.
조합 예시:
중요 경고,
강조 설명,
삭제된 항목
<!-- typo_strong -->
<p>
<strong class="typo_strong">굵은 텍스트</strong>와
<em class="typo_italic">기울임 텍스트</em>,
<span class="typo_underline">밑줄 텍스트</span>,
<del class="typo_delete">취소선 텍스트</del>를 함께 사용할 수 있습니다.
</p>
<!-- typo_mark -->
<p>
<mark class="typo_mark">형광펜 강조</mark>와
<code class="typo_code">inline code</code> 표현도 지원합니다.
</p>
<!-- Muted -->
<p class="color_muted">
조합 예시:
<strong class="typo_strong color_danger">중요 경고</strong>,
<em class="typo_italic color_primary">강조 설명</em>,
<del class="typo_delete color_muted">삭제된 항목</del>
</p>
아래첨자 · 위첨자 · 소문자
sub · sup · small 시맨틱 태그에 typo_sub · typo_sup · typo_small 클래스를 적용합니다.
화학식 H2O, 수식 x2 + y2 = z2처럼 아래·위첨자를 표현합니다.
각주1나 제곱미터 m2 단위에도 활용합니다.
※ 본 안내는 참고용이며, 법적 효력은 약관을 따릅니다.
<!-- typo_sub -->
<p>
화학식 H<sub class="typo_sub">2</sub>O,
수식 x<sup class="typo_sup">2</sup> + y<sup class="typo_sup">2</sup> = z<sup class="typo_sup">2</sup>처럼
아래·위첨자를 표현합니다.
</p>
<!-- typo_sup -->
<p>
각주<sup class="typo_sup">1</sup>나
제곱미터 m<sup class="typo_sup">2</sup> 단위에도 활용합니다.
</p>
<!-- typo_small -->
<p>
<small class="typo_small">※ 본 안내는 참고용이며, 법적 효력은 약관을 따릅니다.</small>
</p>
말줄임
text_ellipsis로 1줄, text_ellipsis-2·3으로 여러 줄 말줄임을 적용합니다. 부모에 너비 제한이 필요합니다.
1줄 말줄임 — 긴 텍스트가 영역을 넘으면 말줄임표로 표시됩니다. Lorem ipsum dolor sit amet.
2줄 말줄임 — 두 줄까지 표시한 뒤 넘치는 내용은 말줄임표로 처리합니다. UXKM 가이드는 컴포넌트 문서와 데모를 제공합니다.
3줄 말줄임 — 세 줄까지 표시합니다. 디자인 시스템의 타이포그래피는 일관된 위계와 가독성을 유지하는 데 중요한 역할을 합니다. 제목·본문·캡션의 크기와 색상을 체계적으로 정의하세요.
<div style="max-width: 320px; width: 100%;">
<p class="text_ellipsis">1줄 말줄임 — 긴 텍스트가 영역을 넘으면 말줄임표로 표시됩니다. Lorem ipsum dolor sit amet.</p>
<p class="text_ellipsis-2">2줄 말줄임 — 두 줄까지 표시한 뒤 넘치는 내용은 말줄임표로 처리합니다. UXKM 가이드는 컴포넌트 문서와 데모를 제공합니다.</p>
<p class="text_ellipsis-3">3줄 말줄임 — 세 줄까지 표시합니다. 디자인 시스템의 타이포그래피는 일관된 위계와 가독성을 유지하는 데 중요한 역할을 합니다. 제목·본문·캡션의 크기와 색상을 체계적으로 정의하세요.</p>
</div>
인용
blockquote 태그에 typo_blockquote 클래스를 적용합니다.
좋은 타이포그래피는 읽기 쉬운 콘텐츠의 기반입니다. 위계, 대비, 여백을 일관되게 유지하세요.
<blockquote class="typo_blockquote color_muted" cite="https://example.com">
좋은 타이포그래피는 읽기 쉬운 콘텐츠의 기반입니다. 위계, 대비, 여백을 일관되게 유지하세요.
</blockquote>
목록
본문 prose 목록은 ul · ol에 typo_list · typo_list-ordered 클래스를 적용합니다. UI 리스트(아바타, 인터랙티브 항목 등)는 List 컴포넌트를 사용하세요.
<!-- typo_list -->
<ul class="typo_list">
<li>디자인 토큰 정의</li>
<li>컴포넌트 문서화</li>
<li>접근성 검토</li>
</ul>
<!-- typo_list-ordered -->
<ol class="typo_list-ordered">
<li>요구사항 분석</li>
<li>와이어프레임 작성</li>
<li>프로토타입 검증</li>
</ol>
<!-- 예시 1 -->
<p class="form_field-hint">
용어 설명·구조화된 목록은 <a href="list.html#definition-heading">List — 정의 목록</a>을 참고하세요.
</p>
링크
본문 내 하이퍼링크에 typo_link 클래스를 사용합니다.
<p class="typo_paragraph">
자세한 내용은 <a href="../getting-started.html" class="typo_link">설치 및 사용</a>을 참고하세요.
<span class="color_muted">또는</span>
<a href="../design-tokens.html" class="typo_link size_sm">디자인 토큰</a>으로 이동할 수 있습니다.
</p>
리드 · 캡션 · 레이블
typo_lead · typo_caption · typo_label · typo_overline로 보조 텍스트 위계를 표현합니다.
가이드 소개
HTML Components
순수 HTML과 SCSS로 구성된 UI 컴포넌트 가이드입니다. 접근성과 일관성을 기준으로 설계되었습니다.
마지막 업데이트: 2026-07-31
가입 시 사용한 이메일 주소를 입력하세요.
<div style="max-width: 32rem; width: 100%;">
<div class="typo_stack-lg">
<p class="typo_overline">가이드 소개</p>
<h3 class="typo_title-3">HTML Components</h3>
<p class="typo_lead">순수 HTML과 SCSS로 구성된 UI 컴포넌트 가이드입니다. 접근성과 일관성을 기준으로 설계되었습니다.</p>
<p class="typo_caption">마지막 업데이트: 2026-07-31</p>
</div>
<div>
<label class="typo_label" for="demo-email">이메일</label>
<input
id="demo-email"
class="input"
type="email"
placeholder="name@example.com"
aria-describedby="demo-email-caption"
/>
<p id="demo-email-caption" class="typo_caption" style="margin-top: 0.25rem;">가입 시 사용한 이메일 주소를 입력하세요.</p>
</div>
</div>
제목 색상
제목에도 공통 color_* 클래스를 조합할 수 있습니다.
Primary 제목
Success 제목
Danger 제목
Muted 제목
<!-- typo_title-3 -->
<h3 class="typo_title-3 color_primary">Primary 제목</h3>
<!-- typo_title-3 -->
<h3 class="typo_title-3 color_success">Success 제목</h3>
<!-- typo_title-3 -->
<h3 class="typo_title-3 color_danger">Danger 제목</h3>
<!-- typo_title-3 -->
<h3 class="typo_title-3 color_muted">Muted 제목</h3>
키보드 · 코드 블록
typo_kbd · typo_pre · typo_code로 단축키와 코드를 표시합니다.
저장하려면 ⌘ + S를 누르세요. 검색은 Ctrl + K입니다.
<button class="btn btn_filled color_primary">
<span class="btn_label">저장</span>
</button>
<!-- typo_kbd -->
<p>
저장하려면 <kbd class="typo_kbd">⌘</kbd> + <kbd class="typo_kbd">S</kbd>를 누르세요.
검색은 <kbd class="typo_kbd">Ctrl</kbd> + <kbd class="typo_kbd">K</kbd>입니다.
</p>
<!-- typo_pre -->
<pre class="typo_pre">
<code><button class="btn btn_filled color_primary">
<span class="btn_label">저장</span>
</button></code>
</pre>
중첩 목록
typo_list · typo_list-ordered에 하위 ul · ol을 중첩할 수 있습니다.
- 레이아웃
- Container
- Grid
- 기본 요소
- Button
- Typography
<ul class="typo_list">
<li>레이아웃
<ul class="typo_list">
<li>Container</li>
<li>Grid</li>
</ul>
</li>
<li>기본 요소
<ul class="typo_list">
<li>Button</li>
<li>Typography</li>
</ul>
</li>
</ul>
제목 + 본문 조합
typo_stack, typo_stack-lg로 제목과 본문을 묶어 간격을 맞춥니다.
섹션 제목
typo_stack-lg는 제목과 본문 사이 간격을 넓게 유지합니다. 카드 헤더, 모달 제목, 폼 섹션 등에 활용합니다.
마지막 업데이트: 2026-07-31
작은 스택
typo_stack은 좁은 간격으로 제목·설명을 묶습니다.
<!-- typo_stack-lg -->
<div class="typo_stack-lg" style="max-width: 28rem;">
<h3 class="typo_title-3">섹션 제목</h3>
<p class="typo_paragraph">typo_stack-lg는 제목과 본문 사이 간격을 넓게 유지합니다. 카드 헤더, 모달 제목, 폼 섹션 등에 활용합니다.</p>
<p class="color_muted size_sm">마지막 업데이트: 2026-07-31</p>
</div>
<!-- typo_stack -->
<div class="typo_stack" style="max-width: 28rem;">
<h4 class="typo_title-4">작은 스택</h4>
<p class="color_muted">typo_stack은 좁은 간격으로 제목·설명을 묶습니다.</p>
</div>
클래스 · 속성
Nuxt와 Next 컴포넌트가 렌더하는 OOCSS 클래스입니다. HTML에서는 의미에 맞는 시맨틱 태그와 아래 클래스를 직접 조합합니다.
| 클래스 | 설명 |
|---|---|
typo_title-1 ~ typo_title-5 | 제목 스케일 |
typo_paragraph · typo_lead · typo_caption · typo_label · typo_overline | 본문·보조 텍스트 |
typo_strong · typo_italic · typo_underline · typo_delete · typo_mark | strong · em · span · del · mark 기반 인라인 강조 |
typo_sub · typo_sup · typo_small | 아래첨자·위첨자·보조 소문자 |
typo_link | 본문 안 인라인 링크 |
typo_code · typo_kbd · typo_pre | 인라인 코드·키보드 키·코드 블록 |
typo_blockquote | 인용 블록 |
typo_list · typo_list-ordered | 본문 prose 목록. 인터랙티브 UI 목록은 List 컴포넌트 사용 |
typo_stack · typo_stack-lg | 제목과 본문의 수직 간격 |
text_ellipsis · text_ellipsis-2 · text_ellipsis-3 | 1~3줄 말줄임 |
size_xs · size_sm · size_lg · size_xl | 텍스트 크기 |
color_default · color_muted · color_primary · color_success · color_warning · color_danger | 공통 색상 유틸리티 |
디자인 토큰
| 토큰 | 기본값 | 설명 |
|---|---|---|
--typo-title-1-size · … · --typo-title-5-size | 2.375rem · 1.875rem · 1.5rem · 1.25rem · 1rem | 제목 레벨별 크기 |
--typo-title-1-weight · … · --typo-title-5-weight | 700 · 700 · 600 · 600 · 600 | 제목 레벨별 굵기 |
--typo-title-1-line-height · … · --typo-title-5-line-height | 1.2 · 1.25 · 1.3 · 1.35 · 1.4 | 제목 레벨별 줄높이 |
--typo-title-1-letter-spacing · --typo-title-2-letter-spacing · --typo-title-3-letter-spacing | -0.02em · -0.015em · -0.01em | h1~h3 자간 |
--typo-text-line-height | 1.6 | 단락·목록·인용문 줄높이 |
--typo-paragraph-gap · --typo-list-gap | var(--space-md) · var(--space-xs) | 단락·목록 항목 간격 |
--typo-mark-bg | rgba(250, 219, 20, 0.35) | 형광펜 배경 |
--typo-code-padding-y · --typo-code-padding-x · --typo-code-radius | 0.1em · 0.35em · 4px | 인라인 코드·mark 패딩과 모서리 |
--typo-blockquote-border-width | 3px | 인용문 왼쪽 테두리 |
--typo-sub-sup-size · --typo-sub-offset · --typo-sup-offset | 0.75em · -0.25em · -0.5em | 아래·위첨자 크기와 오프셋 |
--typo-small-size | var(--text-size-sm) | small 태그 보조 텍스트 크기 |
--typo-lead-size · --typo-lead-line-height | var(--text-size-lg) · 1.6 | 리드 텍스트 |
--typo-caption-size · --typo-label-size · --typo-label-weight | var(--text-size-xs) · var(--text-size-sm) · 600 | 캡션·레이블 |
--typo-overline-size · --typo-overline-weight · --typo-overline-spacing | var(--text-size-xs) · 600 · 0.06em | 오버라인 텍스트 |
--typo-kbd-padding-y · --typo-kbd-padding-x | 0.15em · 0.4em | 키보드 키 패딩 |
--typo-pre-padding · --typo-pre-radius | var(--space-md) · var(--radius-md) | 코드 블록 |