# 문서

연결부터 문제 해결까지, 문서 내보내기가 작동하는 방식입니다.

## 연결

문서 카드에서 “연결”을 누르고 문서가 있는 폴더를 고릅니다. 하위 폴더를 포함해 그 안의 모든 것을 읽습니다. 패널은 `~/Documents`에서 열리며 새 폴더를 만들 수 있습니다. 그다음 “내보낼 폴더 선택”을 누르고 `~/Documents/converted` 같은 별도 폴더를 고릅니다.

내보내기 폴더는 문서 폴더나 그 안의 폴더일 수 없고, 문서 폴더도 내보내기 폴더 안에 있을 수 없습니다. 앱에서 둘 다 고를 수 없게 되어 있습니다.

## 파일이 저장되는 위치

각 결과물은 폴더 안에서 원본 문서가 있는 자리에 같은 폴더 구조로 놓입니다. `report.md`가 생기고, HTML을 선택했다면 그 옆에 `report.html`도 생깁니다. 한 폴더에 이름이 같은 문서가 두 개 있으면 파일 이름에 확장자가 남습니다: `report-pdf.md`, `report-docx.md`. `~/Documents`처럼 홈 폴더 바로 아래의 폴더를 고르면 그 안에 `documents-export` 폴더가 생기고, 더 깊은 폴더는 그대로 사용됩니다.

## 읽는 파일

| 종류 | 파일 |
| --- | --- |
| Word와 텍스트 | `.doc`, `.docx`, `.docm`, `.odt`, `.rtf` |
| 슬라이드 | `.ppt`, `.pps`, `.pot`, `.pptx`, `.pptm`, `.ppsx`, `.ppsm`, `.odp` |
| 스프레드시트 | `.xls`, `.xlsx`, `.xlsm`, `.xlsb`, `.ods`, `.csv` |
| PDF와 도서 | `.pdf`, `.epub` |

제외되는 것: Pages, Numbers, Keynote 파일(먼저 Word, PowerPoint, Excel 또는 PDF로 내보내세요), 숨김 파일, 패키지 안의 파일, 심볼릭 링크. 탭은 목록을 거릅니다: “전체”, “PDF”, “Word”, “슬라이드”, “시트”, “도서”, “스캔”.

## 스캔한 페이지

텍스트가 없는 PDF 페이지는 Mac에서 Apple의 텍스트 인식으로 읽으며, 아무것도 업로드되지 않습니다. 읽을 수 없는 페이지는 `> <n>페이지: 스캔된 페이지를 읽을 수 없습니다`가 됩니다. 텍스트 인식은 PDF에서만 동작합니다.

## Markdown과 HTML

`format` 행에서 “Markdown”, “HTML” 또는 둘 다 선택합니다. 적어도 하나는 선택된 상태로 남습니다. 한 번의 동기화로 두 형식을 모두 쓰는 앱은 문서뿐입니다. HTML은 스타일 없는 단순한 형식입니다. MCP 서버는 Markdown만 읽습니다.

## 파일

| 키 | 담는 내용 |
| --- | --- |
| `title` | 확장자를 뺀 파일 이름 |
| `source` | 문서 폴더 안에서 문서의 경로 |
| `format` | 원본 확장자 |
| `pages` | PDF의 페이지 수 |
| `scanned` | 텍스트 인식으로 페이지를 읽었으면 `true` |
| `modified` | 문서를 마지막으로 변경한 시각 |

```markdown
---
title: "Quarterly report"
source: "Work/Quarterly report.pdf"
format: pdf
pages: 12
scanned: true
modified: 2026-08-30T17:02:11Z
---

# Quarterly report
```

## 무료와 잠금 해제

선택한 문서 중 최근 수정한 문서 10개는 무료로 변환되며, 한 문서의 두 형식은 한 번으로 셉니다. 나머지에는 일회성 잠금 해제가 필요합니다([가격](https://exporter.dev/pricing)).

## 동기화와 전체 재동기화

처음 “지금 동기화”를 누른 뒤로는 Exporter가 실행 중인 동안 폴더를 지켜보다가, 저장하고 몇 초 뒤에 바뀐 것을 변환합니다. Markdown이 이미 문서보다 최신인 문서는 열지 않고 건너뛰므로 큰 폴더도 빠르게 유지됩니다. 행 끝의 변환 버튼은 선택 여부와 상관없이 그 문서 하나를 바로 변환합니다. 삭제한 문서의 결과물은 다음 동기화 때 빠집니다.

“전체 재동기화”는 먼저 확인을 요청한 다음, 내보내기 폴더에서 Exporter가 쓴 파일만 지우고 문서를 다시 변환합니다.

## 문제와 해결 방법

- 행의 빨간 삼각형은 “이 문서는 암호로 보호되어 있습니다”나 “이 문서는 손상되어 내용의 일부가 없습니다”처럼 문서 변환에 실패한 이유를 보여줍니다. 문서를 만든 앱에서 고친 다음 행 끝의 변환 버튼을 누르세요
- 행에 자물쇠와 “무료 한도에 도달했습니다 · 이 문서를 변환하려면 문서 잠금을 해제하세요”가 표시됨: 무료 10개를 넘은 문서입니다
- “해당 폴더를 열 수 없습니다”: 문서 폴더가 이동했거나 드라이브가 마운트되지 않았습니다. “연결”을 다시 누르세요
- Pages, Numbers, Keynote 파일이 없음: Word, PowerPoint, Excel 또는 PDF로 내보내면 그 결과물이 변환됩니다

## Related

- [Documents](https://exporter.dev/documents): Word, slides, sheets and PDFs to Markdown
- [Documents guides](https://exporter.dev/guides/documents): Documents Claude can read
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/ko/docs/documents
every page: https://exporter.dev/llms.txt