# 프로젝트 내보내기와 변환

최신 PDF를 저장하고, 편집 가능한 소스를 패키징하고, 페이지 이미지나 HTML로 내보내고, Typst에서 PDF/A와 PDF/UA를 만들거나, LaTeX, Typst, Markdown 문서를 변환합니다.

프로젝트 도구 모음에서 **내보내기**를 엽니다. 이 메뉴는 현재 문서 엔진과 유형에 맞춰지므로, Oleafly가 그 프로젝트에서 실행할 수 있는 경로만 보여 줍니다.

![내보내기는 상단 프로젝트 바에서 다시 컴파일 바로 뒤에 있는 다운로드 컨트롤입니다.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## 받는 사람에게 필요한 출력 고르기

- **PDF**는 읽기, 인쇄, 대부분의 투고 포털에 쓰입니다.
- **소스 ZIP**은 원고, 그림, 참고문헌, 로컬 스타일이 필요한 공저자나 시스템에 쓰입니다.
- **페이지 PNG**는 이미지를 요구하는 슬라이드, 메시지, 검토 시스템에 쓰입니다.
- **Typst가 작성하는 PNG, SVG, HTML**은 모든 페이지를 이미지, 벡터 페이지, 웹 페이지로 받아야 하는 Typst 프로젝트에 쓰입니다.
- **Word, HTML, Markdown, Typst, LaTeX, 일반 텍스트**는 다른 형식으로 내용을 편집하거나 재사용해야 하는 사람에게 쓰입니다.
- **PowerPoint**는 발표 자료나 Markdown 문서를 슬라이드로 바꿀 때, **EPUB**은 전자책 리더용입니다. 어떤 형식이 나타나는지는 엔진에 따라 다릅니다. [발표 자료와 도서 내보내기](#presentation-and-book-exports)를 참고하세요.

## PDF, 소스 아카이브, 페이지 이미지 저장

1. 출력에 최신 편집 내용이 담기도록 **다시 컴파일**을 선택합니다.
2. 마지막 페이지와 참고문헌을 포함해 PDF를 확인합니다.
3. **내보내기**를 엽니다.
4. **PDF로 내보내기**, **소스 내보내기(.zip)**, **페이지를 PNG로 내보내기** 중 하나를 선택합니다.
5. 저장 대화상자에서 저장 위치를 고릅니다.
6. 완료 메시지의 **폴더에서 보기**를 선택해 저장된 파일을 찾습니다.

프로젝트에 PDF가 생길 때까지 PDF와 페이지 이미지 동작은 비활성 상태이며, 메뉴에 **PDF를 만들려면 먼저 컴파일해야 합니다**라고 표시됩니다. **PDF로 내보내기**는 미리보기에 표시된 PDF를 저장합니다. **페이지를 PNG로 내보내기**는 미리보기에서 보고 있는 페이지를 고해상도로 저장합니다.

소스 아카이브에는 빌드 캐시와 Git 내부 파일이 들어 있지 않습니다. 심볼릭 링크도 빠지며, 건너뛴 개수는 완료 메시지가 알려 줍니다.

### PDF가 최신이 아닐 때

미리보기가 오래되었어도 Oleafly는 PDF나 페이지 이미지를 저장하며, 완료 메시지가 그 사실을 알려 줍니다.

- 컴파일이 실패한 뒤에는 마지막 컴파일이 실패했으므로 파일이 불완전할 수 있다고 알려 줍니다.
- 컴파일하지 않은 편집이 있으면 파일이 마지막 컴파일에서 나왔으며 최신 편집 내용이 들어 있지 않다고 알려 줍니다.

누군가에게 파일을 보내기 전에 다시 컴파일하고, 미리보기를 확인한 다음, 다시 내보내세요.

## Typst 이미지와 HTML

Typst 프로젝트의 내보내기 메뉴에는 **이미지와 HTML**도 있으며, 이를 선택하면 **Typst로 내보내기**가 열립니다. 이 파일들은 Typst가 직접 그리므로 PNG와 SVG 페이지는 PDF와 똑같이 보입니다.

- **PNG 이미지**는 **해상도**를 72, 144, 300, 600 PPI 중에서 정합니다.
- **SVG 이미지**는 페이지를 벡터 그래픽으로 유지합니다.
- **HTML**은 **실험적**으로 표시됩니다. Typst의 HTML은 텍스트와 이미지는 유지하지만 페이지 설정과 도형은 빼먹습니다. Typst 0.15 이전에는 수식도 빠지며, HTML을 고르면 대화상자가 그렇게 알려 줍니다.

PNG와 SVG에서 **페이지**에는 `1, 3-5`나 `8-`처럼 페이지 번호와 범위를 입력할 수 있습니다. 비워 두면 모든 페이지를 내보냅니다. 각 페이지는 선택한 이름 뒤에 번호가 붙은 별도 파일로 저장됩니다. 페이지 범위는 Typst 0.12 이상, HTML은 Typst 0.13 이상이 필요합니다. 대화상자에는 프로젝트의 Typst 버전이 할 수 있는 것만 표시됩니다. 프로젝트에 [빌드 변형](/docs/typst/#build-variants-and-sysinputs)이 있다면, 내보내기는 컴파일 메뉴에서 선택한 변형을 사용합니다.

## Typst에서 PDF/A와 PDF/UA 만들기

Typst는 보관용 PDF와 접근 가능한 PDF를 직접 작성합니다. 프로젝트 레일의 **방패**를 열어 [프리플라이트](/docs/preflight/)로 이동한 다음, **접근성** 검사 아래의 **PDF 표준**을 찾으세요. PDF/A-2b나 PDF/UA-1 같은 **표준**을 고르고 **PDF 내보내기**를 선택합니다.

목록은 프로젝트의 Typst 버전에 따라 달라집니다. Typst 0.11에는 없고, Typst 0.12는 PDF/A-2b를, Typst 0.13은 PDF/A-3b를 더하며, Typst 0.14 이상은 모든 PDF/A 수준과 PDF/UA-1을 제공합니다. Typst 0.14 이상은 모든 PDF에 스크린 리더용 태그도 달기 때문에 태그 컴파일이 따로 없습니다. PDF/UA-1에는 문서 제목과 모든 이미지의 대체 텍스트가 필요하며, 프리플라이트가 둘 다 검사합니다.

## 편집 가능한 형식

| 프로젝트 엔진 | 내보내기의 형식 |
| --- | --- |
| **LaTeX** | Word, MathML이 포함된 자체 완결형 HTML, Markdown, Typst, 일반 텍스트 |
| **Typst** | LaTeX, Word, MathML이 포함된 자체 완결형 HTML, Markdown, 일반 텍스트 |
| **Markdown** | Word, MathML이 포함된 자체 완결형 HTML, Typst, LaTeX, 일반 텍스트 |

Typst 프로젝트는 EPUB도, Markdown 프로젝트는 PowerPoint와 EPUB도 제공합니다. LaTeX 프로젝트는 문서 클래스가 맞을 때만 제공합니다.

이 변환은 Pandoc을 통해 로컬에서 실행됩니다. Oleafly는 컴퓨터에 있는 호환되는 설치를 쓰거나, 처음 필요할 때 검증된 관리형 빌드를 내려받습니다.

Typst 프로젝트는 다른 경로를 거칩니다. Typst가 먼저 문서를 HTML로 작성하고, Pandoc이 그 HTML을 Word, HTML, Markdown, LaTeX, 일반 텍스트, EPUB로 바꾸므로 수식과 참조가 그대로 넘어옵니다. 문서가 이 경로를 거칠 수 있는지는 프로젝트의 Typst 버전에 따라 달라집니다.

| Typst 버전 | 경로 |
| --- | --- |
| 0.15 이상 | HTML을 거침 |
| 0.13과 0.14 | Typst가 문서 전체를 작성할 수 있으면 HTML을 거칩니다. 작성할 수 없으면 Pandoc이 Typst 소스를 대신 읽습니다. |
| 0.12 이하 | Pandoc이 소스를 읽음 |

Typst가 HTML을 작성하다가 오류로 멈추면 어느 버전에서든 Pandoc이 소스를 읽습니다. Typst 0.13이나 0.14에서 Pandoc이 소스를 읽을 때는, 내보내기에 경고가 없는 한 회전, 확대, 이동, 기울임이 적용된 텍스트가 빠졌을 수 있다고 완료 메시지가 경고합니다. 가장 완전하게 내보내려면 컴파일 메뉴의 **Typst 버전(이 프로젝트)**에서 프로젝트를 Typst 0.15 이상으로 바꾸세요.

HTML을 거쳐 내보내면 `align`, `grid`, `rotate` 같은 레이아웃 함수 안의 텍스트는 그대로 남습니다. CeTZ로 그린 도형은 선과 모양이 사라지고 텍스트 레이블만 남으며, Typst가 무엇을 빼먹었는지는 완료 메시지에 나옵니다.

## 문서 변환

1. 한 번 컴파일하고 소스 오류를 모두 고칩니다.
2. **내보내기**를 열고 대상 형식을 선택합니다.
3. 안내가 나오면 Pandoc 설정을 마칩니다. Pandoc을 쓸 수 없다고 Oleafly가 알려 주면 **설정 → 엔진 → Markdown**에서 **Pandoc 복구**를 선택한 다음 다시 내보내세요.
4. 제안된 확장자로 변환된 파일을 저장합니다.
5. 완료 메시지를 읽습니다. 경고가 있다고 나오면 **경고 보기**를 선택해 내보내기에서 빠진 것을 확인합니다.
6. 대상 앱에서 파일을 열어 구조와 모양을 확인합니다.

빠르게 시험하려면 제목, 수식, 표, 이미지, 인용이 들어 있는 짧은 절 하나를 내보내 보세요. 이 다섯 가지가 잘 넘어오면 전체 원고를 변환하고 다시 검토하세요.

LaTeX 프로젝트 전체를 계속 작업할 Typst 프로젝트로 바꾸려면 [Typst 프로젝트로 변환](/docs/typst/#convert-a-latex-project-to-typst)을 대신 사용하세요. 새 프로젝트를 만들고 확인이 필요한 부분을 알려 줍니다.

### 변환에서 보존되는 것

Pandoc은 제목, 문단, 목록, 링크, 인용, 표, 이미지, 편집 가능한 수식을 보존하는 것을 목표로 합니다. 소스 언어의 모든 기능을 모든 대상에서 재현하지는 못합니다. 다음 부분을 꼼꼼히 확인하세요.

- 사용자 정의 LaTeX 명령과 환경
- 손으로 다듬은 페이지 레이아웃이나 플로트
- 복잡하거나 중첩된 표
- 참고문헌 스타일과 인용 렌더링
- 대상에 직접 대응하는 것이 없는 Typst 함수
- 원시 HTML이나 Markdown 확장

HTML 내보내기는 리소스를 포함시키고 수식을 MathML로 작성합니다. 그래서 단독으로 열려야 하는 문서를 공유하는 데 유용하지만, 독자가 쓰는 브라우저에서 시험해 보는 편이 좋습니다.

### 형식별로 유지되는 것

- Word와 PowerPoint 내보내기는 PDF, SVG, WebP 그림을 220 ppi의 PNG 그림으로 바꿉니다. 소스에 크기가 없는 그림은 자기 너비를 유지합니다.
- HTML과 EPUB 내보내기는 PDF 그림을 PNG 그림으로 바꿉니다.
- LaTeX에서 내보낸 Markdown과 일반 텍스트에는 제목, 저자, 초록이 유지됩니다.
- LaTeX에서 Markdown이나 Typst로, Markdown에서 LaTeX나 Typst로 내보내면 그림 파일을 복사하지 않고 프로젝트의 그림 파일로 연결합니다. 내보내기에 경고가 없는 한, 컴파일하기 전에 이미지와 참고문헌을 내보낸 파일 옆으로 복사하라고 완료 메시지가 알려 줍니다. Typst나 LaTeX로 내보낸 Markdown 문서는 자신이 선언한 참고문헌을 유지하며, 선언하지 않았다면 프로젝트의 `.bib` 파일을 유지합니다.
- Markdown 문서를 LaTeX로 내보내면 그 문서의 [문서 유형](/docs/writing/markdown/#document-types)을 따릅니다. 슬라이드와 포스터는 Beamer 소스가 되고, 보고서나 책은 `#` 제목에서 장이 시작되며, 편지는 KOMA-Script 편지가 됩니다.
- Typst에서 LaTeX로 내보내면 문서의 이미지가 `.tex` 파일 옆의 `<name>-media` 폴더로 복사됩니다. LaTeX가 읽을 수 없으므로 SVG, GIF, WebP 이미지는 거기서 PDF가 됩니다.

내보내기는 메인 문서의 폴더, 프로젝트 루트, `\graphicspath` 폴더에서 그림을 찾으며, 확장자 없이 쓴 그림 이름도 찾아냅니다. EPS 그림은 변환할 수 없으므로 경고와 함께 그대로 파일에 들어갑니다. Markdown 문서를 Word, HTML, EPUB, PowerPoint로 내보낼 때 Mermaid 블록은 그 블록용으로 저장된 그림을 보여 줍니다.

### 내보낸 뒤의 경고

Pandoc은 형식이 담을 수 없는 것을 빼놓습니다. LaTeX나 Markdown 프로젝트에서 내보내거나 Typst 소스를 읽는 방식으로 내보내면서 그런 일이 생기면, 완료 메시지는 이미지를 복사하라는 안내 같은 다른 내용을 대신해 파일이 경고와 함께 저장되었다는 것과 그 개수를 알려 줍니다. **경고 보기**를 선택하면 빠진 것을 나열하는 **내보내기 경고**가 열립니다. 그 대화상자의 **폴더에서 보기**는 저장된 파일이 있는 폴더를 엽니다.

목록에는 다음이 나올 수 있습니다.

- 내보내기에서 빠진 블록. 알 수 있으면 파일과 줄이 함께 나오며, `tikzpicture`, `\includepdf`, `\only`나 `\uncover` 같은 Beamer 오버레이 명령이 그 예입니다
- 내보내기가 찾거나 변환하지 못한 그림
- 참고문헌에 없는 인용 키
- TeX 코드로 남은 수식
- 아직 번호가 없는 참조. 컴파일하면 해결됩니다

반복되는 경고는 한 번만 나오며 목록은 50개에서 멈춥니다. 그림이 없을 때 PowerPoint 내보내기는 다르게 동작합니다. 멈추고 파일을 저장하지 않으며, 오류가 그 그림의 이름을 알려 줍니다. HTML을 거치는 Typst 내보내기는 Typst가 무엇을 빼먹었는지 완료 메시지로 알려 줍니다.

## 발표 자료와 도서 내보내기

LaTeX 프로젝트는 문서 클래스에 따라 이를 맞춥니다. Beamer 발표 자료에는 **PowerPoint로 내보내기(.pptx)** 항목이, `book`, `report`, `memoir`, `scrbook`, `scrreprt` 클래스에는 **EPUB으로 내보내기(.epub)** 항목이 나타납니다.

Beamer 발표 자료에서는 프레임마다 새 슬라이드가 시작되고, `\section`은 섹션 슬라이드를 추가하며, `\subsection`은 추가하지 않습니다. 이미지가 둘 이상이거나 이미지와 다른 내용이 함께 있는 프레임은 두 번째 슬라이드로 넘어갈 수 있습니다.

Typst와 Markdown 프로젝트에서는 메뉴가 이 내보내기를 위해 문서를 확인하지 않습니다. Markdown 프로젝트는 항상 둘 다 제공하고, Typst 프로젝트는 항상 EPUB을 제공합니다. Markdown 문서를 PowerPoint로 바꾸면 레벨 1 제목은 각각 섹션 슬라이드가 되고 레벨 2 제목마다 새 슬라이드가 시작됩니다. 예외는 `type: slides`인 문서로, 프런트 매터의 `slide-level` 줄이 슬라이드를 시작하는 제목 레벨을 정합니다. 모든 EPUB에는 목차가 들어가며, 수식은 MathML입니다.

편집 가능한 출발점으로 사용하세요. 슬라이드 구성과 도서 조판은 형식 사이에서 일대일로 대응하는 경우가 드물므로, 대상 앱에서 모든 슬라이드나 장을 확인하세요.

## 독립형 그림 내보내기

독립형 그림 프로젝트는 컴파일한 뒤 **PDF로 내보내기(벡터 이미지)** 및 **PNG로 내보내기** 항목을 제공합니다. 어떤 크기에서도 선명한 선과 텍스트가 필요하면 PDF를 선택하세요. 대상이 래스터 이미지만 받는다면 PNG를 선택하세요.

## 프로젝트 안에 출력 저장

[PDF 미리보기](/docs/pdf-preview/)에도 **PDF를 프로젝트에 저장**이 있습니다. 이 기능은 투고용 사본이나 컴파일된 그림을 소스 옆에 보관합니다. 그 사본을 최신 상태로 유지하려면 같은 메뉴에서 [컴파일할 때 PDF 동기화](/docs/pdf-preview/#sync-pdf-on-compiles)를 켜세요. 컴파일에 성공할 때마다 Oleafly가 프로젝트 이름을 딴 PDF를 갱신합니다. 이전 PDF는 프로젝트를 복원하지 않고 [체크포인트](/docs/checkpoints/#save-a-pdf-from-a-checkpoint)에서 저장할 수 있습니다. 생성된 출력물의 버전을 관리하려는 경우에만 그 파일을 [Git 기록](/docs/git-history/)에 추가하세요.

## 공유하기 전 확인

투고하기 전에 [프리플라이트](/docs/preflight/)를 실행하세요. 태그된 PDF가 필요하면 LaTeX에서는 접근 가능한 내보내기 작업 흐름을 따르고, Typst 프로젝트에서는 PDF/UA 표준을 고른 다음, 독립적인 PDF/UA 검사기와 사람의 접근성 검토로 결과를 확인하세요. 프리플라이트는 유용한 신호를 많이 확인하지만 적합성을 인증하지는 않습니다.
