누름틀 변환

누름틀이란

한컴오피스의 누름틀(Click-Here 필드)은 문서 안에 편집 가능한 양식 필드를 삽입하는 기능입니다. 사용자는 필드를 클릭해 값을 입력할 수 있고, 비어있을 때는 작성자가 지정한 안내문이 회색/빨강 이탤릭으로 placeholder처럼 보입니다.

각 누름틀은 세 가지 속성을 가집니다.

• 필드 이름 — 필드 식별자 (예: prompt, answer_1)
• 안내문 — 비어있을 때 표시되는 힌트 텍스트 (예: "발문을 입력하세요")
• 입력값 — 사용자가 실제로 채운 내용

Markdown 출력 포맷

docpler는 누름틀을 다음 토큰으로 직렬화합니다.

{{필드명: 안내문 --> 입력값}}

세 필드를 모두 보존해 LLM·후처리 파서·QTI 변환기가 필드 의미를 잃지 않고 재조립할 수 있습니다.

상태별 표현

판별 기준

누름틀이 "비어있음"인지 "채워짐"인지는 두 신호를 함께 확인합니다.

1. HWP 내부 "채워짐" 플래그 (CTRL_HEADER의 flag 바이트 0x80 비트)
2. 표시 텍스트 ≠ 안내문

둘 중 하나라도 "채워짐"을 가리키면 --> 입력값 부분을 포함해 출력합니다.

예시

비어있는 누름틀

HWP에서 다음과 같이 만든 누름틀이:

• 필드 이름: prompt
• 안내문: 발문
• 입력값: (비어있음)

다음 Markdown으로 변환됩니다.

아래가 누름틀입니다.
{{prompt: 발문}}

채워진 누름틀

• 필드 이름: prompt2
• 안내문: 발문2
• 입력값: 하하하

{{prompt2: 발문2 --> 하하하}}

표 안의 누름틀

셀 내부에 포함된 누름틀도 셀 텍스트에 인라인으로 병합됩니다.

|셀1|셀2|
|---|---|
|셀3 {{nrt_in_table: 표 누름틀}}|셀4|

활용 시나리오

템플릿 문서

HWP로 제작한 공문·계약서·신청서 템플릿을 {{name}} 토큰이 포함된 Markdown으로 내보내면, 이후 Jinja/Handlebars 류 템플릿 엔진이나 LLM이 값을 채워 재생성하는 파이프라인에 바로 투입할 수 있습니다.

평가/학습 콘텐츠

안내문이 문항 지시문(예: "다음 글을 읽고 고르시오"), 입력값이 정답 또는 예시 응답인 경우 누름틀 토큰으로부터 필드명·지시문·응답을 구조적으로 복원할 수 있어 평가 콘텐츠 변환 파이프라인의 중간 포맷으로 사용할 수 있습니다.

제한 사항

• 다른 필드 타입(%hlk 하이퍼링크, %bmk 북마크, 상호참조 등)은 현재 표시 텍스트만 출력되고 필드 메타는 보존되지 않습니다.
• 안내문 또는 입력값에 {{, }}, -->, : 같은 토큰 구분자가 그대로 포함되면 재파싱 시 모호해질 수 있습니다 (실제 문서에서는 거의 발생하지 않음).
• "양식 모드에서 편집 가능" 체크박스 상태는 현재 출력에 반영되지 않습니다.