update-hwpx-differences
SKILL.md
HWPX-Markdown 차이점 문서 업데이트
이 스킬은 HWPX와 Markdown 간의 차이점 문서(docs/hwpx-markdown-differences.md)를 자동으로 업데이트합니다.
사용 시점
다음과 같은 경우에 이 스킬을 사용하세요:
- 새로운 변환 문제 발견: HWPX 파싱 중 Markdown으로 표현할 수 없는 새로운 요소 발견
- 새로운 처리 방법 구현: 기존 차이점에 대한 새로운 변환 로직 추가
- 기존 문서 개선: 더 나은 설명이나 예시 추가 필요
실행 단계
1. 현재 문서 확인
docs/hwpx-markdown-differences.md
파일을 읽어 현재 문서화된 차이점 목록을 확인합니다.
2. 새로운 차이점 추가
다음 형식으로 새 항목을 추가합니다:
### N. [차이점 이름]
| 항목 | 설명 |
|------|------|
| **HWPX** | [HWPX에서의 동작/기능] |
| **Markdown** | [Markdown의 제한사항] |
| **변환 방식** | [hwp2markdown의 처리 방법] |
**예시:**
- HWPX: [원본 예시]
- Markdown: [변환된 결과 예시]
**관련 코드:** `[파일 경로]` - `[함수명]` 함수
---
3. 번호 재정렬
새 항목 추가 후 전체 번호가 순차적인지 확인합니다.
4. 날짜 업데이트
문서 하단의 마지막 업데이트 날짜를 오늘 날짜로 변경합니다:
*마지막 업데이트: YYYY-MM-DD*
차이점 카테고리
문서에 포함할 수 있는 차이점 유형:
| 카테고리 | 설명 |
|---|---|
| 레이아웃 | 페이지, 여백, 단 나누기 등 |
| 테이블 | 병합, 중첩, 스타일 등 |
| 텍스트 | 글꼴, 색상, 특수 문자 등 |
| 객체 | 이미지, OLE, 수식 등 |
| 구조 | 각주, 목차, 참조 등 |
예시: 새 차이점 추가
상황: <hp:tab/> 요소가 Markdown에서 지원되지 않음을 발견
추가할 내용:
### 11. 탭 문자 (Tab Character)
| 항목 | 설명 |
|------|------|
| **HWPX** | `<hp:tab/>` 요소로 탭 정렬 지원 |
| **Markdown** | 탭은 코드 블록 들여쓰기로만 사용 |
| **변환 방식** | 탭을 공백 4개로 변환 |
**예시:**
- HWPX: `이름<hp:tab/>홍길동`
- Markdown: `이름 홍길동`
**관련 코드:** `internal/parser/hwpx/parser.go` - `readElementText()` 함수
---
주의사항
- 기존 항목의 번호나 구조를 변경할 때는 다른 문서의 참조도 확인
- 코드 변경과 문서 업데이트는 같은 커밋에 포함
- 예시는 실제 테스트 파일(
testdata/한글 테스트.hwpx)에서 가져오는 것이 좋음
Weekly Installs
4
Repository
roboco-io/hwp2mdGitHub Stars
24
First Seen
Feb 22, 2026
Security Audits
Installed on
mcpjam4
claude-code4
replit4
junie4
windsurf4
zencoder4