docx

name	docx
description	마케팅 문서 제작을 위한 Word 문서 생성/편집 도구
version	1.0.0
author	Dante Labs
tags	["document","word","marketing","report"]

Marketing Document Toolkit

마케팅 기획서, 브랜드 가이드, 제안서 등 전문 Word 문서를 제작하고 편집하는 도구입니다.

주요 기능

기능	설명	용도
새 문서 생성	마크다운 → DOCX	기획서, 가이드 작성
기존 문서 편집	OOXML 편집	텍스트/스타일 수정
텍스트 추출	DOCX → 텍스트	문서 분석
변경 추적	Redlining	협업 및 검토

Workflow 1: 새 문서 생성 (Markdown → DOCX)

Pandoc을 사용한 변환

# 기본 변환
pandoc input.md -o output.docx

# 스타일 템플릿 적용
pandoc input.md --reference-doc=template.docx -o output.docx

# 목차 포함
pandoc input.md --toc --toc-depth=3 -o output.docx

Python-docx를 사용한 생성

from docx import Document
from docx.shared import Inches, Pt, RGBColor
from docx.enum.text import WD_ALIGN_PARAGRAPH
from docx.enum.style import WD_STYLE_TYPE

def create_marketing_document(content, output_path):
    """마케팅 문서 생성"""
    doc = Document()

    # 스타일 설정
    style = doc.styles['Normal']
    font = style.font
    font.name = 'Malgun Gothic'
    font.size = Pt(11)

    # 제목 스타일
    title_style = doc.styles['Title']
    title_style.font.size = Pt(28)
    title_style.font.color.rgb = RGBColor(0x1a, 0x36, 0x5d)

    # 제목 추가
    title = doc.add_heading(content['title'], 0)
    title.alignment = WD_ALIGN_PARAGRAPH.CENTER

    # 부제목
    subtitle = doc.add_paragraph(content['subtitle'])
    subtitle.alignment = WD_ALIGN_PARAGRAPH.CENTER

    doc.add_page_break()

    # 목차 (수동)
    doc.add_heading('목차', level=1)
    for i, section in enumerate(content['sections'], 1):
        doc.add_paragraph(f"{i}. {section['title']}", style='List Number')

    doc.add_page_break()

    # 본문 섹션
    for section in content['sections']:
        doc.add_heading(section['title'], level=1)

        for para in section['paragraphs']:
            doc.add_paragraph(para)

        # 테이블이 있는 경우
        if 'table' in section:
            add_styled_table(doc, section['table'])

    doc.save(output_path)
    return output_path

def add_styled_table(doc, table_data):
    """스타일링된 테이블 추가"""
    rows = len(table_data)
    cols = len(table_data[0])

    table = doc.add_table(rows=rows, cols=cols)
    table.style = 'Table Grid'

    # 헤더 행 스타일링
    header_row = table.rows[0]
    for i, cell in enumerate(header_row.cells):
        cell.text = str(table_data[0][i])
        cell.paragraphs[0].runs[0].font.bold = True
        shading = cell._element.get_or_add_tcPr()

    # 데이터 행
    for row_idx in range(1, rows):
        for col_idx in range(cols):
            table.rows[row_idx].cells[col_idx].text = str(table_data[row_idx][col_idx])

    return table

Workflow 2: 기존 문서 편집 (OOXML)

DOCX 구조 이해

document.docx (ZIP)
├── [Content_Types].xml
├── _rels/
├── docProps/
│   ├── app.xml
│   └── core.xml
└── word/
    ├── document.xml      # 본문 내용
    ├── styles.xml        # 스타일 정의
    ├── settings.xml      # 문서 설정
    ├── fontTable.xml     # 폰트 테이블
    ├── numbering.xml     # 번호 매기기
    └── _rels/

텍스트 교체 스크립트

from docx import Document
import re

def replace_text_in_docx(docx_path, replacements, output_path):
    """문서 전체에서 텍스트 교체"""
    doc = Document(docx_path)

    # 본문 단락
    for para in doc.paragraphs:
        for old_text, new_text in replacements.items():
            if old_text in para.text:
                for run in para.runs:
                    run.text = run.text.replace(old_text, new_text)

    # 테이블 내 텍스트
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                    for old_text, new_text in replacements.items():
                        if old_text in para.text:
                            for run in para.runs:
                                run.text = run.text.replace(old_text, new_text)

    doc.save(output_path)
    return output_path

# 사용 예시
replacements = {
    "{{브랜드명}}": "Dante Coffee",
    "{{날짜}}": "2024년 1월 15일",
    "{{담당자}}": "김마케팅"
}
replace_text_in_docx("template.docx", replacements, "output.docx")

Workflow 3: 변경 추적 (Redlining)

변경 사항 추출

# pandoc을 사용한 tracked changes 추출
pandoc input.docx --track-changes=all -o output.md

# 변경 사항만 추출
pandoc input.docx --track-changes=accept -o accepted.md
pandoc input.docx --track-changes=reject -o original.md

변경 추적 활성화

from docx import Document
from docx.oxml.ns import qn
from docx.oxml import OxmlElement

def enable_track_changes(docx_path, output_path):
    """변경 추적 활성화"""
    doc = Document(docx_path)

    settings = doc.settings.element
    trackChanges = OxmlElement('w:trackRevisions')
    settings.append(trackChanges)

    doc.save(output_path)

마케팅 문서 디자인 가이드

컬러 팔레트

제목:        #1a365d (Navy)
부제목:      #2b6cb0 (Blue)
강조:        #ed8936 (Orange)
본문:        #2d3748 (Dark Gray)
배경:        #ffffff (White)
테이블 헤더: #f7fafc (Light Gray)

타이포그래피

요소	폰트	크기	스타일
문서 제목	맑은 고딕	28pt	Bold
장 제목 (H1)	맑은 고딕	18pt	Bold
절 제목 (H2)	맑은 고딕	14pt	Bold
소제목 (H3)	맑은 고딕	12pt	Bold
본문	맑은 고딕	11pt	Regular
캡션	맑은 고딕	9pt	Italic

페이지 레이아웃

┌─────────────────────────────────────┐
│  [로고]          마케팅 기획서       │ ← 헤더 (15mm)
├─────────────────────────────────────┤
│                                     │
│  ← 좌측 여백 25mm    우측 여백 25mm →│
│                                     │
│  # 1. 프로젝트 개요                  │
│                                     │
│  Lorem ipsum dolor sit amet...      │
│                                     │
│  ## 1.1 배경                        │
│                                     │
│  [본문 내용]                         │
│                                     │
│  ┌─────────────────────────────┐    │
│  │      테이블 / 도표           │    │
│  └─────────────────────────────┘    │
│                                     │
├─────────────────────────────────────┤
│  Dante Labs    Confidential    p.1  │ ← 푸터 (15mm)
└─────────────────────────────────────┘

스타일 가이드

리스트 스타일

• 1단계 글머리 기호 (원형)
  ◦ 2단계 글머리 기호 (빈 원형)
    ▪ 3단계 글머리 기호 (사각형)

1. 1단계 번호
   a. 2단계 영문
      i. 3단계 로마자

인용구

┌────────────────────────────────────┐
│  "핵심 인사이트나 중요한 인용구를    │
│   강조할 때 사용합니다."            │
│                        - 출처      │
└────────────────────────────────────┘

마케팅 문서 유형별 템플릿

1. 마케팅 기획서

# 마케팅 기획서

## 1. Executive Summary
- 핵심 목표
- 예상 성과
- 필요 예산

## 2. 현황 분석
### 2.1 시장 현황
### 2.2 경쟁 환경
### 2.3 SWOT 분석

## 3. 마케팅 전략
### 3.1 목표 설정
### 3.2 타겟 정의
### 3.3 포지셔닝

## 4. 실행 계획
### 4.1 채널 전략
### 4.2 콘텐츠 계획
### 4.3 일정표

## 5. 예산
| 항목 | 금액 | 비고 |
|------|------|------|

## 6. KPI 및 평가

2. 브랜드 가이드라인

# 브랜드 가이드라인

## 1. 브랜드 소개
### 1.1 브랜드 스토리
### 1.2 미션 & 비전
### 1.3 핵심 가치

## 2. 로고 사용 가이드
### 2.1 로고 버전
### 2.2 최소 크기
### 2.3 금지 사항

## 3. 컬러 시스템
### 3.1 Primary Colors
### 3.2 Secondary Colors
### 3.3 사용 비율

## 4. 타이포그래피
### 4.1 한글 서체
### 4.2 영문 서체
### 4.3 사용 지침

## 5. 적용 사례

3. 캠페인 브리프

# 캠페인 브리프

## 1. 프로젝트 개요
| 항목 | 내용 |
|------|------|
| 프로젝트명 | |
| 기간 | |
| 담당자 | |
| 예산 | |

## 2. 배경 및 목적

## 3. 타겟 오디언스
### 3.1 인구통계
### 3.2 심리특성
### 3.3 행동패턴

## 4. 핵심 메시지

## 5. 채널 및 포맷

## 6. 일정

## 7. 성과 지표

템플릿 변수 시스템

표준 변수

{{브랜드명}}      - 브랜드 이름
{{프로젝트명}}    - 프로젝트 명칭
{{날짜}}          - 문서 작성일
{{버전}}          - 문서 버전
{{담당자}}        - 담당자 이름
{{부서}}          - 부서명
{{기간_시작}}     - 프로젝트 시작일
{{기간_종료}}     - 프로젝트 종료일
{{예산}}          - 예산 금액

자동 치환 스크립트

import re
from datetime import datetime

STANDARD_REPLACEMENTS = {
    "{{날짜}}": datetime.now().strftime("%Y년 %m월 %d일"),
    "{{연도}}": datetime.now().strftime("%Y"),
}

def apply_template_variables(docx_path, custom_vars, output_path):
    """템플릿 변수 적용"""
    # 표준 변수 + 사용자 정의 변수
    all_vars = {**STANDARD_REPLACEMENTS, **custom_vars}
    return replace_text_in_docx(docx_path, all_vars, output_path)

File Storage

Word 문서는 프로젝트의 표준 디렉토리 구조에 저장합니다.

{project}/
├── reports/
│   ├── documents/           # 최종 Word 문서
│   │   ├── marketing-plan-20240115.docx
│   │   ├── brand-guidelines-20240115.docx
│   │   └── campaign-brief-20240115.docx
│   └── drafts/              # 초안 및 검토 중 문서
│       └── marketing-plan-draft-v2.docx
├── assets/
│   └── docx-resources/      # 문서 리소스
│       ├── templates/       # 템플릿 파일
│       └── images/          # 삽입용 이미지
└── tmp/
    └── docx-work/           # 작업 파일

파일 명명 규칙

{project}/reports/documents/{type}-{subject}-{date}.docx

예시:
reports/documents/marketing-plan-q1-20240115.docx
reports/documents/brand-guidelines-dante-coffee-20240115.docx
reports/documents/campaign-brief-spring-20240115.docx

버전 관리

{filename}-v{version}.docx
{filename}-draft-v{version}.docx
{filename}-final.docx

예시:
marketing-plan-v1.docx
marketing-plan-v2.docx
marketing-plan-final.docx

패키지 설치

# 필수 패키지
pip install python-docx

# 선택적 패키지
# pandoc (시스템 설치 필요)
brew install pandoc  # macOS
apt install pandoc   # Ubuntu

스크립트 및 레퍼런스

레퍼런스 문서

문서	경로	설명
OOXML 편집 가이드	ooxml.md	Word XML 편집 및 Tracked Changes 가이드

스크립트

스크립트	경로	설명
document.py	scripts/	Document 클래스 (댓글, 변경 추적)
utilities.py	scripts/	XMLEditor 유틸리티

OOXML 도구

스크립트	경로	설명
unpack.py	ooxml/scripts/unpack.py	DOCX → XML 추출 (RSID 생성)
pack.py	ooxml/scripts/pack.py	XML → DOCX 패킹
validate.py	ooxml/scripts/validate.py	XML 스키마 및 Redlining 검증

템플릿 파일

파일	경로	설명
comments.xml	scripts/templates/	댓글 템플릿
commentsExtended.xml	scripts/templates/	확장 댓글 템플릿
commentsExtensible.xml	scripts/templates/	확장 가능 댓글 템플릿
commentsIds.xml	scripts/templates/	댓글 ID 템플릿
people.xml	scripts/templates/	작성자 정보 템플릿

Usage

이 스킬은 brand-strategist, copy-strategist, campaign-director 에이전트가 마케팅 문서 제작 시 참조합니다.