시작하기

Typst는 매우 가벼운 실행 파일로 빌드할 수 있는 오픈 소스 프로젝트입니다. 설치가 매우 간편하며 웹 브라우저에서도 바로 사용할 수 있습니다. Typst 팀이 직접 관리하고 개발하며, 이들의 주력 제품은 웹 기반의 Typst 전용 에디터입니다.

Typst를 활용하는 방법은 크게 두 가지입니다. 공식 웹 앱을 사용하거나, 로컬 환경에 직접 설치하여 평소 사용하는 에디터로 작업하는 방식입니다. 이 장에서는 각 방식의 장단점을 간략히 살펴보겠습니다.

웹 앱 (WebApp)

가장 간단하게 시작하는 방법은 typst.app에 가입하고 새 문서를 만드는 것입니다. 가입 후 바로 입력을 시작하면 오른쪽 미리보기 패널에서 실시간으로 렌더링된 결과를 확인할 수 있습니다.

처음에는 이것저것 직접 시도해 보시는 것을 추천합니다. Typst의 작동 방식이 어느 정도 익숙해지면, 잘 만들어진 템플릿 을 가져와서 바로 내용을 채워 넣을 수 있습니다. 물론 필요한 스타일을 처음부터 직접 만드는 것도 Typst에서는 어렵지 않습니다.

장점:

• 별도의 설정 없이 바로 시작 가능
• 강력한 협업 기능 제공
• 풍부한 기능: Typst 팀이 공을 들여 만든 스마트 맞춤법 검사나 전문가를 위한 Vim 키 바인딩 등 유용한 기능이 많습니다.
• 오프라인 작업 지원: 페이지가 한 번 로드되면 오프라인 상태에서도 작업할 수 있습니다. 문서 컴파일이 서버가 아닌 사용자의 브라우저에서 이루어지므로 인터넷 연결 없이도 실시간 수정이 가능하며, 변경 사항은 로컬에 저장됩니다.
• 여러 기기에서 동일한 프로젝트를 이어가기 편리함
• Typst Pro (유료): 협업 시 댓글 기능, GitHub 연동 등 고급 기능을 제공합니다. 이는 프로젝트를 후원(GitHub Sponsors 등)하거나 기여하여 응원할 수 있는 좋은 방법이기도 합니다.

단점:

• 최초 접속 및 동기화에는 인터넷 연결이 필요함
• 데이터와 작업 환경이 온라인에 종속됨 (백업은 가능하지만, 드물게 서버 장애가 발생할 수 있음)
• 로컬 에디터나 Tinymist LSP에서 제공하는 일부 고급 기능이 부족할 수 있음

로컬 환경 설정

Tinymist

참고: 예전에 사용되던 'Typst LSP'는 더 이상 업데이트되지 않으므로 사용하지 마세요.

Tinymist는 커뮤니티에서 개발한 LSP¹로, 공식 웹 앱보다 더 많은 기능을 제공하기도 합니다. 정의로 이동, 리팩토링, 자동 포맷팅 등 강력한 도구가 포함되어 있습니다. 공식 도구는 아니지만 성능과 안정성이 뛰어나 꼭 사용해 보시길 권장합니다.

LSP를 지원하는 대부분의 에디터(VS Code, Neovim, Emacs, Sublime Text, Helix, Zed 등)에서 사용할 수 있습니다.

로컬에서 작업하려면 평소 사용하는 에디터에 Tinymist 확장을 설치하세요. 실시간 미리보기와 함께 쾌적한 Typst 개발 환경을 누릴 수 있습니다.

주의: Tinymist는 내부적으로 Typst를 포함하고 있습니다. 때때로 에디터 확장의 버전이 낮으면 오래된 Typst 엔진을 사용할 수도 있으니 주의가 필요합니다. 또한 Tinymist를 통해 다양한 형식으로 문서를 내보낼 수 있으며, 저장 시 자동 내보내기 설정도 가능합니다. 터미널에서 tinymist preview document.typ을 실행해 브라우저로 미리보기를 띄울 수도 있습니다.

장점:

• 가장 방대한 기능: 현존하는 Typst 도구 중 가장 강력한 기능을 제공합니다.
• 개발자나 숙련된 사용자에게 최적화된 환경을 선사합니다.
• 에디터의 생태계를 그대로 활용할 수 있어 GitHub 연동이나 자동화 구성이 자유롭습니다.

단점:

• 웹 앱에 비해 초기 설정이 다소 번거로울 수 있습니다.
• 협업 시 GitHub 등을 통해 직접 환경을 맞춰야 하므로 조금 더 복잡합니다.

CLI (명령줄 도구)

Typst는 자체 CLI 도구도 제공합니다. 시스템에 설치한 후 터미널에서 typst compile document.typ을 실행하면 즉시 PDF가 생성됩니다.

설치 방법:

• Windows: GitHub Releases에서 실행 파일을 다운로드해 PATH에 등록하세요.
• macOS/Linux: 공식 가이드를 참조하세요. 패키지 매니저(brew, apt 등)를 통한 설치는 실제 버전보다 늦을 수 있으니 가급적 직접 설치를 권장합니다.

CLI를 사용하면 메모장 같은 단순한 에디터에서도 문서를 작성하고 결과를 확인할 수 있습니다. 특히 typst watch document.typ 명령을 사용하면 파일이 수정될 때마다 자동으로 다시 컴파일합니다.

이때 PDF가 변경될 때마다 화면을 자동으로 갱신해 주는 실시간 미리보기 PDF 뷰어를 함께 사용하면 편리합니다.

추천 뷰어:

• SumatraPDF (Windows)
• Zathura, Sioyek (Linux)
• Okular (멀티 플랫폼)

장점:

• 빠르고 정확하게 결과물을 내보낼 때 유용합니다.
• 자동화 스크립트나 다른 프로그램과의 연동에 최적화되어 있습니다.
• 별도의 패키지 매니저 없이도 명령 한 번으로 간편하게 업데이트할 수 있습니다.

단점:

• 터미널 환경에 익숙하지 않으면 사용이 어려울 수 있습니다.
• 에디터 자체의 보조 기능(자동 완성 등)은 제공하지 않습니다.

이제 시작해 봅시다!

환경 설정이 완료되었다면, 이제 본격적으로 Typst의 세계로 뛰어들어 봅시다!