> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 파일 변환 문제

> 문서 형식 변환 문제 해결

Word 문서를 Markdown으로 변환할 때 발생하는 일반적인 문제를 해결합니다.

## 변환 실패

**문제:** Word 문서가 변환되지 않거나 오류가 표시됩니다.

**해결책:**

* 파일이 유효한 `.docx` 형식인지 확인 (`.doc` 또는 다른 형식이 아님)
* 파일이 손상되거나 암호로 보호되지 않았는지 확인
* Microsoft Word에서 열어 다시 저장해 보기
* 변환 전 암호 보호 제거
* 대안으로 먼저 `.txt`로 변환
* 파일 크기 확인 (매우 큰 파일은 실패할 수 있음)

## 서식이 잘못 보임

**문제:** 변환된 Markdown에 서식 문제가 있습니다.

**해결책:**

* 고급 서식이 있는 복잡한 Word 문서의 경우 이것은 정상
* 에디터를 사용하여 Markdown 서식 수동 조정
* 원본 Word 문서 단순화 (복잡한 스타일, 표 등 제거)
* 단순화 후 다시 변환
* 많은 서식이 있는 콘텐츠에는 일반 텍스트 붙여넣기 사용

## 변환된 파일을 찾을 수 없음

**문제:** 변환이 완료되었지만 `.md` 파일을 찾을 수 없습니다.

**해결책:**

* 원본 `.docx` 파일과 **동일한 폴더** 확인
* 같은 이름에 `.md` 확장자가 있는 파일 찾기
* 파일 관리자 새로고침 (새로고침 아이콘)
* 프로젝트에서 `.md` 파일 검색
* 다시 변환 시도

## 변환 후 이미지 누락

**문제:** Word 문서의 이미지가 Markdown에 나타나지 않습니다.

**해결책:**

* 이미지는 Markdown에 수동으로 배치해야 함
* Word 문서에서 이미지를 별도로 추출
* `images/` 폴더에 이미지 배치
* Markdown에 이미지 참조 수동 추가: `![대체 텍스트](경로)`

## 일괄 변환 작동하지 않음

**문제:** 여러 파일을 한 번에 변환할 수 없습니다.

**해결책:**

* **Markdown Hub** 플러그인이 설치되어 있는지 확인
* 폴더의 모든 파일이 `.docx` 형식인지 확인
* 먼저 개별적으로 파일 변환 시도
* 폴더 권한 확인
* SoloEnt 재시작하고 다시 시도

## 특수 문자 깨짐

**문제:** 특수 문자나 영어가 아닌 텍스트가 올바르게 표시되지 않습니다.

**해결책:**

* 원본 Word 문서의 인코딩 확인
* UTF-8 인코딩이 사용되는지 확인
* 올바른 인코딩으로 Word 문서 다시 저장
* Markdown 에디터에서 문자 수동 수정

<Card title="파일 변환 가이드로 돌아가기" icon="file-import" href="../tips/file-format-conversion">
  메인 변환 가이드로 돌아가기
</Card>
