# 비주얼 Typst 편집기

분할된 글쓰기와 미리보기 레이아웃에서 바로 Typst 프로젝트를 시작합니다.

비주얼 Typst 편집기는 빈 프로젝트를 설정하는 단계를 없애 줍니다. Typst 문서를 만들고 소스를 실시간 PDF 미리보기 옆에 열어 주므로, 첫 줄부터 편집한 결과를 바로 볼 수 있습니다.

## 이 도구를 고르는 경우

Typst를 배우는 중이거나, 작은 아이디어를 서식이 갖춰진 문서로 옮기거나, 소스와 출력을 함께 보고 싶을 때 쓰세요.

화면 공간이 좁거나 편집기만 있는 레이아웃으로 시작하고 싶다면 [Typst 편집기](/docs/tools/typst-editor/)를 고르세요. 두 도구는 같은 종류의 프로젝트를 만듭니다. 처음 열리는 레이아웃만 다릅니다.

:::note["비주얼"의 뜻]
이 도구는 소스와 미리보기가 나뉜 작업 공간을 엽니다. 마크업을 숨기고 편집하려면 아무 Typst 파일에서나 편집기 툴바의 **코드**를 **비주얼**로 전환하세요. 그러면 제목, 강조, 목록, 수식, 이미지, 표, 참조가 제자리에서 렌더링되고, 커서가 있는 곳에서는 소스가 나타납니다.
:::

## 문서 시작하기

1. **설정 → 실험 기능 → LaTeX 도구**를 켜세요.
2. **비주얼 Typst 편집기**를 열거나 `/visual-typst-editor` 명령을 실행하세요.
3. Oleafly가 **제목 없는 Typst 문서**를 만들고 분할 보기로 엽니다.
4. 프로젝트 이름을 바꾸고 `.typ` 소스 파일에 작성하세요.
5. 미리보기가 준비되면 컴파일된 PDF를 내보내세요.

다음 작은 예제로 시작해 보세요.

```typst
= Results

The treatment group improved by *12%*.

$ integral_0^1 x^2 dif x = 1/3 $
```

**자동 컴파일**이 켜져 있으면 입력하는 동안 내장 Typst 엔진이 미리보기를 새로 고칩니다. 소스는 Oleafly 밖에서도 편집할 수 있는 일반 `.typ` 파일로 남습니다.

## 알아 두면 좋은 점

- Typst 컴파일과 PDF 내보내기는 로컬에서 실행됩니다.
- Typst는 LaTeX 패키지나 `tlmgr`이 아니라 Typst Universe의 패키지를 씁니다.
- LaTeX 명령은 Typst 구문으로 바로 옮겨지지 않습니다. 변환된 출발점이 필요하면 [LaTeX를 Typst로](/docs/tools/latex-to-typst/)를 쓰세요.
- **PDF로 이동**과 PDF 안에서의 클릭은 LaTeX 프로젝트에서처럼 소스와 페이지 사이를 오갑니다.

만든 뒤의 프로젝트 편집, 파일, 내보내기는 [Typst로 쓰기](/docs/writing/typst/)에서 이어 가세요. 버전, 패키지, 글꼴은 [Typst 프로젝트](/docs/typst/)에서 다룹니다.