# LaTeX를 Typst로

LaTeX 초안을 살펴보고 저장하거나 새 프로젝트로 열 수 있는 Typst 소스로 바꿉니다.

LaTeX를 Typst로 도구는 Typst의 빠른 로컬 작업 흐름을 쓰고 싶은데 자료가 이미 LaTeX에 있을 때 출발을 도와줍니다. 흔히 쓰는 문서 구조와 수식을 옮겨 오고, 저자만 내릴 수 있는 결정은 열어 둔 채로 남깁니다.

## 잘 맞는 경우

- 표준 절, 본문, 목록, 링크, 표, 수식으로 이루어진 논문이나 노트
- 기존 초안이 Typst에 맞는지 시험해 볼 때
- 다시 입력하지 않고 내용을 옮길 때

작업이 출판사 클래스, 방대한 매크로 계층, Typst에 대응하는 것이 없는 패키지에 의존한다면 LaTeX에 머무르세요. 변환한다고 해서 학술지가 다른 소스 형식을 받아 주는 것은 아닙니다.

## 소스 변환하기

1. **LaTeX를 Typst로**를 열거나 `/latex-to-typst` 명령을 실행하세요.
2. LaTeX 소스를 붙여 넣으세요.
3. **변환**을 선택하세요.
4. 생성된 Typst를 읽고, 변환 메모가 있으면 함께 확인하세요.
5. 복사하거나, `converted.typ` 파일로 저장하거나, Typst 프로젝트를 만들어 컴파일하세요.

표준 `\section`, 단락, 글머리 기호 목록, 별행 수식은 대응하는 Typst 요소로 바뀝니다. `\newcommand{\model}{...}` 같은 사용자 정의 명령은 직접 Typst 함수나 변수로 바꿔야 할 수 있습니다.

## 이식 결과 검토하기

내장 Pandoc 변환은 이 컴퓨터에서 실행되며, 생성된 Typst에 호환성 정리를 적용합니다. LaTeX 패키지의 동작이나 문서 클래스의 시각적 규칙은 재현하지 않습니다.

다음을 확인하세요.

- 사용자 정의 매크로와 환경
- 수식 구문과 번호
- 그림 경로와 캡션
- 표와 상호 참조
- 참고문헌과 인용 스타일
- 페이지 설정과 타이포그래피

Typst 버전이 컴파일되고 전체 PDF를 비교해 볼 때까지 원본 프로젝트를 보관하세요. 반대 방향에는 [Typst를 LaTeX로](/docs/tools/typst-to-latex/)를 쓰세요.

## 프로젝트 전체 변환하기

이 도구는 붙여 넣은 텍스트를 변환합니다. 파일, 그림, 참고문헌이 여러 개인 LaTeX 프로젝트라면 프로젝트를 열고 명령 팔레트에서 **Typst 프로젝트로 변환**을 실행하세요. 별도의 Typst 프로젝트를 만들고, 컴파일하고, 확인이 필요한 항목을 보고합니다. 과정은 [Typst 프로젝트](/docs/typst/#convert-a-latex-project-to-typst)에서 차근차근 안내합니다. 수식 하나라면 [수식을 Typst로](/docs/tools/equation-to-typst/)가 더 빠릅니다.