> ## 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 문서를 Markdown 형식으로 변환하여 SoloEnt로 가져옵니다.

## 단일 파일 변환

개별 `.docx` 파일을 Markdown으로 변환합니다:

<Steps>
  <Step title="파일 찾기">
    파일 관리자에서 `.docx` 파일을 찾습니다.
  </Step>

  <Step title="우클릭">
    파일을 우클릭하여 컨텍스트 메뉴를 엽니다.
  </Step>

  <Step title="변환">
    메뉴에서 \*\*"Markdown으로 변환"\*\*을 선택합니다.
  </Step>

  <Step title="완료 대기">
    파일이 자동으로 변환됩니다. 동일한 위치에 새 `.md` 파일이 나타납니다.
  </Step>
</Steps>

<Info>
  원본 `.docx` 파일은 변경되지 않습니다. 변환된 Markdown 파일이 새 파일로 생성됩니다.
</Info>

## 일괄 변환

"**Markdown Hub**" 플러그인을 사용하여 여러 Word 문서를 한 번에 변환합니다:

<Steps>
  <Step title="Markdown Hub 설치">
    1. 왼쪽 사이드바의 **확장** 아이콘을 클릭합니다 (세 번째 아이콘)
    2. \*\*"Markdown Hub"\*\*를 검색합니다
    3. **설치**를 클릭합니다 (무료)
  </Step>

  <Step title="파일 정리">
    변환하려는 모든 `.docx` 파일을 같은 폴더에 둡니다.
  </Step>

  <Step title="폴더 우클릭">
    `.docx` 파일이 있는 폴더를 우클릭합니다.
  </Step>

  <Step title="모두 변환">
    \*\*"Markdown으로 변환"\*\*을 선택하여 폴더의 모든 문서를 일괄 변환합니다.
  </Step>
</Steps>

<Tip>
  일괄 변환을 사용하여 기존 작품 라이브러리 전체를 한 번에 가져오세요.
</Tip>

## 지원 형식

| 형식      | 가져오기 | 내보내기 | 비고      |
| ------- | ---- | ---- | ------- |
| `.docx` | ✅    | ❌    | Word 문서 |
| `.md`   | ✅    | ✅    | 기본 형식   |
| `.txt`  | ✅    | ✅    | 일반 텍스트  |
| `.pdf`  | ❌    | ✅    | 내보내기 전용 |

<Note>
  Markdown(`.md`)은 SoloEnt의 기본 형식입니다. 모든 편집 기능이 Markdown 파일에서 가장 잘 작동합니다.
</Note>

## 변환 품질

### 잘 변환되는 항목

* **텍스트 콘텐츠**: 단락, 제목, 목록
* **기본 서식**: 굵게, 기울임, 밑줄
* **구조**: 챕터, 섹션, 하위 섹션

### 조정이 필요할 수 있는 항목

* **복잡한 표**: 수동 서식이 필요할 수 있음
* **이미지**: images 폴더에 수동으로 배치해야 함
* **사용자 지정 스타일**: 표준 Markdown 서식으로 변환됨
* **주석 및 변경 내용 추적**: 보존되지 않음

<Warning>
  변환된 파일의 서식 문제를 검토하세요. 복잡한 Word 문서는 수동 정리가 필요할 수 있습니다.
</Warning>

## 변환 후

<Steps>
  <Step title="콘텐츠 검토">
    변환된 Markdown 파일을 열고 서식 문제를 확인합니다.
  </Step>

  <Step title="서식 수정">
    깔끔하게 변환되지 않은 요소를 조정합니다.
  </Step>

  <Step title="파일 정리">
    적절한 폴더로 파일을 이동합니다 (챕터, 아웃라인 등).
  </Step>

  <Step title="편집 시작">
    가져온 콘텐츠로 작업을 시작합니다.
  </Step>
</Steps>

<Tip>
  **Agent에게 작업 맡기:** Agent에게 이러한 작업을 자동으로 처리하도록 요청하세요. 예: "변환된 파일을 검토하고 서식 문제를 수정해 줘" 또는 "가져온 파일을 챕터 폴더로 정리해 줘."
</Tip>

## 모범 사례

<AccordionGroup>
  <Accordion title="Word 문서 준비">
    * 표준 스타일 사용 (제목 1, 2, 3 등)
    * 복잡한 서식 피하기
    * 변환 전 불필요한 스타일 제거
  </Accordion>

  <Accordion title="먼저 한 파일로 테스트">
    * 품질 확인을 위해 단일 파일 변환
    * 필요시 Word 문서 조정
    * 그 다음 일괄 변환 진행
  </Accordion>

  <Accordion title="원본 백업">
    * 원본 `.docx` 파일 보관
    * 변환 전 백업 저장
    * 필요시 언제든 다시 변환 가능
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="변환 실패">
    * 파일이 유효한 `.docx` 형식인지 확인
    * 파일이 손상되거나 비밀번호로 보호되지 않았는지 확인
    * Word에서 열어 다시 저장 시도
    * 해결 방법으로 먼저 `.txt`로 변환
  </Accordion>

  <Accordion title="서식이 이상해 보임">
    * 복잡한 문서의 경우 정상
    * Markdown 서식 수동 조정
    * 원본 Word 문서 단순화 후 다시 변환
  </Accordion>

  <Accordion title="변환된 파일을 찾을 수 없음">
    * 원본과 동일한 폴더 확인
    * 같은 이름에 `.md` 확장자인 파일 찾기
    * 파일 관리자 새로고침
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="에디터 기능" icon="pen-to-square" href="../essentials/editor">
    Markdown 편집 배우기
  </Card>

  <Card title="프로젝트 정리" icon="folder-tree" href="../essentials/create-project">
    가져온 파일 정리하기
  </Card>
</CardGroup>