DOCX 제작기 (docx-creator)
OpenXML 기반으로 마크다운을 실무용 Word(.docx) 문서로 변환하고, 중문 계약서급 조판 규칙과 시각 검증까지 강제하는 스킬입니다.
문서·오피스고급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 마크다운 원고를 바로 납품 가능한 .docx로 변환하는 C# OpenXML 생성기(
scripts/Program.cs)를 제공합니다. minimax-skills:minimax-docx엔진을 올바르게 구동하는 방법을 정리한 얇은 레이어입니다. 엔진 코드는 포함하지 않고, 엔진만으로는 해결되지 않는 실전 함정을 채워줍니다.- 핵심 규칙 4가지를 강제합니다.
- 정렬 계층화: 제목은 가운데, 조항 제목은 왼쪽, 甲方/乙方·서명란처럼 줄바꿈이 포함된 문단은 반드시 왼쪽 정렬(양쪽 정렬 시 글자 간격이 벌어져 깨짐).
- 목록 번호 1부터 재시작: 목록마다 별도
NumId+StartOverrideNumberingValue=1. - CJK 폰트 이중 슬롯:
RunFonts의 Ascii/HighAnsi/EastAsia를 모두 지정(본문 宋体, 제목 黑体). - 페이지·표 기본값: A4 11906×16838 twips, 여백 1440, 표는 6개 테두리 전부 지정, 가운데 정렬 푸터
PAGE필드.
- 시각 검증 체인 강제: 생성 → XSD 검증 →
soffice --headlessPDF 변환 →pdftoppm -png→ 모든 페이지 이미지 확인. macOSqlmanage썸네일 사용은 금지(정작 중요한 버그를 숨김). references/known_issues.md에 ISSUE-001~011로 증상·원인·해결·검증이 기록돼 있습니다.
이런 분께 추천
- 중국어 계약서, 협의서, 공문, 오퍼레터, 노동계약서 등 형식이 엄격한 Word 문서를 자주 만드는 분
- 마크다운으로 작업하고 결과물은 Word로 제출해야 하는 실무자
- Word에서 열면 정렬이 깨지거나 목록 번호가 이어지는 문제로 고생한 경험이 있는 분
- .NET 실행 환경과 LibreOffice 설치가 가능한 개발/운영 환경 사용자
활용 예시
- 노동계약서 작성: 조항을 마크다운으로 정리한 뒤
dotnet run --project _docxgen -- contract.md contract.docx로 생성. 甲方/乙方 정보 블록과 서명·날인란이 벌어지지 않은 상태로 출력됩니다. - 마크다운 보고서 → Word 납품: 기존
report.md를 변환하고, PDF→PNG 변환 후 전체 페이지를 눈으로 확인해 표 테두리와 페이지 번호까지 검수합니다. - 서식 커스터마이즈:
Program.cs의 폰트 크기(본문 24 half-point = 12pt, H1 36 = 18pt)를 사내 규정에 맞게 수정해 회사 표준 템플릿 생성기로 재활용합니다.
PDF 결과물이 필요하면 이 스킬이 아니라
daymade-docs:pdf-creator를 사용하세요.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-docs/docx-creator 폴더를 내 ~/.claude/skills/docx-creator/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/daymade-docs/docx-creator ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 사전 준비물 확인
- .NET SDK (
dotnet --version) - LibreOffice (
soffice --version) — 시각 검증용 PDF 변환 - Poppler의
pdftoppm(macOS:brew install poppler) - 엔진 플러그인
minimax-skills:minimax-docx설치 (보통~/.claude/plugins/marketplaces/minimax-skills/skills/minimax-docx/)
- .NET SDK (
- 저장소 클론
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더 복사
mkdir -p ~/.claude/skills cp -r claude-code-skills/daymade-docs/docx-creator ~/.claude/skills/ - Claude Code 재시작 후 "Word 문서 만들어줘" / "계약서 docx로 작성해줘" 같이 요청하면 스킬이 자동 호출됩니다.
- 첫 실행 테스트: 작업 폴더에서 생성기를 스테이징하고 실행합니다.
첫 실행은 NuGet 패키지 복원으로 약 20초 걸립니다.mkdir -p _docxgen && cp ~/.claude/skills/docx-creator/scripts/Program.cs \ ~/.claude/skills/docx-creator/scripts/mmdocx-gen.csproj _docxgen/ dotnet run --project _docxgen -- sample.md sample.docx - 검증 체인 실행:
soffice --headless --convert-to pdf --outdir /tmp/docxcheck sample.docx→pdftoppm -png -r 100 /tmp/docxcheck/sample.pdf /tmp/docxcheck/page후 모든 PNG를 확인합니다. - 문제가 생기면
references/known_issues.md와scripts/README.md를 먼저 읽어보세요.
GitHub에서 원본 보기 ↗라이선스: MIT