한글 문서 스타일 딸깍 v1.0

마크다운(.md) 파일을 한컴오피스 양식(.hwpx)에 맞춰 자동 변환하는 도구

1. 소개

한글 문서 스타일 딸깍은 마크다운 파일을 한글(HWP) 양식에 맞춰 변환합니다. 사용자가 가진 한컴오피스 양식 파일(.hwpx)을 분석해서, 양식의 위계·폰트·표 스타일을 그대로 따르는 새 문서를 만듭니다.

사용 시나리오

보고서·연구자료·정책 제안서 등을 마크다운으로 빠르게 작성한 뒤, 본인이 쓰는 한컴 양식에 자동으로 맞추고 싶을 때 사용합니다. 본문 글꼴·여백·표 스타일 같은 시각 정보는 양식이 책임지고, 사용자는 내용 작성에만 집중할 수 있습니다.

핵심 특징

한컴 양식 그대로 — 양식 .hwpx 의 정의를 100% 보존
설치 X · 로그인 X — 브라우저에서 바로 작동, 파일은 모두 본인 컴퓨터에 남음
표·다이어그램 자동 변환 — 마크다운 표, ASCII 박스 다이어그램, 이미지 모두 자동 처리
양식 재사용 — 한 번 설정한 양식을 파일로 내보내 다른 PC·동료와 공유

2. 사용 흐름

이 도구는 화면 상단에 3개의 탭이 있고, 좌→우 순서로 진행합니다.

1 문서 스타일 설정

한컴 양식(.hwpx) 또는 저장된 양식 파일(.md2hwpx-preset)을 불러옵니다. 어떤 스타일을 사용할지 선택합니다.

2 표 스타일 설정

마크다운의 표가 어떤 디자인(외곽선·헤더 음영 등)으로 변환될지 정합니다. 양식 안 표를 그대로 쓰거나, 기본 디자인 중 선택, 직접 디자인할 수 있습니다.

3 스타일 매칭 및 변환

마크다운(.md) 파일을 입력하고, # 같은 마크다운 요소를 양식의 어떤 스타일에 연결할지 매칭한 뒤 변환합니다. 결과 .hwpx 가 다운로드됩니다.

한 번 설정해두면 끝

자주 쓰는 양식은 1️⃣ 탭에서 저장해두면, 다음에는 카드 한 번 클릭으로 불러올 수 있습니다. 매칭 정보도 함께 저장돼서 .md 만 새로 넣고 바로 변환할 수 있습니다.

3. 문서 스타일 설정

이 탭에서는 변환에 사용할 양식을 선택합니다. 양식이란 한컴 보고서의 폰트·여백·위계 부호·표 스타일 같은 모든 시각 정보를 정의하는 .hwpx 파일입니다.

3.1 양식 불러오기

화면은 좌·우 2단으로 나뉩니다.

좌측: 저장된 프리셋 — 카드 형태로 표시됩니다.
- 📦 기본 배지 — 도구에 내장된 양식 (경북연구원 정책연구보고서 등)
- 💾 저장 배지 — 사용자가 저장한 양식
우측: 선택된 스타일 — 현재 적용 중인 양식의 정보를 한눈에 보여줍니다.

새 양식 업로드

보유한 한컴 양식 파일(.hwpx)을 화면에 끌어 놓거나(드래그·드롭), 좌측 상단 파일 선택 버튼으로 업로드합니다. 자동 분석이 즉시 시작됩니다.

이전에 저장한 양식 파일 불러오기

.md2hwpx-preset 파일을 업로드하면 양식 + 사용자 설정(선택한 스타일·매칭 정보)이 함께 복원됩니다. 다른 PC 로 작업 환경을 그대로 옮길 때 유용합니다.

3.2 사용할 스타일 선택

양식 안에는 보통 30~50개의 스타일이 정의되어 있습니다. 그 중에는 본문·제목 같은 실제 사용하는 것 외에, 엑셀 등 외부 프로그램에서 따라온 흔적도 섞여 있습니다. 사용자가 어떤 스타일을 매칭 후보로 둘지 선택할 수 있습니다.

스타일은 3개 그룹으로 자동 분류됩니다:

그룹	의미	기본 동작
✓ 실사용	양식 본문에서 실제 사용된 스타일	모두 체크됨
△ 거의 미사용	1~5회 사용된 스타일 (예: 표 주석)	모두 체크됨
⚠ 미사용	0회 사용 — 외부 출처 추정 또는 양식에만 정의된 스타일	외부 출처는 자동 제외

각 스타일 행의 [▼] 버튼을 클릭하면 폰트·크기·정렬·줄간격 같은 상세 정보가 펼쳐집니다. 체크박스를 직접 켜고 끄거나, [☑ 모두 선택] · [☐ 자동 추천] 버튼으로 일괄 처리할 수 있습니다.

권장

대부분의 경우 자동 추천 그대로 두는 것이 좋습니다. 외부 출처 스타일이 매칭 후보에서 빠지면 드롭다운 선택지가 깔끔해집니다.

3.3 양식 저장하기

양식 + 사용자 설정을 두 가지 방법으로 저장할 수 있습니다.

[💾 프리셋 저장] — 이 브라우저에 저장 (좌측 카드 그리드에 새 카드로 표시)
[💾 .md2hwpx-preset 내보내기] — 파일로 다운로드 (다른 PC 이동·동료 공유용)

저장 전에 이름과 설명 입력란이 활성화됩니다. 양식의 용도를 알아볼 수 있게 적어주세요.

중요

브라우저에 저장한 프리셋은 캐시를 지우면 사라집니다. 영구 보관하려면 반드시 .md2hwpx-preset 으로 내보내기도 함께 하세요.

4. 표 스타일 설정

이 탭은 마크다운에 등장하는 표가 어떤 디자인의 한컴 표로 변환될지 정합니다. 표의 외곽선·내부선·헤더 행 음영·정렬 같은 시각 정보를 한 곳에서 관리합니다.

4.1 표 프리셋 선택

좌측 그리드에 표 프리셋 카드가 있습니다. 카드를 클릭하면 우측에 미리보기가 즉시 표시됩니다.

프리셋	설명
GDI 정책과제	경북연구원 보고서 기본 — 외곽 굵은 선 + 헤더 음영
단순 격자	모든 선이 얇은 격자형
외곽선 없음	외곽선·내부선 모두 없는 깔끔한 스타일

4.2 양식 그대로

양식 .hwpx 안에 표 디자인이 정의되어 있으면, 📂 양식 그대로 카드가 자동으로 생깁니다. 이 카드를 선택하면 양식 안에 있는 표 디자인을 100% 그대로 사용합니다. 사용자가 직접 디자인 손볼 필요 X.

기본 추천

양식 hwpx 를 업로드했다면 양식 그대로 가 자동으로 활성화됩니다. 대부분의 경우 이 상태로 두는 게 가장 정확합니다.

4.3 직접 디자인

우측 패널에 그래픽 스타일러가 있습니다. 표의 각 부분(외곽 4변 + 내부 가로·세로선 + 헤더 행 + 본문 셀)을 시각적으로 클릭해서 색·굵기를 바꿀 수 있습니다.

표의 영역을 클릭 → 선 종류·굵기·색 변경 팝오버 표시
스포이드 아이콘으로 화면의 다른 색 직접 추출 가능
변경이 마음에 들면 [💾 저장] 으로 사용자 프리셋으로 보관 (이름·설명 함께)

5. 매칭 및 변환

이 탭이 실제로 마크다운 파일을 한컴 .hwpx 로 변환하는 곳입니다. 화면은 좌(.md 입력) · 우(매핑 + 변환 버튼) 2단입니다.

5.1 마크다운 입력

좌측 큰 텍스트 영역에 마크다운을 입력합니다. 3가지 방법이 있습니다.

드래그·드롭 — .md 파일을 텍스트 영역에 끌어다 놓습니다.
파일 불러오기 — [📂 .md 파일 불러오기] 버튼으로 선택합니다.
직접 입력·붙여넣기 — 텍스트 영역에 바로 작성하거나, AI 채팅에서 받은 결과를 붙여넣습니다.

5.2 매핑 확인

우측의 매핑 표는 마크다운에 실제 등장한 요소(# ## - 1. 등) 마다 한 행씩 나타납니다. 각 행 우측의 드롭다운에서 양식의 어떤 스타일에 연결할지 선택합니다.

각 요소 옆 숫자(53회 등)는 본문에서 등장 횟수
🔍 아이콘 클릭으로 본문에서 해당 요소가 어디에 있는지 차례로 점프
드롭다운 옆 미리보기 텍스트(한컴바탕 · 9pt · 가운데 정렬 등) 로 어떤 스타일인지 확인

자동 추천

처음 .md 를 입력하면 도구가 양식의 스타일 이름(예: "장", "제1절", "1.", "▮")을 보고 매핑을 자동으로 추천합니다. 대부분 그대로 두고 변환해도 됩니다.

5.3 변환 + 다운로드

우측 하단 [✨ 변환 + 다운로드] 버튼을 누르면, 양식 안의 모든 시각 정보를 유지한 채 새 .hwpx 파일이 즉시 다운로드됩니다. 한컴오피스에서 열어 확인하세요.

변환 결과

결과 .hwpx 는 양식의 모든 폰트·여백·위계 부호·페이지 설정을 보존합니다. 매칭한 마크다운 요소들은 양식의 해당 스타일로 자동 적용됩니다.

6. 마크다운 작성 규칙

이 도구는 표준 마크다운(CommonMark + GFM) 을 지원합니다. 아래는 자주 쓰이는 문법과 한컴 변환 시 적용되는 결과입니다.

6.1 제목 (#)

# 제1장 (H1)
## 1절 (H2)
### 1.1 (H3)
#### 가. (H4)
##### ① (H5)
###### 본문 (H6)

각 단계가 양식의 어떤 스타일에 연결될지는 3️⃣ 매칭 탭에서 정합니다. 양식별로 위계 부호(▮ ❍ - ※)는 자동으로 적용되므로 본문에 직접 적지 않습니다.

6.2 강조·인라인

마크다운	표시
`굵게`	굵게
`기울임`	기울임
`~~취소선~~`	~~취소선~~
`코드`	`코드` (고정폭 글꼴)
`[링크 텍스트](https://example.com)`	파란색 + 밑줄 + 하이퍼링크

6.3 리스트

- 첫 번째 항목
- 두 번째 항목
  - 들여쓰기로 하위 항목

1. 번호 매김
2. 두 번째
3. 세 번째

글머리 기호(-)와 번호 리스트(1.)는 매핑 표에서 각각 어떤 스타일에 연결할지 정합니다. 들여쓰기는 양식의 깊이별 스타일에 자동 매칭됩니다.

6.4 표

| 구분  | A항목  | B항목  |
|------|--------|--------|
| 2024 | 100    | 200    |
| 2025 | 150    | 250    |

첫 행은 자동으로 헤더 행으로 처리됩니다 (음영·굵게 등은 2️⃣ 표 스타일 설정 탭의 프리셋 따름)
셀 안에서 줄바꿈이 필요하면 <br> 을 사용합니다.
셀 안 인라인 서식(굵게, 기울임) 도 지원됩니다.

6.5 이미지

![대체 텍스트](https://example.com/image.png)

![인라인 데이터](data:image/png;base64,iVBORw0...)

이미지는 일반 URL 또는 data URI 모두 지원됩니다. 변환 시 한컴 .hwpx 안에 임베드되어 인터넷 연결 없이도 표시됩니다.

CORS 제약

외부 URL 이미지는 사이트가 cross-origin 허용을 안 하면 가져올 수 없습니다. 그런 경우 대체 텍스트(![설명]) 만 표시됩니다.

6.6 박스·다이어그램

ASCII 박스 다이어그램 — 자동으로 한컴 표로 변환

┌──────┬──────┐
│ 항목 │ 값   │
├──────┼──────┤
│ A    │ 100  │
│ B    │ 200  │
└──────┴──────┘

이런 형태로 입력하면 한컴 표 element 로 직접 변환됩니다. 폰트나 화면 크기에 따라 선이 어긋날 일 X.

화살표 다이어그램 — 자동으로 그림(SVG)으로 변환

입력 → 처리 → 출력
        ↓
       검증

화살표(→ ← ↑ ↓) 가 포함된 다이어그램은 그림(SVG → PNG)으로 자동 변환되어 .hwpx 에 임베드됩니다.

7. 자주 묻는 문제

Q. 변환된 .hwpx 가 한컴오피스에서 안 열려요

한컴오피스 2018 이상에서 정상 작동합니다. 한글 2014 이하 또는 일부 옛 버전에서는 HWPX 자체를 못 읽을 수 있습니다. 한컴오피스 최신 버전 또는 한컴 무료 뷰어로 확인해주세요.

Q. 한글 글꼴이 깨져서 표시돼요

변환된 .hwpx 는 한컴바탕·한컴고딕 같은 한컴 기본 글꼴을 참조합니다. 다른 PC 에서 열 때 그 글꼴이 설치되어 있지 않으면 다른 글꼴로 대체됩니다. 한컴오피스 설치 시 기본 글꼴이 함께 설치되므로 보통 문제 X.

Q. 마크다운에 없던 줄이 결과에 끼어 있어요

양식 .hwpx 가 표지·목차 등 본문 외 내용을 포함한 경우, 변환 결과의 머리말·꼬리말에 일부가 남을 수 있습니다. 빈 양식(템플릿) 으로 시작하면 더 깔끔합니다.

Q. 박스 다이어그램이 그림으로 변환되지 않아요

박스 문자(┌ ┐ └ ┘ │ ─)가 충분히 많이 (보통 5개 이상 + 전체 라인의 15% 이상) 포함되어야 자동 인식됩니다. 의도적으로 표 형태(┌─┬─┐)를 갖춘 경우는 한컴 표로 변환, 화살표가 섞이면 그림으로 변환됩니다.

Q. 한 번 매칭한 정보를 다시 쓰고 싶어요

1️⃣ 탭에서 [💾 프리셋 저장] 을 하면 양식 + 선택된 스타일 + 표 스타일이 함께 저장됩니다. 다음에 카드를 클릭하면 .md 만 새로 넣어서 바로 변환할 수 있습니다.

Q. .md2hwpx-preset 파일은 어떻게 동료와 공유하나요?

1️⃣ 탭의 [💾 .md2hwpx-preset 내보내기] 로 파일을 다운로드한 뒤 동료에게 전달합니다. 받은 사람은 같은 탭에서 그 파일을 업로드하면 양식·매칭 정보가 그대로 복원됩니다.

Q. 작업한 내용은 어디에 저장되나요?

모든 처리는 본인 브라우저 안에서 끝납니다. 양식 파일·마크다운·결과 .hwpx 어느 것도 외부 서버로 전송되지 않습니다. 저장된 프리셋도 브라우저 IndexedDB 에 보관됩니다.

한글 문서 스타일 딸깍 — 한 번 설정해두면 마크다운만 넣어도 양식에 맞는 .hwpx 가 딸깍 나옵니다.