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로 자리를 맞춘다.

점검

  • 휴대폰 폭에서 한 글자만 다음 줄로 넘어가는 제목이 없는가
  • 가로로 넘치는 긴 주소나 코드가 없는가
  • 어두운 화면에서 본문 글자가 너무 밝거나 흐리지 않은가

웹과 검색의 다른 스킬

이런 스킬도 있으면 좋겠다 싶으면 알려 주세요

기술 라이브러리

혼자 공부한 것을 정리해 두는 개발자의 서재예요. 예제는 직접 돌려 보고 씁니다.

© 2026 기술 라이브러리