ZPL 명령어 레퍼런스 — Zebra 프린터 치트시트
2026년 6월 11일 업데이트
이것은 실제 라벨의 대부분을 커버하는 ZPL II 명령어에 대한 실용적인 레퍼런스입니다: 형식 구조, 텍스트, 폰트, 바코드, 그래픽, 프린터 제어. 모든 위치와 크기는 프린터 도트 단위입니다(203 dpi = 8 도트/mm — 기본 내용은 ZPL이란?을 참조하세요). 구문 열에 표시된 매개변수는: x,y = 왼쪽 상단 모서리에서의 위치, h,w = 높이 및 너비, o = 방향(N 정방향, R 90°, I 180°, B 270°).
라벨 형식
| 명령어 | 구문 | 기능 |
|---|---|---|
^XA | ^XA | 라벨 형식의 시작. 모든 라벨은 이 명령으로 시작합니다. |
^XZ | ^XZ | 라벨 형식의 종료. 프린터는 이 명령을 받으면 라벨을 렌더링하고 인쇄합니다. |
^FX | ^FXcomment | 주석 — 프린터가 무시합니다. 다른 필드와 마찬가지로 ^FS로 끝냅니다. |
^PW | ^PWwidth | 도트 단위 인쇄 너비. 필드가 잘리지 않도록 라벨 너비에 맞게 설정하세요. |
^LL | ^LLlength | 도트 단위 라벨 길이. 주로 연속(비갭) 미디어에 필요합니다. |
^LH | ^LHx,y | 라벨 홈 — 이후의 모든 ^FO 위치 원점을 이동합니다. |
^PQ | ^PQqty | 인쇄 수량 — 이 라벨의 복사본을 몇 장 인쇄할지 지정합니다. |
^PR | ^PRspeed | 인치/초 단위 인쇄 속도. 느릴수록 더 진하고 선명하게 인쇄되는 경우가 많습니다. |
^MD | ^MDdarkness | 미디어 어두움 조정, -30~30. 인쇄가 흐릿하면 값을 올리세요. |
필드 및 텍스트
| 명령어 | 구문 | 기능 |
|---|---|---|
^FO | ^FOx,y | 필드 원점 — 라벨 홈에서 x,y 도트 위치에 다음 필드를 배치합니다. |
^FD | ^FDdata | 필드 데이터 — 현재 필드의 내용(텍스트 또는 바코드 데이터). |
^FS | ^FS | 필드 구분자 — 현재 필드를 닫습니다. 각 필드 뒤에 반드시 필요합니다. |
^FB | ^FBwidth,lines,space,align | 필드 블록 — ^FD 텍스트를 블록으로 래핑합니다: 최대 너비, 최대 줄 수, 줄 간격, 정렬(L/C/R/J). |
^FR | ^FR | 필드 반전 — 검은 영역과 겹치는 부분에서 필드를 흰색으로 인쇄합니다. |
^FH | ^FH | 필드 16진수 — ^FD에서 _xx 16진수 이스케이프를 허용합니다. 예: é의 경우 _C3_A9. |
^CI | ^CIencoding | 문자 집합; ^CI28은 UTF-8을 선택하며 비ASCII 텍스트에 권장됩니다. |
폰트
| 명령어 | 구문 | 기능 |
|---|---|---|
^A | ^Afo,h,w | 다음 필드의 폰트: 폰트 문자 f(0–9, A–Z), 방향, 도트 단위 높이 및 너비. ^A0N,40,40은 40 도트의 스케일러블 기본 폰트입니다. |
^CF | ^CFf,h,w | 자체 ^A를 설정하지 않는 모든 후속 필드의 기본 폰트를 변경합니다. |
^A@ | ^A@o,h,w,name | 프린터에 저장된 폰트 파일 사용(예: 다운로드한 TrueType). |
폰트 0은 스케일러블 벡터 폰트로 일반적인 선택입니다. 폰트 A–H는 고정 크기 비트맵 폰트로, 기본 크기나 정수 배수에서만 올바르게 보입니다.
바코드
| 명령어 | 구문 | 기능 |
|---|---|---|
^BY | ^BYw,r,h | 바코드 필드 기본값: 도트 단위 모듈(좁은 바) 너비, 넓음-좁음 비율, 기본 높이. 바코드 명령 전에 설정하세요. |
^BC | ^BCo,h,f,g,e,m | Code 128 — 배송 및 물류를 위한 주력 1D 바코드. f=Y면 인간이 읽을 수 있는 줄을 인쇄하고, g=Y면 코드 위에 인쇄합니다. |
^B3 | ^B3o,e,h,f,g | Code 39 — 일부 산업 및 국방 규격에서 여전히 요구하는 오래된 1D 심볼로지. |
^BE | ^BEo,h,f,g | EAN-13 소매 바코드(UPC-A는 ^BU 사용). |
^BQ | ^BQa,model,mag,ec | QR 코드. 배율 1–10으로 모듈 크기를 설정하고, ec로 오류 수정(H/Q/M/L)을 설정합니다. 인코딩 모드를 데이터 앞에 붙이세요. 예: ^FDQA,https://… |
^BX | ^BXo,h,s,c,r,f | Data Matrix — 전자부품 및 의료 라벨에서 흔히 사용되는 소형 2D 코드. |
^B7 | ^B7o,h,m,c,r,t | PDF417 — 신분증 및 일부 물류 문서에 사용되는 적층형 2D 코드. |
스캔 가능한 바코드를 위해 세 가지를 올바르게 설정하세요: 203 dpi에서 최소 2–3 도트의 모듈 너비(^BY 첫 번째 매개변수), 양쪽에 약 10 모듈 너비의 빈 공간(조용 구역), 그리고 충분한 높이(1D 바코드가 약 50 도트 미만이면 핸드헬드 스캐너로 읽기 어렵습니다).
그래픽
| 명령어 | 구문 | 기능 |
|---|---|---|
^GB | ^GBw,h,t,c,r | 그래픽 박스: 너비, 높이, 테두리 두께, 색상(B/W), 모서리 둥글기 0–8. 얇은 ^GB가 선을 그리는 방법입니다. |
^GC | ^GCd,t,c | 지름 d와 테두리 두께 t를 가진 그래픽 원. |
^GD | ^GDw,h,t,c,o | w×h 박스 안의 대각선 그래픽; o는 방향(L 또는 R)을 설정합니다. |
^GF | ^GFa,b,c,d,data | 그래픽 필드 — 비트맵(예: 로고)을 16진수 또는 이진 데이터로 라벨에 직접 포함합니다. |
~DG | ~DGd:name,t,w,data | 그래픽 다운로드 — 프린터에 이미지를 저장한 후 ^XG로 배치합니다. |
^XG | ^XGd:name,mx,my | 현재 필드 원점에 저장된 그래픽을 x/y 배율로 불러옵니다. |
프린터 제어 및 상태
| 명령어 | 구문 | 기능 |
|---|---|---|
~HS | ~HS | 호스트 상태 — 프린터가 용지 부족, 일시 정지, 버퍼, 오도미터 정보로 응답합니다. |
~HI | ~HI | 호스트 식별 — 모델, 펌웨어 버전, DPI, 메모리. |
^MM | ^MMmode | 인쇄 모드: T 절취, P 박리, R 되감기, C 커터. |
^MN | ^MNtype | 미디어 추적: Y 갭/웹 감지, M 블랙마크, N 연속. |
~JC | ~JC | 미디어 캘리브레이션 실행(프린터가 라벨을 몇 장 이송하여 갭을 찾습니다). |
~JA | ~JA | 프린터 버퍼의 모든 라벨 형식을 취소합니다. |
^JUS | ^JUS | 전원 사이클 후에도 설정이 유지되도록 플래시에 현재 설정을 저장합니다. |
모두 합쳐보기
위 그룹 대부분을 사용한 일반적인 4×6 배송 스타일 라벨:
^XA
^PW812
^CI28
^CF0,32
^FO40,40^FDSHIP TO:^FS
^FO40,80^A0N,44,44^FDAcme Industries^FS
^FO40,130^FD500 Warehouse Way^FS
^FO40,170^FDSpringfield, IL 62701^FS
^FO40,230^GB732,3,3^FS
^FO40,260^FDOrder #A-10592 / 3 of 4^FS
^BY3,2,120
^FO140,320^BCN,120,Y,N,N^FD4210159200083^FS
^XZ도트 좌표를 직접 편집하는 일은 금세 번거로워집니다 — 레이아웃을 조금만 바꿔도 숫자를 수정하고 다시 인쇄해야 합니다. 필드를 직접 드래그하여 배치하고 ZPL이 자동으로 작성되기를 원한다면, 아래 ZPLCraft 편집기가 시각적 캔버스를 바로 이런 깔끔한 ZPL로 컴파일하며, 브라우저에서 USB로 인쇄할 수도 있습니다.
이 치트시트를 넘어선 자세한 매개변수별 설명을 위한 권위 있는 출처는 Zebra 공식 ZPL II 프로그래밍 가이드이며, Zebra 지원 사이트에서 무료로 제공됩니다.