korean-web-typography
웹에서 한국어 글자 다듬기
한국어 웹페이지의 줄바꿈, 줄 간격, 자간, 글꼴, 문단 폭을 한국어에 맞게 다듬어요.
2026년 11월 17일 추가한국어로 씀
까는 법
터미널에 붙여 넣으면 ~/.claude/skills/korean-web-typography/SKILL.md에 파일 하나가 받아져요. Claude Code를 다시 켜면 스킬 목록에 나타나요.
mkdir -p ~/.claude/skills/korean-web-typography && curl -fsSL https://beautifulsoup.dev/skill-files/korean-web-typography/SKILL.md -o ~/.claude/skills/korean-web-typography/SKILL.md
명령을 쓰기 어렵다면 아래 SKILL.md를 복사하거나 내려받아, 같은 위치에 korean-web-typography 폴더를 만들고 그 안에 넣어도 돼요. 한 프로젝트에서만 쓰려면 프로젝트 안의 .claude/skills/에 넣어요.
에이전트가 이 스킬을 꺼내는 때
한국어가 들어가는 웹페이지나 앱 화면의 글자 모양을 만들거나 고칠 때 쓴다. 한국어 줄이 낱말 중간에서 끊기거나, 글이 빽빽하거나, 영어 기준 글자 설정을 그대로 쓴 화면을 다듬을 때 쓴다.
SKILL.md 머리말의 설명이에요. 에이전트는 이 설명을 보고 언제 이 스킬을 쓸지 정해요. 이름을 직접 불러 써도 돼요.
SKILL.md
줄바꿈
- 한국어 본문과 제목에는
word-break: keep-all을 쓴다. 낱말 중간에서 줄이 끊기지 않는다. - 아주 긴 영어 낱말, 주소, 코드가 섞이는 곳에는
overflow-wrap: anywhere를 함께 써서 가로 넘침을 막는다. - 제목은
text-wrap: balance로 줄 길이를 고르게 한다(지원하지 않는 브라우저는 그냥 무시한다).
간격
- 한국어 본문 줄 간격은 영어보다 넉넉하게: 글자 크기의 1.6에서 1.8배.
- 본문 자간은 0에 가깝게 둔다. 큰 제목만 살짝 좁힌다(-0.02em 안팎).
- 한 줄 길이는 한국어 기준 35에서 45자 안팎이 읽기 좋다.
- 문단 사이 간격은 줄 간격보다 분명히 크게.
글꼴
- 한국어 글꼴을 먼저, 그다음 영어와 시스템 글꼴을 적는다.
- 웹 글꼴은 무게가 크다. 필요한 굵기만, 가능하면 나눠 받기(서브셋, unicode-range)로 쓴다.
- 굵기 단계는 셋 이하로.
문장부호와 숫자
- 영어식 긴 줄표 대신 쉼표, 괄호, 가운뎃점을 쓴다.
- 표 안의 숫자는
font-variant-numeric: tabular-nums로 자리를 맞춘다.
점검
- 휴대폰 폭에서 한 글자만 다음 줄로 넘어가는 제목이 없는가
- 가로로 넘치는 긴 주소나 코드가 없는가
- 어두운 화면에서 본문 글자가 너무 밝거나 흐리지 않은가
웹과 검색의 다른 스킬
이런 스킬도 있으면 좋겠다 싶으면 알려 주세요