시각 디자인

이 문서는

AriadneNSD가 어떻게 보이는가를 정한 명세입니다. 원칙, 디자인 토큰(색 · 타이포그래피 · 치수), 블록의 해부도, 상태마다의 모습, 테마, 렌더링 규칙, 접근성 검증을 담습니다.

  • 입력: 01-requirements의 핵심 원칙(주 사용자는 실무의 설계 문서 작성자), 3.3 레이아웃 · 렌더링, R-FMT-08, R-NFR-05, R-NFR-07. 결정의 근거는 DR-0003(기본 스타일), ADR-0018(화면 그대로 저장), ADR-0026(글꼴 번들)입니다.
  • 쌍이 되는 문서: 사용자와 조작의 원칙은 01-ux-overview, 무엇을 누르면 어떻게 되는지는 02-interaction-rules, 질문과 결정은 ux-decisions에 있습니다. 이 문서는 그 규칙이 어떤 모습으로 보이는지를 담당합니다. 색 · 선 굵기 · 글자 크기의 값은 이 문서에만 적고, 다른 문서는 이 문서를 가리킵니다.
  • 이 문서를 쓰는 곳: 렌더러의 테마 구조(3. SVG 렌더링), 편집기 화면(03-editor), 배포 대상마다의 테마 연동(5. 테마 연동).
  • 지금 상태: 초안입니다. MVP 코드(2026-11-01)가 이 문서를 따릅니다. 토큰은 이 문서의 이름 그대로 문서 레이어는 src/packages/core/src/render/theme.ts, 편집 레이어는 src/packages/editor/src/dom/overlay.ts에 있습니다. 테마 넷(밝은 · 어두운 · 고대비 · 흑백 인쇄)과 고대비 화면 색이 2026-11-03에 들어갔습니다(8장). 디자인 시스템 관점의 독립 검토를 두 번 받아, 대비와 레이어 구분을 수정하고 빠진 명세를 채웠습니다. MVP 범위의 모습은 모두 코드에 들어 있습니다. MVP 뒤의 기능 가운데 접기와 펴 보기의 모습은 2026-11-03에 코드에 들어왔습니다(7장). 명세와 지금 코드가 다른 곳이 생기면 11장에 적습니다.

읽는 법

  • 바쁘면 1장(원칙), 7장(상태 표), 10장(접근성 검증)을 보세요.
  • 그림은 화면에서 찍거나 스크립트로 그린 것입니다: journal/assets/2026-11-18-visual-design-marks.test.ts(7.2의 문서 레이어 그림, 앱의 렌더러로 그림), 2026-11-01-docs-shots.mjs(그 밖의 화면, 프로토타입에서 찍어 글꼴과 세부가 MVP와 다를 수 있음), 2026-10-17-color-check.py(대비 · 색각 · 명도 계산). 해부도는 SVG를 직접 고칩니다
  • 용어.
    • 대비율은 WCAG 2.2의 contrast ratio(상대 휘도의 비)입니다. 텍스트는 4.5:1(AA, 1.4.3), 뜻을 가진 선과 도형은 3:1(1.4.11)이 기준입니다.
    • 테마는 그림의 색 묶음입니다. 문서마다 선택하고 파일과 함께 갑니다. 밝은 테마 · 어두운 테마 · 고대비 · 흑백 인쇄의 넷이 있습니다. 화면 색은 툴바 · 캔버스 배경 같은 편집 화면의 색이고, 테마와 따로 갑니다(2장, 8장).
    • 토큰은 값 대신 쓰는 이름입니다( line.structure → #5b77ad). 코드와 문서는 값이 아니라 이름을 씁니다.

밝은 기본 테마로 그린 코드식 예제. Event 헤더, 처리, If, 펴진 접기 영역(“센서 읽기”), 접힌 접기 영역(“로그 남기기”), Do-While, 구문 강조.

1. 원칙

이 제품의 그림은 화면의 장식이 아니라 남는 문서입니다. 주 사용자는 실무에서 설계 문서를 쓰는 사람이고, 그림은 코드 옆, 위키, PDF, 인쇄물에서 읽힙니다. 아래 여섯 원칙은 거기서 나오며, 서로 부딪치면 앞의 것이 이깁니다. 원칙마다 어떻게 지키는지 확인하는 방법을 붙였습니다.

원칙 1. 로직이 상자보다 먼저 읽힌다

NS 차트를 읽는 사람이 알고 싶은 것은 조건과 처리입니다. 블록의 배경은 흰 종이와 1.03 ~ 1.26:1밖에 벌어지지 않는 옅은 색으로 두고(가장 진한 배경인 펴 보기의 띠도 1.42:1), 블록 텍스트는 그 위에서 13.9:1 이상입니다. 그림에서 가장 진한 것은 언제나 텍스트입니다.

  • 근거: 종류별 진한 색(Scratch식)과 옅은 단색(EasyCODE식)을 같은 그림으로 비교했고, 진한 색은 “글자보다 상자가 먼저 보인다”는 이유로 떨어졌습니다 → DR-0003
  • 확인: 블록 배경 위의 text.primary 대비율이 그 배경과 종이의 대비율보다 열 배 이상 높은가(13.9 ÷ 1.26 ≈ 11). 보조 텍스트와 펴 보기의 띠는 이 확인에 넣지 않습니다(10.1절).

원칙 2. 뜻은 모양이 나르고, 색은 거들기만 한다

블록 종류는 색이 없어도 모양만으로 구분됩니다. 흑백으로 인쇄해도, 색을 구분하지 못하는 사람이 보아도 뜻이 같아야 합니다(WCAG 1.4.1).

예외는 하나, For와 While입니다. 둘은 같은 반복이고 NS 차트 표준도 같은 모양으로 그립니다. For는 조건 칸의 텍스트(for …)로 구분합니다. 텍스트는 흑백에서도 읽히므로 WCAG 1.4.1(색에만 기대지 않음)은 지켜집니다 → FB1

블록모양 (의미 전달)배경 (보조)
처리직사각형 block.process
If조건 칸에 V자 빗금(꼭짓점이 아래인 삼각형), 아래 양쪽 구석에 분기 라벨(처음은 “참” · “거짓”, 편집할 수 있음) block.branch
Case조건 칸에 긴 빗금과 짧은 빗금, 분기마다 세로선과 분기 라벨. 분기 라벨은 칸의 왼쪽에 붙이고, default 분기의 라벨만 오른쪽에 붙인다(짧은 빗금 아래 오른쪽 구석 → Q25). 코드에서 가져와 default가 없으면 빈 default 칸(∅)을 그려 두고, default만 있으면 짧은 빗금 하나만 그린다(→ CD1 · CD2) block.branch
While / Do-While왼쪽 띠 안에 본문. 조건 칸이 위(While)인지 아래(Do-While)인지 block.loop
호출 블록양옆 안쪽의 세로 이중선, 언제나 실선. Method가 없는 호출 블록(이름을 적는 호출 블록, Method를 삭제하거나 헤더를 제거함)도 모양이 같다 → ADR-0049 block.call
ForWhile과 같은 모양(왼쪽 띠 안에 본문, 조건 칸이 위). While과는 조건 칸의 텍스트로만 구분한다(예: for i ← 0 to n − 1). NS 차트 표준(DIN 66261)의 그림 그대로다 → FB1 block.loop
Event 헤더왼쪽에 솟은 모자 block.event
Method 헤더폭 전체에 걸친 낮은 아치 block.call (“호출하는 것과 호출되는 것”이라 같은 색)
  • 빈 분기: If · Case의 분기에 빈 블록 하나만 있으면 칸 가운데에 ∅를 text.muted로 보입니다. 저장되는 그림에도 들어가고, 텍스트를 적으면 사라집니다. 기호는 도형(path)으로 그립니다(2장). 반복의 빈 본문에는 넣지 않습니다. → R-LAY-09, E1

  • 헤더 모양 “제목처럼”: 문서 설정에서 헤더 모양을 “제목처럼”으로 선택하면 Event 모자와 Method 아치를 그리지 않습니다. 이름을 굵게 쓰고, 그 위에 흐린 작은 텍스트 Event · Method 라벨을, 아래에 가는 줄 하나를 둡니다. 배경은 칠하지 않습니다(종이 그대로). 헤더는 여전히 블록이라 선택하고 편집할 수 있습니다. 타이포그래피는 4.2절, 치수는 5장에 있습니다. 문서 설정의 자리는 01-model의 settings.headStyle입니다. → R-LAY-10, H1

    헤더 모양 설정: "모자 · 아치"(왼쪽)와 "제목처럼"(오른쪽) 헤더 모양에 있습니다.

    같은 퀵소트입니다. 이 문서의 다른 그림은 모두 “모자 · 아치”로 그렸습니다. 새 문서의 처음 값과 고르는 법은

  • If · Case · 반복 · 처리의 모양은 표준(DIN 66261, Nassi와 Shneiderman의 원 논문)을 따릅니다. Event · Method 헤더와 접기 표시는 표준에 없는 어휘라, 표준의 모양과 중복되지 않게 정했습니다 → ADR-0021

  • 확인: 흑백과 색각 이상 세 가지로 본 그림에서 모든 블록 종류가 구분되는가(10.2절). 적색맹으로 보면 If와 Event의 배경은 거의 같은 색(ΔE 1.1)이 되지만, 모양이 다르므로 원칙은 지켜집니다.

원칙 3. 문서의 표시와 편집의 표시는 다른 레이어다

그림 위의 모든 표시는 문서 레이어(파일에 저장됨)와 편집 레이어(화면에만 있음) 가운데 하나에 속합니다. 사용자는 화면을 보고 언제나 “이것이 파일에 들어가는가”를 알 수 있어야 합니다. 그래서 이렇게 약속합니다.

레이어의 약속

2px 이상의 선으로 무언가를 두르는 표시는 문서 레이어에 둘(펴진 접기 영역은 파랑 blue.500, 펴 보인 호출 블록은 보라 violet.500, 둘 다 맨 위에 띠), 편집 레이어에 하나(선택한 것 · 인라인 에디터 · 블록 위 드롭 표시, 주황 orange.600, 띠 없음)뿐이다. 그 밖의 문서 레이어의 색(1px 구조선의 회청, 키워드의 파랑 텍스트)은 두르는 표시가 아니므로 편집 레이어와 헷갈리지 않는다.

구분하는 것펴진 접기 영역 (문서 레이어)선택 하이라이트 (편집 레이어)
색파랑 blue.500주황 orange.600
밝기L* 51L* 51. 흑백으로는 같음(대비 1.01:1). 그래서 색상(서로 반대색)과 모양(띠, 자리)으로 구분한다. 적록 · 청황 색각 이상에서도 파랑과 주황은 구분된다
모양맨 위에 이름 띠가 붙음띠 없는 실선 상자
인쇄인쇄됨인쇄되지 않음. 그래서 흑백 인쇄 팔레트에서 둘이 같은 검정이 되어도 문제없음
  • 근거: 접기 영역과 선택 하이라이트가 같은 파랑이면 선택 하이라이트가 저장되는 테두리처럼 보입니다(52번째 버전까지 그랬음). 그래서 둘 가운데 하나는 파랑이 아니어야 하고, 접기 영역은 파랑으로 두고 선택 하이라이트를 주황으로 했습니다(Q15-d). 주황은 블록 배경 위에서 3:1을 지키려고 시안의 #e8590c보다 조금 진한 값입니다. 선택한 과정 → M19 접기 영역 색 시안 B · S1: https://claude.ai/artifact/R6G68CKoUa8aKsj8rhsRW9, 사본 journal/assets/2026-10-17-fold-color-study.html
  • 확인: 저장된 SVG에 편집 레이어의 색( orange.600)이 한 번도 나오지 않고, 조건 텍스트의 배경색 테두리(size.text-halo)를 뺀 굵기 2px 이상의 선은 모두 fold.edge나 peek.edge의 색인가.

원칙 4. 문서는 종이다

그림은 문서의 테마가 정한 종이에 그립니다. 편집 화면이 어둡다고 그림이 어두워지지 않습니다. 같은 파일은 GitHub에서도, 어두운 Obsidian에서도, 인쇄물에서도 같은 색이어야 하기 때문입니다(R-FMT-08). 종이 둘레의 그림자와 바깥 배경의 점 무늬가 “여기부터 종이다”를 알립니다. 어두운 화면에서 흰 종이가 밝은 것은 감수합니다.

  • 종이의 그림자는 화면에만 그립니다(편집 화면의 문서 레이어 둘레, 저장 파일 · PNG에는 없음). 모서리는 반지름 4px로 둥글리고, 그림자는 두 겹입니다: 가까이 진한 것(0 1px 3px, 불투명도 12%)과 멀리 옅은 것(0 6px 20px, 6%), 색은 남색 바탕(rgb(20, 30, 60)). 밝은 화면 · 어두운 화면이 같습니다 → 1. 화면 구성

밝은 화면 색과 어두운 화면 색

메뉴 바 · 툴바 · 상태 표시줄은 화면 색을 따르고, 가운데의 종이는 그대로입니다. 프로토타입 66번째 버전에서 찍은 화면이라 세부가 MVP와 다를 수 있습니다(배치는 화면 배치).

원칙 5. 두드러짐은 지금의 중요도 순서를 따른다

화면에서 눈에 띄는 순서는 “사용자가 지금 다루는 것 → 사용자가 묶거나 펴 본 것 → 구조”입니다. 두드러짐은 색의 채도, 선 굵기, 선 모양을 함께 써서 만듭니다. 같은 두드러짐의 표시가 다른 뜻을 갖지 않습니다. 선 굵기의 표는 6장에 있습니다.

  • 펴 보인 호출 블록은 펴진 접기 영역과 두드러짐이 같습니다. 모양이 같고 색(보라 · 파랑)으로 구분합니다 → Q15-a, 시안 M60: https://claude.ai/artifact/Gwz1JEezrZMY9w2pYKYNi6, 사본 journal/assets/2026-11-18-call-peek-frame-study.html
  • 펴 보인 곳 안의 접기 영역은 보통 접기 영역과 똑같이 그립니다. 같은 것은 어디서나 같게 보여야 한다는 메인테이너의 결정입니다(P1, 시안 M11).
  • 확인: 그림을 흐리게 보았을 때(블러 테스트) 선택한 것 → 접기 영역 · 펴 보인 호출 블록 → 나머지 순서로 보이는가.

원칙 6. 테마는 색만 바꾸고 기하는 바꾸지 않는다

테마를 바꿔도 블록의 크기와 자리는 한 픽셀도 바뀌지 않습니다. 그래서 테마는 git 기록에 그림의 이동을 남기지 않고, 다른 사람이 다른 테마로 열어도 그림의 모양은 같습니다(R-NFR-02).

  • 그래서 글꼴은 테마에 넣지 않습니다. 블록의 폭은 번들한 글꼴의 문자 폭 표로 계산하므로, 글꼴이 바뀌면 레이아웃이 바뀝니다(ADR-0026). 문서 설정인 “블록 텍스트의 언어”(R-LAY-06)도 글꼴을 바꾸지 않고 구문 강조의 색만 정합니다 → ADR-0042
  • 그래서 선 굵기도 테마에 넣지 않습니다. 접기 영역 테두리의 굵기는 안쪽에 겹친 테두리가 들어가는 깊이(size.nest-inset)를 정하므로, 굵기가 바뀌면 레이아웃이 바뀝니다.
  • 테마가 바꿀 수 있는 것은 3장의 색 토큰뿐입니다.

2. 레이어와 출력

flowchart LR
  M[(모델)] --> L[레이아웃<br/>폭 표로 계산한 좌표]
  L --> D["문서 레이어<br/>테마"]
  L --> E["편집 레이어<br/>화면 색"]
  D --> S[저장되는 SVG]
  D --> V[편집 화면]
  E --> V
문서 레이어편집 레이어
무엇블록, 선, 텍스트, 펴진 접기 영역의 테두리와 이름 띠, 펴 보인 호출 블록, 접힌 칸선택한 블록과 범위, 분기 라벨 선택, 인라인 에디터, 호버, 드래그할 때의 드롭 위치, 오류, 캔버스 포커스, 펼침 삼각형(▸ ▾), 키 힌트
저장된다. 저장되는 그림은 지금 화면 그대로 → ADR-0018되지 않는다
색을 정하는 것테마 (문서마다 선택함, 파일과 함께 감)화면 색 (사용자 설정)

저장되는 SVG에 들어가는 것:

  • 테마의 종이 색 사각형(밝은 기본 테마에서는 fill.paper) 하나. 투명하게 두지 않습니다. 어두운 뷰어에서도 원칙 4가 지켜집니다.
  • 그림 둘레 여백 24px.
  • 쓰인 문자만 추린 번들 글꼴과 대체 글꼴 목록 → R-FMT-07
  • 모델: <metadata> 안의 <ans:document> 요소에 모델 JSON을 CDATA로 넣고, 형식 버전(version)과 그림 지문(drawing-sha256)을 속성으로 둡니다 → 4.1 그림 지문. 내보내기의 순수 SVG(그림만)에는 <metadata>가 없어 다시 열어 편집할 수 없습니다 → 4.2 순수 SVG
  • 기호 ⋯와 ∅는 도형(path)으로 그립니다. 호출 블록의 결과 기호 ←는 문자로 그립니다. 저장 파일의 서브셋 글꼴에 그 글리프가 포함되므로 앱이 없는 뷰어에서도 보이고, 텍스트로 선택 · 복사 · 검색할 수 있습니다 → AR1. 펼침 삼각형(▸ ▾)은 편집 레이어에만 그리므로 저장되는 그림에 들어가지 않습니다 → Q2
  • 편집 레이어의 표시는 하나도 들어가지 않습니다.
  • 문서 설정의 “텍스트를 외곽선으로 저장”을 켜면 글꼴에 있는 글자를 도형(path)으로 저장합니다 → R-FMT-10

3. 디자인 토큰

3.1 세 단계

토큰은 세 단계로 둡니다. 코드와 다른 문서는 의미 토큰이나 구성 요소 토큰만 씁니다. 원시 토큰은 팔레트의 재료이고, 테마는 의미 토큰이 어느 원시 토큰을 가리킬지를 바꿉니다.

단계예뜻
원시 (primitive)ink.700 = #343b48색 자체. 뜻이 없다
의미 (semantic)text.primary → ink.900역할. 테마가 바꾸는 곳
구성 요소 (component)fold.edge → blue.500한 구성 요소의 한 부분

3.2 원시 팔레트

토큰값흑백 명도 L*토큰값흑백 명도 L*
ink.900 #151a229fill.paper #ffffff100
ink.700 #343b4825fill.snow #fbfcfe99
ink.600 #4b556736fill.slate #edf0f595
ink.500 #5a647642fill.sand #f6ebdc94
slate.500 #5b77ad50fill.mint #e2efdf93
blue.700 #1f45d637fill.lilac #ebe7f492
blue.600 #2c55c940fill.sky #dce6f691
blue.500 #4f74d651fill.ice #e6ecfb93
orange.600 #d0500b51
violet.700 #5f459f36
violet.500 #7a5fb847fill.lilac-strong #ddd4ef86
green.700 #22702a41red.700 #b4231840
amber.800 #8a5a0042

어두운 테마 · 고대비 · 흑백 인쇄가 쓰는 원시 토큰(night.* · deep.* · ink.50 등)은 3.5 · 3.6 · 9.3절의 표에 값과 함께 있습니다.

3.3 밝은 기본 테마

대비율은 블록 배경 다섯과 종이에 대어 본 가장 낮은 값 ~ 가장 높은 값입니다. 전부 기준을 넘습니다.

의미 · 구성 요소 토큰→ 원시역할대비율기준
paper fill.paper종이(그림 전체의 배경). 저장되는 그림에도 칠함
block.process fill.slate처리 블록 배경
block.branch fill.sandIf · Case의 조건 칸 배경
block.loop fill.sky반복 블록의 띠와 조건 칸
block.event fill.mintEvent 헤더
block.call fill.lilac호출 블록, Method 헤더
block.folded fill.snow접힌 칸
line.structure slate.500블록의 경계와 빗금3.56 ~ 4.483:1
text.primary ink.900블록 텍스트13.88 ~ 17.464.5:1
text.secondary ink.600분기 라벨(“참” · “거짓”, Case 분기)5.97 ~ 7.514.5:1
text.muted ink.500접힌 제어 블록 분기의 ”⋯ 블록 n개”, 펼침 삼각형 ▸ ▾(편집 레이어), 빈 분기의 ∅, 헤더 모양 “제목처럼”의 Event · Method 라벨4.74 ~ 5.974.5:1
syntax.keyword blue.700키워드5.80 ~ 7.294.5:1
syntax.comment green.700주석4.88 ~ 6.144.5:1
syntax.literal amber.800숫자, 문자열4.71 ~ 5.934.5:1
fold.edge blue.500펴진 접기 영역의 테두리3.48 ~ 4.373:1
fold.band fill.ice이름 띠 배경
fold.name blue.600이름 띠 텍스트5.46 (띠 위)4.5:1
peek.edge violet.500펴 보인 호출 블록의 테두리4.02 ~ 5.053:1
peek.band fill.lilac-strong펴 보인 호출 블록의 띠 배경
peek.name violet.700펴 보인 호출 블록의 띠 텍스트5.19 (띠 위)4.5:1
  • 구문 강조는 블록 텍스트를 토큰으로 분리해 예약어는 syntax.keyword, 주석은 syntax.comment, 문자열과 숫자는 syntax.literal로 칠합니다. 그 밖의 단어는 text.primary입니다. 블록 텍스트의 언어가 “일반 텍스트”면 칠하지 않습니다 → ADR-0032. 칠하는 것은 처리 블록의 텍스트와 조건 칸이고, 헤더의 이름 · 분기 라벨 · 호출 블록은 칠하지 않습니다(SY1). 굵기와 기울임은 쓰지 않으므로 강조해도 폭은 그대로입니다. 언어마다의 규칙 → 3.1 구문 강조
  • 분기 라벨은 구문 강조의 색( blue.700)을 쓰지 않습니다. 구조의 텍스트가 코드의 일부처럼 보이지 않게 하려는 것입니다.
  • 펴 보인 블록의 텍스트는 다른 블록과 같은 색이고 구문 강조도 같습니다. “편집할 수 없다”는 것은 보라색 테두리와 띠가 알립니다.

3.4 화면 색

토큰밝은 화면어두운 화면역할
ui.bg #eef1f6 #12151b종이 바깥의 배경
ui.dots #d3d9e4 #262c37배경의 점 무늬 (18px 간격)
ui.panel #ffffff #1a1e26메뉴 바, 툴바, 상태 표시줄, 메뉴, 모달, 키 힌트
ui.text #1c2230 #e5e8ee화면 텍스트
ui.muted #5a6476 #9aa3b3보조 텍스트
ui.line #d4dbe6 #2b313c화면의 구분선
ui.accent #2c55c9 #8ba7ff포커스, 상태 표시줄의 모드, 캔버스 포커스, 기본 버튼, 링크
ui.accent-soft #e4eafb #232c45호버와 고른 항목의 배경
ui.warn #ad560f #f0a560키 힌트의 왼쪽 줄, 경고 알림 · 삭제 버튼의 글자
ui.shadowrgba(20, 30, 60, 0.18)rgba(0, 0, 0, 0.5)메뉴 · 키 힌트 · 모달의 그림자
ui.backdroprgba(20, 26, 34, 0.32)rgba(0, 0, 0, 0.5)모달 뒤를 덮는 막

화면 색의 대비율(밝은 / 어두운): ui.text 15.90 / 13.60, ui.muted 5.97 / 6.57 (패널 위), ui.accent 5.71 / 7.89, ui.warn 4.51 / 8.93 (배경 위), 5.10 / 8.16 (패널 위). ui.warn은 경고 알림과 삭제 버튼의 글자에도 쓰므로 기준은 텍스트의 4.5:1입니다 → WC1

고대비 화면 색(R-NFR-07): 운영체제가 더 높은 대비를 요청하면(prefers-contrast: more, Windows의 대비 테마 · macOS의 “대비 증가”) 아래 다섯 토큰만 바뀝니다. 나머지는 위 표 그대로입니다. 그림의 색은 바뀌지 않습니다. 그림은 문서의 테마(3.6절의 고대비 테마)가 정합니다 → TM5

토큰밝은 화면어두운 화면역할
ui.text #000000 #ffffff화면 텍스트
ui.muted #3d4554 #c5ccd8보조 텍스트
ui.line #6b7486 #8790a0화면의 구분선 (패널 위 3:1 이상)
ui.accent #1f3fb8 #a8bdff포커스, 상태 표시줄의 모드, 캔버스 포커스, 기본 버튼, 링크
ui.warn #7f3c06 #f5b97a키 힌트의 왼쪽 줄, 경고 알림 · 삭제 버튼의 글자

고대비 화면 색의 대비율(밝은 / 어두운): ui.text 21.00 / 16.70, ui.muted 9.64 / 10.34 (패널 위), ui.accent 8.53 / 9.06 (호버 배경 위 7.09 / 7.50), ui.line 4.70 / 5.19, ui.warn 7.27 / 10.54 (배경 위). 텍스트는 모두 7:1을 넘습니다.

편집 레이어의 표시는 종이 위에 그려지므로, 화면 색이 아니라 테마의 종류(종이가 밝은가 어두운가)를 따릅니다. 밝은 종이(밝은 테마 · 흑백 인쇄)에는 주황 orange.600을, 어두운 종이(어두운 테마 · 고대비)에는 더 밝은 주황을 씁니다. 인라인 에디터의 바탕과 글자도 그 테마의 paper · text.primary이고, 자리 표시 글자는 text.muted입니다 → TM4

토큰밝은 종이어두운 종이역할
edit.select orange.600 #f08a4b선택한 블록 · 범위의 테두리
edit.hover orange.600 #f08a4b호버한 블록 (1px)
edit.field orange.600 #f08a4b인라인 에디터의 테두리
edit.drop orange.600 #f08a4b드래그할 때의 드롭 위치의 줄
edit.error red.700 #ff7b72받아들일 수 없는 입력
edit.toggle ink.500 ink.300 ( #a3acbc)펼침 삼각형 ▸ ▾ (밝은 · 어두운 기본 테마의 text.muted와 같음)

편집 레이어의 대비율(종이와 블록 배경 · 이름 띠 · 펴 보기의 띠 위, 가장 낮은 값 ~ 가장 높은 값): 선택 · 호버 · 드롭은 밝은 테마 3.05 ~ 4.34, 어두운 테마 4.80 ~ 7.00, 고대비 6.43 ~ 8.44, 흑백 인쇄 4.34. 오류는 밝은 테마 4.61 ~ 6.57, 어두운 테마 4.73 ~ 6.90, 고대비 6.35 ~ 8.33, 흑백 인쇄 6.57. 모두 3:1을 넘습니다(테두리와 줄이라 기준은 3:1).

3.5 어두운 기본 테마

3.3절과 같은 색상(회청 · 모래 · 하늘 · 민트 · 라일락)을 어두운 종이 위에 옮겼습니다. 역할은 3.3절과 같습니다. 대비율은 블록 배경 다섯과 종이에 대어 본 가장 낮은 값 ~ 가장 높은 값이고, 전부 3.3절과 같은 기준(AA)을 넘습니다. 초안은 M17 테마 시안에 있었고, 값은 이 기준에 맞춰 정했습니다 → TM1

의미 · 구성 요소 토큰→ 원시대비율기준
paper night.paper (#171a21)
block.process night.slate (#232833)
block.branch night.sand (#3a3226)
block.loop night.sky (#22304a)
block.event night.mint (#213328)
block.call night.lilac (#2c2840)
block.folded night.snow (#1c2029)
line.structure slate.300 (#7d93c4)4.11 ~ 5.673:1
text.primary ink.50 (#e6e9ef)10.38 ~ 14.324.5:1
text.secondary ink.200 (#b4bccb)6.61 ~ 9.124.5:1
text.muted ink.300 (#a3acbc)5.52 ~ 7.614.5:1
syntax.keyword blue.300 (#9db8ff)6.45 ~ 8.904.5:1
syntax.comment green.300 (#82c98a)6.41 ~ 8.854.5:1
syntax.literal amber.300 (#e3b862)6.79 ~ 9.374.5:1
fold.edge blue.400 (#7f9cf0)4.76 ~ 6.563:1
fold.band night.ice (#1f2a45)
fold.name blue.200 (#a9c0ff)7.91 (띠 위)4.5:1
peek.edge violet.300 (#a58be0)4.43 ~ 6.113:1
peek.band night.lilac-strong (#3a3158)
peek.name violet.150 (#cdbcf5)6.88 (띠 위)4.5:1

3.6 고대비 테마

검은 종이에 흰 선과 흰 글자입니다(R-NFR-07). 블록 배경은 블록 종류의 색상을 아주 어둡게 남겨, 색이 보조하는 역할(원칙 2)은 그대로 둡니다. 텍스트와 뜻을 가진 선이 모두 7:1(WCAG 1.4.6, AAA)을 넘습니다. Windows의 대비 테마(“야간 하늘”)처럼 검은 바탕이 고대비 화면의 관례라 어두운 쪽으로 정했습니다. 흰 종이에 검정이 필요하면 흑백 인쇄(9.3절, 21:1)가 그 역할을 합니다 → TM1

의미 · 구성 요소 토큰→ 원시대비율기준
paper black (#000000)
block.process black (#000000)
block.branch deep.sand (#1f1a00)
block.loop deep.sky (#00183d)
block.event deep.mint (#002208)
block.call deep.lilac (#1c0d33)
block.folded deep.snow (#0f0f0f)
line.structure white (#ffffff)17.04 ~ 21.007:1
text.primary white (#ffffff)17.04 ~ 21.007:1
text.secondary gray.100 (#f0f0f0)14.95 ~ 18.437:1
text.muted gray.200 (#d6d6d6)11.72 ~ 14.457:1
syntax.keyword cyan.200 (#8fd0ff)10.25 ~ 12.637:1
syntax.comment green.200 (#7ee08a)10.48 ~ 12.927:1
syntax.literal yellow.300 (#ffd84d)12.32 ~ 15.187:1
fold.edge sky.300 (#6cb6ff)7.93 ~ 9.777:1
fold.band deep.sky (#00183d)
fold.name sky.200 (#9fd0ff)10.80 (띠 위)7:1
peek.edge violet.200 (#d2a8ff)8.75 ~ 10.797:1
peek.band deep.lilac-strong (#2a1747)
peek.name violet.100 (#e3c9ff)10.72 (띠 위)7:1

4. 타이포그래피

4.1 크기 단계

글자 크기는 두 단계뿐입니다. 크기가 많을수록 위계가 흐려지고, 테마와 배율마다 맞출 값이 늘어납니다.

단계크기 / 줄 높이인쇄 (96dpi 기준)
본문13px / 18px9.75pt
보조12px9pt

4.2 텍스트의 역할

그림 안의 텍스트는 모두 아래 표의 한 줄에 해당합니다. 글꼴은 모두 블록 글꼴(4.3절) 하나입니다.

역할단계글꼴굵기 · 모양색
블록 텍스트본문블록 글꼴보통 text.primary, 구문 강조는 syntax.*
호출 블록본문블록 글꼴Method 이름만 굵게(600) text.primary
접힌 접기 영역의 이름본문블록 글꼴보통. 이름이 없으면 기울임 text.primary
분기 라벨 (“참” · “거짓”, Case 분기)보조블록 글꼴보통 text.secondary
접기 영역의 이름 띠보조블록 글꼴굵게(600). 이름이 없으면 기울임 fold.name
펴 보기의 띠보조블록 글꼴호출 블록처럼 Method 이름만 굵게 peek.name
접힌 제어 블록 분기 (”⋯ 블록 n개”)보조블록 글꼴기울임 text.muted
빈 분기의 ∅본문도형 (글자 크기에 맞춤)보통 text.muted
헤더 모양 “모자 · 아치”의 이름본문블록 글꼴보통, 구문 강조 없음 text.primary
헤더 모양 “제목처럼”의 이름본문블록 글꼴굵게(600) text.primary
헤더 모양 “제목처럼”의 라벨 (Event · Method)보조블록 글꼴보통 text.muted
  • 한글은 획이 많아 같은 크기의 영문보다 작게 읽힙니다. 그래서 그림 안의 가장 작은 텍스트를 **12px(인쇄 9pt)**로 둡니다. 52번째 버전까지 있던 11px(인쇄 8.25pt)은 없앴습니다.
  • 굵기는 보통(400)과 굵게(600)만 씁니다. 굵게는 이름(호출 블록의 Method 이름, 펴진 접기 영역의 이름 띠, “제목처럼” 헤더의 이름)에만 씁니다. 이름이 없으면 기울임으로 “아직 이름이 없다”를 보입니다.
  • 기울임은 모든 출력에서 같게 보입니다. 번들 글꼴에는 기울임체가 없으므로 화면과 보통의 저장 파일은 브라우저의 합성 기울임으로, 텍스트 외곽선과 PDF는 글리프 외곽선을 기준선 기준으로 약 14도(높이의 1/4) 기울여 그립니다. 글자 폭과 레이아웃은 바뀌지 않습니다 → SL1

4.3 글꼴

자리글꼴정하는 것
그림의 모든 텍스트고정폭 (기본 블록 글꼴)고정. 블록 텍스트의 언어와 상관없음 → ADR-0042
화면배포 대상의 기본 글꼴배포 대상 (Obsidian이면 Obsidian의 글꼴)
  • 기본 블록 글꼴은 D2Coding(고정폭, 보통 굵기)입니다. 블록 텍스트의 언어를 적지 않은 문서는 이 글꼴로 그립니다. 나중에 블록 텍스트의 언어나 문서마다 글꼴을 고르는 기능이 들어와도, 그 값이 없는 파일(MVP로 저장한 파일 전부)은 이 글꼴로 그립니다. 라틴 · 유럽 확장, 한글, 그리스, 키릴, 가나를 포함하고 한자는 포함하지 않습니다 → ADR-0034
  • 번들한 글꼴 파일 안의 이름(패밀리 이름)은 AriadneNSD Mono입니다. “D2Coding”은 OFL의 예약 글꼴 이름(Reserved Font Name)이라, 문자를 추려 고친 글꼴에는 쓸 수 없습니다. 고정폭 글꼴의 관례(JetBrains Mono 등)를 따른 이름이고, 비례폭 글꼴을 번들하면 AriadneNSD Sans로 합니다 → DR-0019. 그림의 font-family는 이 이름 다음에 폴백 글꼴 목록을 적습니다 → 2. 문서 구조
  • 글꼴은 하나뿐입니다. 언어를 바꾸면 색만 바뀌고 블록의 폭은 그대로라, MVP로 저장한 파일(일반 텍스트)도 그대로 열립니다 → ADR-0042
  • 블록 텍스트의 공백은 그대로 둡니다(white-space: pre). 코드의 들여쓰기가 그림에서도 보여야 합니다.
  • 폭은 번들한 글꼴의 폭 표로 계산합니다. 커닝을 끄고, 정수 px로 올립니다 → ADR-0026

5. 기하와 해부도

블록마다의 치수와 상태. 위에서부터 블록의 종류, 여러 줄 텍스트, 빈 분기와 default가 없는 Case, 접힌 분기, 겹친 테두리(제어 블록을 거쳐 겹쳐도 틈은 같다), 다이어그램 사이, 편집 레이어의 순서다. 주황 선과 주황 글자는 치수선이고 그림에는 들어가지 않는다. 펼침 삼각형(▸ ▾)과 맨 아래의 편집 레이어는 편집 화면에만 보이고 저장되는 그림에는 들어가지 않는다.

토큰값무엇
space.pad-x / space.pad-y10 / 7px블록 안 텍스트의 왼쪽 · 위 여백
space.line18px블록 텍스트 한 줄
size.block-min-w52px블록의 가장 좁은 폭
size.loop-strip22px반복 블록 왼쪽 띠의 폭
size.if-label / size.case-label16 / 28pxIf · Case의 조건 칸 아래 분기 라벨 줄
size.if-head-extra / size.case-head-extra70 / 90pxIf · Case 조건 칸의 최소 폭에서 조건 텍스트와 양옆 여백에 더하는 폭(빗금이 지나갈 자리)
size.label-room18pxIf · Case 분기 하나의 최소 폭에서 분기 라벨의 폭에 더하는 여유
size.label-inset6px분기 라벨과 칸의 구석 사이(왼쪽에 붙는 라벨은 왼쪽 구석, “거짓”과 default 라벨은 오른쪽 구석에서)
size.hat16pxEvent · Method 헤더가 솟은 높이
size.hat-wmin(110px, 폭 × 0.45)Event 모자의 폭
size.hat-room24px헤더 모양 그대로일 때 헤더의 최소 폭에서 이름과 양옆 여백에 더하는 폭
size.diagram-min-w160px다이어그램의 가장 좁은 폭
size.title-tag16px헤더 모양 “제목처럼”에서 라벨 줄의 높이. 그 아래 이름 줄은 space.line
size.title-gap6px”제목처럼” 헤더에서 이름 줄과 아랫줄 사이. 헤더의 높이는 16 + 18 + 6 = 40px. 텍스트는 다이어그램의 왼쪽 선에 맞춥니다(space.pad-x 없음)
size.call-bar7px호출 블록 세로 이중선의 안쪽 거리
size.band18px이름 띠의 높이
size.band-text-x10px이름 띠 · 펴 보기 띠의 왼쪽 끝에서 펼침 삼각형 자리까지
size.band-icon-room10px이름 띠 · 펴 보기 띠에서 텍스트 앞 펼침 삼각형(▾)의 자리. 텍스트는 왼쪽 끝에서 size.band-text-x + 10 = 20px(접힌 칸과 같은 자리)에서 시작합니다. 삼각형은 편집 레이어에만 그리지만 이 자리는 저장되는 그림에도 남습니다 → FD8
size.fold-icon-room / size.fold-extra-h20 / 4px접힌 접기 영역 칸에서 이름 앞 펼침 삼각형(▸)의 자리, 높이에 더하는 여유. 칸의 높이는 이름의 줄 수 × space.line + 2 × space.pad-y + 4px(한 줄이면 36px)이고, 가장 좁은 폭은 이름의 폭 + 2 × space.pad-x + 20px입니다. 삼각형은 편집 레이어에만 그리지만 이 20px은 저장되는 그림에도 그대로 남습니다. 화면과 파일의 기하는 같기 때문입니다(화면 그대로 → ADR-0018)
size.fold-edge3px펴진 접기 영역의 테두리 굵기 (M11에서 선택한 굵기)
size.nest-gap1px테두리 안에 테두리가 들어갈 때의 틈
size.nest-inset4px (= size.fold-edge + size.nest-gap)접기 영역 안에 겹친 테두리가 들어가는 깊이. 제어 블록을 거쳐 들어가도 바깥 테두리의 변에 닿는 쪽은 같은 깊이다
size.peek-inset4px (= size.fold-edge + size.nest-gap)펴 보인 호출 블록 안에 겹친 테두리(펴진 접기 영역, 펴 보인 호출 블록)가 들어가는 깊이. 보통 블록은 들이지 않고 테두리에 붙인다. 제어 블록을 거쳐 들어가도 바깥 테두리의 변에 닿는 쪽은 같은 깊이다
size.text-halo3pxIf · Case 조건 텍스트 둘레에 까는 배경색 테두리의 두께(텍스트 바깥으로)
space.diagram44px다이어그램 사이
space.kind-gap88px (= 2 × space.diagram)Event 그룹과 Method 그룹 사이 → DA1
size.column-min420px여러 다이어그램을 줄로 놓을 때 한 줄의 가장 좁은 폭
space.paper24px그림 둘레의 여백

배치 규칙:

  • 블록은 서로 맞붙습니다(NS 차트의 표기). 블록 사이에 틈을 두지 않습니다.
  • 텍스트의 기준선은 그 줄(space.line 18px)의 아래 끝에서 5px 위입니다. If · Case의 조건 텍스트는 블록 텍스트보다 2px 더 위에 둡니다. 분기 라벨의 기준선은 조건 칸의 아래 끝에서 5px 위입니다(프로토타입의 그림과 같음).
  • 빈 분기의 ∅는 지름 7px의 원과 빗금이고 선은 1.1px입니다. 빗금의 양 끝은 원을 둘러싼 사각형보다 가로세로로 1px씩 더 나갑니다 → E1
  • If · Case의 조건 텍스트는 빗금의 꼭짓점 위 가운데에 두되, 블록 안 여백(space.pad-x)을 넘지 않게 밉니다. 조건 칸의 폭과 높이는 늘리지 않으므로(최소 폭은 텍스트 + 양옆 여백 20px + If 70px · Case 90px, 높이는 텍스트 줄 수로 정해짐), 조건이 길면 빗금이 텍스트에 닿을 수 있습니다. 그래서 조건 텍스트 뒤에 조건 칸의 배경색(block.branch)으로 테두리(size.text-halo)를 깔아, 닿는 곳에서만 빗금이 텍스트 둘레에서 끊기게 합니다. 닿지 않으면 테두리는 배경과 같은 색이라 보이지 않습니다 → BH1
  • 펴진 접기 영역의 안쪽 블록은 테두리에 붙습니다. 테두리 안에 다른 테두리(겹친 접기 영역, 펴 보인 호출 블록)가 들어가면 size.nest-gap만큼 띄웁니다. 제어 블록을 몇 겹 거쳐 들어가도, 안쪽 테두리의 변이 바깥 테두리의 왼쪽 · 오른쪽 · 아래 변에 닿으면 똑같이 띄웁니다. 닿지 않는 변은 들이지 않습니다. 겹치거나 이어져도 상자가 따로 보입니다 → 접기 · 펼치기, NF1
  • 토큰이 없는 작은 값: 접힌 줄의 세 점이 차지하는 자리 16px, 펼침 삼각형의 클릭 영역의 폭 18px, 펼침 삼각형의 중심은 왼쪽 끝에서 11px이고, 이름 띠 · 펴 보기 띠에서는 위 끝에서 9px(띠의 가운데), 접힌 칸에서는 위 끝에서 16px(space.pad-y + space.line / 2, 이름 첫 줄의 가운데 → FD11), 한 줄에서 맞붙은 두 테두리 사이에 더하는 높이 2px(경계선 1px + size.nest-gap). 헤더 모양 “제목처럼”의 라벨은 기준선이 라벨 줄의 아래 끝에서 4px 위입니다.
  • 블록의 크기: 처리 블록의 높이는 줄 수 × space.line + 2 × space.pad-y(한 줄이면 32px), 가장 좁은 폭은 size.block-min-w와 텍스트 폭 + 2 × space.pad-x 가운데 큰 값입니다. 호출 블록의 높이는 32px, 폭은 텍스트 폭 + 2 × space.pad-x + 2 × size.call-bar입니다. 반복 블록의 조건 칸은 줄 수 × space.line + 2 × space.pad-y, If는 여기에 size.if-label, Case는 size.case-label을 더합니다(한 줄이면 32 · 46 · 60px). 모자 · 아치 헤더의 높이는 size.hat + 줄 수 × space.line + 2 × space.pad-y(한 줄이면 48px)입니다.
  • 헤더의 곡선: 헤더의 왼쪽 위를 (x, y), 폭을 w, 모자의 폭을 h라 하면, Event 모자는 (x, y + 16)에서 (x + h, y + 16)까지 제어점 (x + 22, y − 2) · (x + h − 22, y − 2)의 3차 베지에 곡선이고, Method 아치는 (x, y + 16)에서 (x + w, y + 16)까지 제어점 (x + 0.2w, y + 1) · (x + 0.8w, y + 1)의 3차 베지에 곡선입니다.
  • Case의 선: 긴 빗금은 조건 칸의 왼쪽 위에서 default 칸의 왼쪽 아래까지, 짧은 빗금은 거기서 오른쪽 위까지입니다. 분기 사이의 세로선은 긴 빗금 위의 점에서 조건 칸의 아래 끝까지 내려옵니다. default만 있으면 오른쪽 위에서 왼쪽 아래까지 짧은 빗금 하나만 그립니다.
  • 접힌 분기 · 본문의 칸: 높이는 32px, 가장 좁은 폭은 space.pad-x + 16px + 텍스트 폭 + space.pad-x입니다. 세 점은 반지름 0.6px에 선 1.2px의 원이고, 중심은 칸의 왼쪽 끝에서 space.pad-x + 3 · 7 · 11px, 기준선에서 3.5px 위입니다. 텍스트는 space.pad-x + 16px에서 시작합니다.
  • 이름 띠 · 펴 보기 띠: 가장 좁은 폭은 20px + 텍스트 폭 + space.pad-x입니다. 이름 띠의 이름은 줄 바꿈을 공백으로 바꿔 한 줄로 씁니다. 펼침 삼각형은 ▾가 폭 8px · 높이 5px, ▸가 폭 5px · 높이 8px입니다.
  • 편집 레이어의 사각형: 그림은 반 픽셀 옮겨 그리므로 블록의 오른쪽 · 아래 구조선은 상자에서 1px 바깥에 있습니다. 선택 · 호버 · 블록 위 드롭의 사각형은 그 선까지 덮도록 폭과 높이에 1px을 더해 계산합니다. 블록의 왼쪽 위에서 선의 가운데까지의 거리는 선택 1.5px(3px 선), 호버 1.5px(1px 선), 블록 위 드롭 2px(2px 선)입니다. 드롭 위치의 눈금은 줄의 양 끝에서 1px 안쪽에 둡니다.

6. 선

두드러짐무엇레이어선인쇄
1 (가장 강함)인라인 에디터편집2px 실선 edit.field + 종이 색 배경(테마의 paper) + 커서—
1선택한 블록 · 범위편집3px 실선 edit.select. 배경은 칠하지 않음—
2펴진 접기 영역문서3px 실선 fold.edge + 이름 띠2.25pt
2펴 보인 호출 블록문서3px 실선 peek.edge + 띠. 가운데가 블록의 바깥 선에서 1px 안2.25pt
3구조: 블록의 경계, 빗금, Case의 분기 세로선, 호출 블록의 세로 이중선, 이름 띠 · 펴 보기 띠의 아랫줄, “제목처럼” 헤더의 아랫줄문서1px 실선 line.structure0.75pt
—호버편집1px 실선 edit.hover. 블록의 바깥 선에서 1px 안(구조선과 겹치지 않음)—
  • 선택 하이라이트에 배경을 칠하지 않는 이유: 옅은 파랑을 덮으면 블록 배경의 색조가 흐려지고(원칙 2), 구조선의 대비가 2:1 아래로 떨어집니다(원칙 1).
  • 선택 하이라이트를 블록 안쪽에 그리는 이유: NS 차트의 블록은 서로 맞붙어 있어서, 바깥에 두르면 이웃 블록과 접기 영역의 테두리를 덮습니다.

7. 상태

7.1 상태 표

상태모습레이어토큰MVP
기본2 ~ 6장 그대로문서있음
펴진 접기 영역테두리 + 이름 띠(이름, 굵게) + 띠 아래 1px 구조선(line.structure). 이름 띠를 끄면 접기 영역이 없는 것과 똑같음. 편집할 때는 이름 앞에 펼침 삼각형 ▾(편집 레이어, 저장되지 않음)문서fold.*있음 (2026-11-03)
접힌 접기 영역한 줄 칸 + 이름. 편집할 때는 이름 앞에 펼침 삼각형 ▸(편집 레이어, 저장되지 않음)문서 block.folded있음 (2026-11-03)
접힌 제어 블록의 분기한 줄 칸 + ”⋯ 블록 n개” (기울임)문서 block.folded, text.muted있음 (2026-11-03)
펴 보인 호출 블록3px 테두리 + 띠(호출 블록의 텍스트. 편집할 때는 앞에 펼침 삼각형 ▾, 편집 레이어). 펴진 접기 영역과 모양이 같고 색이 보라다. 안의 텍스트는 다른 블록과 같다. 띠가 있는 동안 세로 이중선은 그리지 않음문서peek.*있음 (2026-11-03)
이름 없는 접기 영역 (펴짐)이름 띠에 기본 이름(02-interaction-rules)을 기울여 씀문서 fold.name있음 (2026-11-03)
이름 없는 접기 영역 (접힘)접힌 칸에 기본 이름을 기울여 씀문서 text.primary있음 (2026-11-03)
호버블록의 바깥 선에서 1px 안에 1px 테두리. 선택한 블록에는 그리지 않음편집 edit.hover있음
블록 하나를 선택함블록 안쪽 3px 테두리편집 edit.select있음
분기 라벨을 선택함조건 칸 아래쪽의 분기 라벨 칸(높이 If size.if-label 16px, Case size.case-label 28px → 02-layout) 안쪽 3px 테두리. 블록 선택과 같은 모습 → 02-interaction-rules편집 edit.select있음
여러 블록을 선택함선택한 블록들을 감싸는 상자 하나. 블록 하나와 같은 모습편집 edit.select있음
텍스트를 편집하는 중블록 자리에 종이 색(테마의 paper) 입력 칸 + 2px 테두리 + 커서. 상태 표시줄 오른쪽에 -- 편집 --편집 edit.field있음
영역을 선택하는 중 (v V)선택 테두리는 여러 블록을 선택한 것과 같음. 상태 표시줄 오른쪽에 -- 영역 --편집 (UI)edit.select있음
받아들일 수 없는 입력입력 칸의 테두리가 edit.error로 바뀌고, 상태 표시줄에 이유를 적음. 색에만 기대지 않음편집 edit.error있음 (헤더 이름이 중복될 때만 → 02-interaction-rules)
선택한 것이 없음그림에는 표시가 없음. 캔버스 안쪽의 2px 포커스 테두리는 포커스가 올 때 · 빈 곳을 클릭할 때 · 아무 일도 하지 않은 키를 누를 때 1초 보이고 0.3초에 걸쳐 사라짐. 환경 설정으로 항상 보이게 할 수 있음 → CF2편집 (UI)ui.accent있음
드래그 중드래그하고 있는 블록은 제자리에서 불투명도 40%(툴바의 블록 아이콘을 드래그할 때는 제자리 표시 없음). 커서 곁에 블록의 텍스트 첫 줄(12px, ui.panel 배경, 1px ui.line 테두리, 반지름 4px)편집있음
드롭 위치블록 사이에 2px 가로줄 + 양 끝에 줄의 위아래로 4px씩(길이 8px, 굵기 2px) 세로 눈금편집 edit.drop있음
블록 위에 드롭 (감싸기, 빈 블록 · 빈 default 칸 채우기)그 블록의 바깥 선에서 1px 안에 2px 테두리. 감싸기일 때만 커서 곁에 “If로 감싸기”처럼 결과의 이름 → 02-interaction-rules편집 edit.drop있음
드롭할 수 없는 곳줄을 그리지 않고, 커서가 금지 모양편집있음
빈 분기If · Case의 분기에 빈 블록 하나만 있으면 칸 가운데에 ∅문서 text.muted있음
헤더 모양 “제목처럼”모자 · 아치 없이 라벨 + 굵은 이름 + 아랫줄 1px. 선택하면 헤더 전체(라벨부터 아랫줄까지)를 블록 하나처럼 두름. 글자가 다이어그램의 왼쪽 선에 붙어 있으므로 선택 테두리는 왼쪽 · 위 · 오른쪽으로 4px 넓혀(아래는 그대로) 글자를 덮지 않음문서text.*, line.structure있음
두 키 조합을 기다림첫 키 뒤 0.4초가 지나면 선택 바로 아래(선택의 왼쪽 끝에서 최대 24px 안쪽, 선택 아래 4px → KA1)에 키 힌트. 맨 위에 첫 키와 묶음 이름(ui.muted), 그 아래에 한 줄에 하나씩 이어 누를 키(화면 글꼴 굵게 ui.accent)와 명령 이름(ui.text). 배경 ui.panel, 테두리 1px ui.line, 왼쪽 띠 3px ui.warn, 그림자. 아래에 자리가 모자라면 선택 위로 뒤집고, 창 밖으로 나가지 않게 밀어 넣음 → 03-keymap, K3편집 (UI)ui.*있음

겹칠 때의 규칙:

  • 편집 레이어는 언제나 문서 레이어 위에 그립니다. 선택 하이라이트는 접기 영역과 펴 보인 호출 블록의 테두리 위에 옵니다.
  • 인라인 에디터가 열리면 그 블록의 선택 하이라이트는 그리지 않습니다(같은 자리에 두 테두리를 겹치지 않음) → IE1
  • 펴 보인 블록도 선택할 수 있고 모습은 같습니다. 편집할 수 없다는 것은 보라색 테두리와 띠가 이미 알립니다 → 호출 블록 펴 보기

7.2 그림

문서 레이어: 호출 블록 · Method · 펴 보기 · 접기 영역

왼쪽 quicksort에서 partition 호출 블록을 펴 보았습니다(보라색 테두리와 띠). 오른쪽 partition의 접기 영역 “준비”는 펴 보인 곳에도 같은 모습입니다. 아래 두 블록은 접힌 호출 블록(세로 이중선)입니다.

접힌 모습과 Case

왼쪽은 If의 “참” 분기를 접은 모습입니다(아래에 접힌 접기 영역 “로그 남기기”). 오른쪽은 분기가 넷인 Case입니다.

편집 레이어: 블록 하나를 선택함 · 여러 블록을 선택함 · 편집하는 중

선택 하이라이트는 주황, 펴진 접기 영역(“센서 읽기”)의 테두리는 파랑입니다. 선택 하이라이트가 파일에 들어가는 표시와 섞이지 않습니다.

분기 라벨을 선택함 · 선택한 것이 없을 때의 키보드 포커스

키 힌트 ( a를 누르고 0.4초 뒤)

8. 테마

  • 테마는 그림의 색 묶음입니다. 3장의 의미 · 구성 요소 토큰이 어느 색을 가리키는지를 정합니다. 문서마다 선택하고 파일과 함께 갑니다. 그래서 누가 어디서 열어도, 저장된 그림과 인쇄물과 PNG도 같은 색입니다(R-LAY-08, R-FMT-08). → 선택한 과정은 M17 테마 시안(TH1 · 1번): https://claude.ai/artifact/CABapWNP4NnQupcmTpwyZf, 사본 journal/assets/2026-10-17-theme-study.html
  • 테마는 넷입니다. 문서 설정의 “테마”에서 이 차례로 나옵니다 → TM1
테마 (화면의 이름, 영어 화면)파일의 이름종류값대비의 기준
밝은 테마 (Light)default밝음3.3절텍스트 4.5:1, 선 3:1
어두운 테마 (Dark)dark어두움3.5절텍스트 4.5:1, 선 3:1
고대비 (High contrast)high-contrast어두움3.6절텍스트 7:1, 선 7:1
흑백 인쇄 (Black and white print)print밝음9.3절21:1
  • 새 문서는 밝은 테마로 시작합니다. 테마를 바꾸는 것은 문서를 고치는 것이라 실행 취소의 대상이고, 저장하지 않은 표시(●)가 붙습니다. 저장되는 그림은 고른 테마 그대로입니다(화면 그대로 저장, ADR-0018) → TM2, TM3
  • 파일에는 테마의 이름만 적습니다(settings.theme). 지원하지 않는 이름(뒤 버전의 테마)으로 그린 문서는 밝은 테마로 그리고, 이름은 그대로 두어 다시 저장해도 사라지지 않습니다 → ADR-0044, 01-file-format
  • 종류(밝음 · 어두움)는 종이의 밝기입니다. 편집 레이어(선택 · 호버 · 드롭 위치 · 인라인 에디터)는 화면 색이 아니라 이 종류를 따릅니다(3.4절) → TM4
  • 흑백 인쇄(R-LAY-08의 흑백 인쇄 모드)는 문서의 테마 하나입니다. 모든 배경은 흰색, 선과 텍스트는 검정, 구문 강조는 끄고, 점선과 테두리 굵기는 그대로 둡니다. 원칙 2 덕분에 뜻은 그대로입니다. 펴진 접기 영역과 펴 보인 호출 블록은 모양이 같아지고 띠의 글자(영역 이름과 호출문)로 구별합니다 → Q15-a. 값은 9.3절에 있습니다.
  • 화면 색(메뉴 바, 툴바, 캔버스 배경, 메뉴)은 테마에 넣지 않습니다. 사용자의 설정이고 파일에 저장되지 않습니다. 밝은 화면 색과 어두운 화면 색이 있고, Obsidian에서는 Obsidian의 밝기를, 데스크톱과 웹에서는 기기의 밝기를 따릅니다(R-OBS-10). 그래서 어두운 화면에 밝은 테마의 종이가 놓일 수 있습니다(M17의 TH2 · 1번). 반대로 밝은 화면에 어두운 테마의 종이도 놓입니다.
  • 고대비(R-NFR-07)는 두 곳에 나뉩니다. 화면은 운영체제가 더 높은 대비를 요청할 때(prefers-contrast: more) 고대비 화면 색으로 바뀝니다(3.4절). 그림은 문서의 테마로 고대비를 고릅니다(3.6절). 운영체제의 설정이 문서의 테마를 바꾸지는 않습니다. 바꾸면 저장되는 그림과 다른 사람이 보는 그림이 달라지기 때문입니다 → TM5
  • 테마가 바꿀 수 없는 것: 5장의 치수, 6장의 선 굵기, 블록의 모양, 글꼴(원칙 6).

같은 그림을 네 테마로 (왼쪽부터 밝은 테마 · 어두운 테마 · 고대비 · 흑백 인쇄)

블록의 크기와 자리는 넷이 같습니다. 그림은 골든 파일 src/packages/core/golden/render/sample*.svg를 journal/assets/2026-11-03-theme-shots.mjs로 찍은 것입니다.

9. 렌더링 규칙

9.1 픽셀에 맞추기

설계 문서는 확대해서 보고 인쇄합니다. 100% 배율에서 곧은 선은 픽셀 격자에 맞춥니다.

  • 그림 전체를 반 픽셀 옮깁니다(translate(.5 .5)). 그러면 정수 좌표에 놓은 1px 선이 한 픽셀 줄을 꼭 채웁니다.
  • 홀수 굵기(1px, 3px)의 선은 가운데가 반 픽셀에, 짝수 굵기(2px)의 선은 가운데가 정수 픽셀에 오게 놓습니다. 그래서 3px인 접기 영역 테두리와 선택 하이라이트는 블록의 경계에서 1px 안에 가운데를 둡니다.
  • 가로세로 사각형과, 가로세로로만 이은 채우지 않은 경로(Case 갈래 선, 호출 막대)에 shape-rendering="crispEdges"를 씁니다. 빗금과 곡선은 안티앨리어싱 그대로 둡니다.
  • 테두리 안의 테두리는 1px 틈을 두므로, 겹치거나 이어져도 선이 하나로 뭉개지지 않습니다.

9.2 배율과 출력

어디서1px은규칙
편집 화면 100%화면의 1 CSS px9.1의 규칙으로 곧음
편집 화면 40 ~ 300%배율만큼 굵어짐벡터로 다시 그리므로 흐려지지 않음. 선 굵기도 함께 커짐(그림의 비례를 지킴). 배율 × 화면 배율(devicePixelRatio)이 정수가 아니면 화면에서만 크리스프 도형의 stroke-width를 max(1, round(굵기 × 배율)) / 배율로 맞춰 언제나 정수 장치 픽셀로 그림(1px 선이 1px과 2px로 섞이는 것을 막음). 줌 · 화면 배율이 바뀌면 다시 맞추고, 저장하는 그림은 바뀌지 않음
고해상도 화면 (2배)물리 2픽셀반 픽셀 문제가 사라짐
Obsidian 노트에 넣은 SVG노트 폭에 맞춰 줄어들 수 있음50%까지 줄면 1px 선이 옅어짐. 선은 0.5px까지, 본문은 6.5px, 보조 텍스트는 6px까지 내려감
PDF와 인쇄0.75pt (96dpi 기준)가장 가는 선 0.75pt, 가장 작은 텍스트 9pt

9.3 흑백 인쇄 팔레트의 값

테마 print(흑백 인쇄)의 값입니다. 원시 토큰은 white(#ffffff) · black(#000000)입니다.

의미 토큰값
paper, 모든 block.*, fold.band, peek.band #ffffff
line.structure, text.*, fold.edge, fold.name, peek.edge, peek.name #000000
syntax.*text.primary와 같음 (강조 끔)

9.4 움직임

움직임은 두지 않습니다. 접기와 펴기, 펴 보기, 선택은 바로 바뀝니다. 편집기는 키보드로 빠르게 다루는 도구라, 움직임이 입력을 기다리게 해서는 안 됩니다.

  • 상태 표시줄의 알림은 나타날 때 색을 바꾸지 않습니다 → NT1. info 알림은 6초 뒤 사라지고, warn 알림은 닫거나 다음 알림이 올 때까지 남습니다.
  • 키 힌트는 0.4초를 기다렸다가 한 번에 나타나고 한 번에 사라집니다(서서히 나타나지 않음). 기다리는 것은 키를 잘 아는 사람의 화면이 깜박이지 않게 하려는 것입니다.
  • 키나 휠로 선택한 블록이 화면 밖으로 나가면 캔버스가 따라 움직입니다. 이것은 바로 이동합니다(부드러운 스크롤 없음).
  • 운영체제의 “움직임 줄이기” 설정(prefers-reduced-motion)을 따릅니다.

10. 접근성 검증

방법: 대비율은 WCAG 2.2의 상대 휘도로 계산했습니다. 색각 이상은 Machado(2009) 행렬로 색 차이 ΔE(CIE76)를 계산하고, Chrome의 시각 결함 에뮬레이션으로 그림을 찍었습니다. 흑백 명도는 CIELAB의 L*입니다. 계산은 journal/assets/2026-10-17-color-check.py가 합니다.

10.1 대비율

3.3 · 3.5 · 3.6 · 9.3절의 표가 결과입니다. 네 테마의 모든 텍스트와 뜻을 가진 선이, 쓰이는 모든 배경에서 기준을 넘습니다. 밝은 테마 · 어두운 테마 · 흑백 인쇄는 AA(텍스트 4.5:1, 선 3:1), 고대비는 텍스트와 선 모두 7:1입니다. 편집 레이어의 표시는 네 테마 모두에서 3:1을 넘습니다(3.4절). 단위 테스트(theme.test.ts, overlay.test.ts)가 테마마다 이 기준을 확인하므로, 테마의 색을 바꾸면 기준에 미달하는 쌍이 바로 드러납니다. 기준에 미달하는 쌍은 실제로 함께 쓰이지 않는 쌍뿐입니다. 예를 들어 펴 보인 호출 블록의 띠 위에는 구문 강조가 없습니다(띠의 텍스트는 peek.name 한 색).

밝은 테마에서 기준에 미달하는 쌍:

쌍대비율쓰임
syntax.comment / peek.band4.31쓰이지 않음
syntax.literal / peek.band4.16쓰이지 않음
text.muted / peek.band4.19글자로는 쓰이지 않음. 같은 색의 펼침 삼각형(edit.toggle)은 이 띠 위에 그리며, 도형이라 기준은 3:1

10.2 색각 이상과 흑백

같은 그림을 흑백 · 녹색맹 · 적색맹 · 청색맹으로 봄

네 그림 모두에서 블록 종류가 모양으로 구분됩니다(원칙 2).

색이 가까워지는 쌍보통 ΔE가장 가까울 때그래도 구분되는 이유
If 배경 / Event 배경8.7적색맹 1.1빗금과 모자
반복 배경 / 호출 배경5.2적색맹 2.5왼쪽 띠와 세로 이중선
주석 / 숫자56적색맹 9.2주석은 //로 시작하고 줄 끝까지 감

10.3 키보드와 포커스

  • 선택한 블록의 테두리가 키보드 포커스의 자리입니다. 선택한 것이 없으면 캔버스 안쪽 테두리가 1초만 보입니다(포커스가 올 때, 빈 곳을 클릭할 때, 아무 일도 하지 않은 키를 누를 때). 환경 설정의 “캔버스 포커스 테두리 늘 보이기”를 켜면 항상 보입니다. 항상 보이는 방식이 있어 WCAG 2.4.7(포커스가 보이는 방식이 하나는 있어야 함)을 채웁니다. 캔버스 포커스 테두리(ui.accent)는 종이가 아니라 종이 바깥의 배경(ui.bg) 위에 그립니다. 밝은 종이 위에서는 어두운 화면 색의 ui.accent가 2.3:1밖에 되지 않습니다 → CF2
  • 편집 레이어의 모든 표시는 색과 함께 모양(테두리, 줄, 커서, 상태 표시줄의 텍스트)로도 알립니다.

11. 명세와 지금 코드가 다른 곳

지금은 명세와 코드가 다른 곳이 없습니다.

12. 미결정 사항

  • 비례폭 글꼴(분기 라벨 등의 자리, 그리고 블록 텍스트를 문장으로 쓰는 문서). 아직 없다. 들인다면 블록 텍스트의 언어가 아닌 다른 문서 설정으로 고르게 한다. 그래야 이미 저장한 파일이 다시 배치되지 않는다 (ADR-0034, ADR-0042)
  • 화면의 나머지(툴바, 메뉴, 모달, 설정 화면, 아이콘)의 모습. 배포 대상마다 그 앱의 모습을 따를지, 공통 모습을 둘지. 웹의 배치는 화면 배치에서 정했고, 아이콘의 그림과 색이 남았습니다
  • 이름이 중복된 헤더에 붙이는 표시의 모양 (R-BLK-10)
  • 어두운 화면 색에서 종이를 화면에서만 조금 어둡게 할지 (저장되는 색은 그대로)
  • 화면에서만 그림을 고대비로 보는 “보기 전용” 선택(저장되는 그림과 다른 사람의 화면은 문서의 테마 그대로)을 둘지. 지금은 고대비가 필요하면 문서의 테마를 고대비로 바꾼다 → TM5
  • 운영체제의 강제 색 모드(forced-colors: active, Windows의 대비 테마)에서 그림을 그대로 둘지, 운영체제의 색으로 바꿀지. 지금은 따로 다루지 않는다(테스트하지 않음)
  • 사용자가 테마를 더 만들 수 있게 할지(사용자 정의 테마)