PubAX › kordoc › 마크다운으로 한글(HWPX) 보고서 만들기

마크다운으로 한글(HWPX) 보고서 만들기

AI가 쓴 마크다운 초안을 한글에서 바로 열리는 HWPX 보고서로 바꿉니다. 공문서 프리셋이 개조식 기호와 요약 상자를 넣습니다.

1. 초안 쓰기

복사# 민원 처리 기간 단축 추진계획

> 민원 처리 기간을 줄이기 위해 접수 절차를 바꾸고자 함

## 추진 배경

- 평균 처리 기간 7일

| 구분 | 금액 |
| --- | --- |
| 인건비 | 1,000 |

# 제목 바로 뒤 인용문(> …하고자 함)이 보고서 요약 상자가 됩니다. 목적을 한 문장, 3줄 안으로 씁니다.

2. HWPX로 만들기

복사npx kordoc generate 보고서.md --preset 보고서 -o 보고서.hwpx

목록 기호 -는 공문서 개조식 기호(□ 등)로 바뀝니다. 계획서·개조식 프리셋도 있습니다. 기관명과 결재란은 아래 옵션으로 넣습니다.

복사npx kordoc generate 보고서.md --preset 보고서 --org 기관명 --approval 담당,팀장,과장 -o 보고서.hwpx

3. 표기법 검사

복사npx kordoc lint 보고서.hwpx --gate --preset 보고서

공문서 표기법과 문체를 검사하고, 고칠 곳이 있으면 목록으로 알려 줍니다.

기안문 양식 채우기

표준 일반기안문(gian)과 간이기안문(gian-simple)이 들어 있습니다.

복사npx kordoc fill --list-templates
npx kordoc fill --template gian -j 값.json -o 기안문.hwpx

코드에서

복사import { markdownToHwpx } from "kordoc"
import { writeFile } from "node:fs/promises"

const hwpx = await markdownToHwpx("# 추진계획\n\n본문", { gongmun: { preset: "보고서" } })
await writeFile("보고서.hwpx", Buffer.from(hwpx))