글자의 폭과 번들 글꼴: 같은 글자가 기기마다 다른 폭으로 재어지는 까닭
2026-10-13에 아키텍처를 짜기 전에 글자 폭을 재는 스파이크를 하며 나온 것을 정리한다. 결정은 ADR-0026에, 잰 페이지는 sketchbook의 “글자 폭 스파이크”에 있다.
왜 글자의 폭이 문제인가
NS 차트의 블록은 그 안의 글자가 들어갈 만큼만 넓다. 그래서 그림을 그리려면 글자가 몇 px인지 먼저 알아야 한다. 백엔드로 치면 “응답의 길이를 알아야 버퍼를 잡는다”와 같다. 그런데 이 길이가 받는 쪽의 사정에 따라 달라진다.
글자의 폭은 글꼴 파일에 적혀 있다
글꼴 파일(.ttf, .woff2)은 글자마다 두 가지를 갖고 있다: 글자의 모양(윤곽선)과 그 글자가 차지하는 폭(advance width). 폭은 글꼴 안의 단위로 적혀 있고, 글자 크기에 맞춰 px로 바꾼다.
px 폭 = 글꼴 안의 폭 × 글자 크기 ÷ unitsPerEm
Pretendard는 unitsPerEm이 2048이다. 한의 폭이 1770이면 13px 글자에서 1770 × 13 ÷ 2048 = 11.235px이다. 글자열의 폭은 이것을 글자마다 더한 값이다.
기기마다 달라지는 까닭 셋
| 까닭 | 얼마나 | 스파이크에서 본 것 |
|---|---|---|
| 글꼴이 다르다. 페이지가 “맑은 고딕”을 달라고 해도 휴대폰에는 그 글꼴이 없어 다른 글꼴로 그린다 | 한 줄에 수십 px | 같은 줄이 Windows와 Android에서 33px 달랐다 |
커닝. 글꼴은 AV처럼 붙여야 고른 글자 짝의 사이를 좁히는 표를 따로 갖고 있다. 글자마다의 폭을 더한 값과 어긋난다 | 낱말에 따라 0~8px | AVATAR To WAVE에서 8px |
| 맞추는 단위. 브라우저는 폭을 화면의 점에 맞춰 조금씩 끊는다. 화면 배율이 다르면 끊는 단위가 다르다 | 0.1px 안쪽 | Windows는 1/64px, 휴대폰(배율 2.8)은 1/180px |
번들: 글꼴을 우리가 들고 간다
글꼴 파일을 프로그램에 함께 싣는 것을 번들이라고 한다. 그러면 첫째 까닭이 사라진다. 어느 기기에서나 같은 글꼴로 그린다.
번들에는 덤이 하나 있다. 글꼴 파일이 손에 있으므로 브라우저에 “이 글자 몇 px이야?”라고 묻지 않고 직접 셈할 수 있다. 위의 식을 그대로 쓰면 된다. 셋째 까닭(맞추는 단위)은 브라우저에 물을 때만 생기므로, 셈하면 이것도 사라진다. 둘째 까닭은 커닝을 끄고 그리면 사라진다(font-kerning: none).
셈으로 얻은 폭은 화면이 없는 곳(Node)에서도 똑같이 나온다. 그래서 레이아웃을 시험하기가 쉬워진다.
그런데 저장된 그림은 다른 곳에서 열린다
편집기 안에서는 번들 글꼴로 그리니 맞는다. 하지만 저장한 SVG는 Obsidian의 노트나 GitHub에서 그림으로 열리고, 거기에는 우리 글꼴이 없다. 다른 글꼴로 그려져 글자가 칸을 넘치거나 남는다.
푸는 길은 그림 파일 안에 글꼴을 넣어 주는 것이다. SVG는 글꼴 파일을 글자(base64)로 바꿔 자기 안에 품을 수 있다. 다만 글꼴을 통째로 넣으면 그림마다 수백 KB가 붙으므로, 그 그림에 쓰인 글자만 추려서(subset) 넣는다.
- 글자 41종을 추리면 12 KB, 서로 다른 한글이 수백 자면 200 KB를 넘는다
- 추리는 일은 harfbuzz라는 글꼴 라이브러리가 한다. 브라우저에서도 돌게 wasm으로 만든 판이 있다(652 KB). 한 번에 10ms쯤 걸린다
- 같은 글자들에서는 늘 같은 바이트가 나온다. 그래서 “같은 문서는 어디서 저장해도 같은 파일”이 지켜진다
브라우저는 기기에 깔린 글꼴의 파일을 읽을 수 없다. 그래서 번들하지 않으면 이 길 자체가 없다. 번들은 “다른 곳에서도 같게 보이기”의 전제다.
글꼴에 없는 글자
번들 글꼴에 없는 글자는 브라우저가 기기의 다른 글꼴에서 찾아 그린다. 그 글자의 폭은 다시 기기를 따른다. 스파이크에서는 접기 영역의 ▾가 Pretendard에 없어서, 그 한 글자로 6px이 달랐다. 편집기가 그림에 적는 기호는 번들 글꼴에 있는 것만 쓰거나 도형으로 그려야 한다.
글꼴마다 갖춘 문자가 다르다 (2026-10-25)
번들한 글꼴에 없는 글자는 폭을 셀 수 없으니, 어느 문자를 갖춘 글꼴인가가 글꼴 고르기의 기준이 됩니다. 사용자를 한국어 사용자로 국한하지 않기로 해서(메인테이너) 후보 다섯을 재 보았습니다(journal/assets/2026-10-25-font-candidates-measure.py).
| 글꼴 | 라틴 확장 (é ü č) | 그리스 · 키릴 | 가나 | 한자 |
|---|---|---|---|---|
| IBM Plex Sans KR | é도 없음 | 없음 | 없음 | 없음 |
| Pretendard | 거의 모두 | 거의 모두 | 거의 모두 | 없음 |
| Noto Sans KR | 일부 | 일부 | 거의 모두 | 8,138자 |
| 나눔고딕 | 일부 | 일부 | 대부분 | 4,620자 |
| D2Coding (고른 것) | 서유럽 · 동유럽 모두 | 대부분 | 대부분 | 4,620자 |
- 이름에
KR이 붙은 판은 한국어용으로 줄인 판이라 라틴 확장을 뺀 경우가 있습니다. - 한글 11,172자를 다 실으면 woff2로 400~600 KB입니다. 한자는 많고(수천 자) 나라마다 모양이 달라, 한 글꼴에 넣기보다 그 언어의 글꼴을 따로 두는 편이 낫습니다.
- 사용자가 글꼴을 고르게 하려면: 번들한 글꼴 몇 개 가운데 문서마다 고르게 하는 것은 작은 변경입니다(문서 설정에 글꼴 이름 하나, 글꼴마다 폭 표). 기기에 깔린 아무 글꼴이나 고르게 하는 것은 큰 변경입니다. 브라우저는 기기의 글꼴 파일을 읽을 수 없어 폭을 셀 수도, 그림에 넣을 수도 없습니다. 그리고 글꼴은 보는 사람의 설정이 아니라 문서의 설정이어야 합니다. 보는 사람마다 다르면 같은 파일이 사람마다 다른 그림으로 저장됩니다.
wasm이란
WebAssembly. C나 Rust로 쓴 프로그램을 브라우저와 Node에서 돌릴 수 있게 만든 실행 파일이다. harfbuzz는 C++로 쓴 라이브러리인데, wasm으로 만든 판이 있어서 JavaScript에서 함수처럼 부른다. 백엔드의 JNI나 네이티브 확장과 비슷한 자리다.
스파이크에서 익힌 것
- 게시된 페이지는 저장소의 파일과 다른 틀에서 돈다. claude.ai는 페이지 앞에 자기 스타일 묶음을 하나 붙인다. “첫 번째
<style>”을 찾던 스크립트가 거기서 틀렸다. 게시된 것과 같은 틀로 감싼 사본을 열어 확인해야 한다 - 지문에는 견주려는 것만 넣는다. 번들 글꼴의 지문에 글꼴에 없는 글자의 줄이 섞여 있어 기기마다 달라졌다
- 견줄 때의 기준은 재는 도구의 단위보다 넓게 잡는다. Chrome이 1/64px(0.016px) 단위로 끊는데 기준을 0.01px로 잡아 “다름”이 떴다
관련: pixel-aligned-lines (화면의 점에 맞추는 문제), model-layout-render-theme (레이아웃이 어디에 있는가), logo-and-icon-assets (글자를 윤곽선으로 바꾸기)