이런 분께
공문이나 지침을 한글(HWP) 파일로 받아서, 챗GPT·노트북LM에 요약을 맡기기 전에 한글을 열고 내용을 일일이 복사해 붙이던 분께 맞아요. 파일이 수십 개라 하나씩 열어 복사하기 어려운 분에게 특히 쓸모 있어요.
끝나면 이렇게 됩니다
명령어 한 줄로 한글 파일이 같은 이름의 .md(마크다운, 제목과 표 모양을 살린 글자 파일)로 바뀌어요.
지침_2026.hwp → 지침_2026.md
# 2026년 업무 지침
## 1. 목적
| 구분 | 담당 | 기한 |
|---|---|---|
| 접수 | 민원팀 | 10.31 |
이 .md 파일은 챗GPT, 클로드, 노트북LM 어디에나 바로 올릴 수 있어요. 제목과 표가 살아 있어서 AI가 "3번 항목 담당이 누구야?" 같은 질문에도 잘 답해요.
준비물
- pyhwp2md(한글 파일을 마크다운으로 바꿔 주는 무료 오픈소스, MIT 라이선스, 2026년 10월 기준 0.1.3)
- uv(파이썬 프로그램을 설치 없이 바로 실행해 주는 무료 도구)
- 지원 형식: .hwp(HWP 5.0 이상), .hwpx
- 윈도우 또는 맥, 인터넷 연결
따라 하기
- 터미널(컴퓨터에 글자로 명령하는 창)을 열어요. 윈도우는 시작 메뉴에서 'PowerShell', 맥은 Spotlight에서 '터미널'을 검색해요.
- uv를 설치해요. 내 컴퓨터에 맞는 한 줄을 붙여 넣고 엔터를 눌러요. 끝나면 터미널 창을 닫고 새로 열어요.
윈도우: winget install --id=astral-sh.uv -e
맥: curl -LsSf https://astral.sh/uv/install.sh | sh
- 한글 파일이 있는 폴더로 이동해요. 바탕화면의 '공문' 폴더라면
cd Desktop\공문(윈도우),cd ~/Desktop/공문(맥)이에요. - 아래 명령어로 바꿔요. 파일 이름만 내 것으로 고쳐요.
uvx pyhwp2md 지침_2026.hwp -o 지침_2026.md
- 같은 폴더에 생긴 .md 파일을 챗GPT나 노트북LM에 올리고, 아래 프롬프트로 물어요.
복사해서 쓰는 프롬프트
첨부한 문서는 한글 공문을 글자로 바꾼 거야.
1. 우리 [팀/부서]가 해야 할 일만 골라 표로 정리해줘 (할 일 | 기한 | 근거 문단)
2. 날짜나 숫자는 원문 그대로 옮겨줘
3. 문서에 없는 내용은 추측하지 말고 "문서에 없음"이라고 써줘
[팀/부서]에는 '민원팀', '총무과'처럼 내 소속을 넣어요.
AI에게 통째로 맡기기
위 가이드대로 한글 파일을 .md로 바꾸고 싶어. 내 컴퓨터는 [윈도우/맥]이야. 한 단계씩 안내해줘.
자주 막히는 곳
막히면 아래 증상부터 확인해요. 오류 문구가 나오면 그대로 복사해 AI에게 물어봐도 돼요.
- 'uvx'를 찾을 수 없다고 나올 때: uv 설치 직후 같은 창을 쓰면 이래요. 터미널을 닫고 새로 열어요.