Typst 문서를 고칠 때마다 별도 명령으로 PDF를 다시 만들면 문장과 결과를 대조하기 번거롭습니다. Typst IDE는 왼쪽에서 원고를 편집하고 오른쪽에서 결과를 바로 확인하는 로컬 편집기입니다. Linux용 무료 1.8.0 배포를 설치해 프로젝트를 만들고 PDF를 저장하는 순서를 정리했습니다.
처음에는 프로젝트 이름과 저장 위치부터 정하세요. 1.8.0은 프로젝트를 열기 전에 쓴 임시 원고도 복원하지만, 계속 관리할 문서는 프로젝트 경로를 확인해 두는 편이 파일을 찾기 쉽습니다.
원고와 결과를 나란히 보는 로컬 Typst 편집기
Typst IDE는 Typst 문법으로 작성한 원고와 컴파일된 문서 미리보기를 한 화면에 나란히 표시합니다. 공식 화면의 왼쪽에는 제목, 목록, 그림을 넣은 소스가 있고 오른쪽에는 조판된 문서가 보입니다. 원고를 바꾸면 미리보기가 따라 갱신되므로 문단 간격이나 그림 위치를 보면서 수정할 수 있습니다.
새 프로젝트를 만들 때 이름과 경로를 지정하고 기존 프로젝트도 열 수 있습니다. 개발자 설명에 따르면 프로젝트를 연 상태에서 자동 저장이 동작합니다. 앱은 계정이나 클라우드 작업 공간을 요구하지 않고 문서를 PC에 둡니다. 배포판의 파일 접근 권한은 Flatpak 환경에 따라 달라질 수 있으므로 저장 위치를 고를 때 확인하세요.
미리보기에서 특정 내용을 누르면 대응하는 원고 위치로 이동할 수 있고, 편집기 커서를 옮기면 미리보기도 해당 부분을 따라갑니다. 긴 문서를 읽을 때 소스와 결과를 따로 찾는 시간을 줄여 주는 기능입니다.
PDF를 만들 때는 앱의 Save as PDF 동작을 사용합니다. 1.8.0 릴리스는 내보내기 성공·오류 알림을 개선했고, PDF를 다시 내보내는 단축키도 명시합니다. 저장 후에는 선택한 폴더에서 PDF를 열어 실제 페이지와 글꼴이 의도대로 나왔는지 확인하세요.
두 번째 공식 화면에는 TODO, NOTE, FIXME, WARNING 같은 주석 표시가 색으로 강조되고 목록 창에 모입니다. 문서 작업 중 확인할 항목을 남길 때 유용하지만, 실제 PDF 내용에 들어갈 본문과 주석을 구분해 작성해야 합니다.
원고가 길어지면 수정할 곳을 기억하기 위해 Typst 주석에 // TODO: 그림 출처 확인처럼 표시를 남길 수 있습니다. 공식 화면의 왼쪽 여백에는 색 점이 나타나고, 표시 목록에는 해당 줄이 한데 모입니다. PDF를 만들기 전 이 목록을 열어 TODO와 FIXME를 다시 읽으면 빠진 그림 설명이나 미완성 문단을 찾는 데 도움이 됩니다. 목록에서 항목을 누르면 해당 원고 줄로 이동합니다.
프로젝트 파일 관리자에는 문서에 쓰는 이미지와 다른 파일을 함께 놓을 수 있습니다. 예를 들어 보고서의 그림 파일을 추가했다면 왼쪽 파일 목록에서 올바른 프로젝트에 들어왔는지 확인한 뒤 원고에서 그 파일을 참조하세요. 화면의 미리보기만 맞춰 놓고 원본 그림을 프로젝트 밖 임시 폴더에 둔다면 나중에 문서를 다시 열 때 경로가 달라질 수 있습니다. 완성된 PDF와 편집용 프로젝트의 위치를 모두 기록해 두는 편이 좋습니다.
1.8.0에서는 프로젝트가 열리지 않은 상태의 글도 임시 초안으로 복원하고, 시스템 언어를 자동 감지하며 영어를 기본 대안으로 사용합니다. 공식 스크린샷은 프랑스어 메뉴를 보여 주므로 실제 설치 화면의 메뉴 언어가 다를 수 있습니다.
편집 화면과 주석 목록의 실제 모습을 확인하세요
Flathub의 Typst IDE 공식 화면입니다. 첫 장은 소스와 PDF 미리보기를 나란히 보여 주고, 둘째는 TODO·FIXME 등을 모은 표시 목록 창입니다. 화면은 프랑스어 메뉴이며 버전 번호가 보이지 않습니다.
| 프로그램 | Typst IDE |
| 버전 | 1.8.0 |
| 배포 | Flathub · Linux x86_64/aarch64 |
| 가격 | 무료 · GPL-3.0-only |
| 용도 | Typst 문서 편집·PDF 내보내기 |
| 개발 | gnoooo |
Linux에 설치한 뒤 프로젝트 경로를 정합니다
Flathub는 Typst IDE 1.8.0을 Linux x86_64·aarch64용 무료 앱으로 표시합니다. Flatpak과 Flathub가 설정된 PC에서 앱 ID io.github.gnoooo.typst-ide를 확인해 설치하세요. 내려받는 .flatpakref는 Flathub 앱을 가리키는 참조 파일이며 실제 패키지와 필요한 런타임은 설치 과정에서 받아집니다.
앱을 열면 새 프로젝트와 기존 프로젝트를 여는 단추가 보입니다. 새 문서를 오래 보관하려면 새 프로젝트에서 이름과 저장 경로를 입력하세요. 공식 개발자 설명은 프로젝트가 열리거나 저장된 뒤 자동 저장 안내가 정리된다고 말합니다. 프로젝트를 만들기 전에 적은 글도 1.8.0에서는 임시 초안으로 다시 열리지만, 원하는 폴더에 프로젝트를 만드는 단계는 따로 진행해야 합니다.
- Linux 구조와 Flathub 설정을 확인하고 앱 ID를 대조합니다.
- Typst IDE를 열어 새 프로젝트의 이름과 저장 경로를 입력합니다.
- 프로젝트 폴더가 만들어졌는지 확인한 뒤 원고를 시작합니다.
짧은 원고를 입력하고 오른쪽 미리보기를 읽습니다
편집기 왼쪽에 = 회의 기록처럼 등호 한 개와 제목을 적고 다음 줄에 짧은 본문을 입력해 보세요. Typst 문법에서 이 표기는 큰 제목을 만듭니다. 오른쪽 미리보기에 제목과 본문이 조판되면 입력과 컴파일이 연결된 것입니다. 문장을 고치면서 오른쪽 결과가 바뀌는지도 확인하세요.
화면이 길어졌다면 미리보기의 문장을 눌러 원고 위치로 돌아가거나 편집기 커서를 옮겨 대응하는 결과를 찾을 수 있습니다. 공식 화면에는 제목, 글머리표, 간단한 도형이 조판돼 있습니다. 처음부터 복잡한 서식을 넣기보다 짧은 제목과 문단으로 저장 위치와 글꼴부터 확인하는 편이 문제를 찾기 쉽습니다.
예시 문서가 조판되지 않으면 제목 줄의 등호와 본문 줄을 따로 살펴보세요. Typst의 소스는 워드프로세서처럼 보이는 대로 바로 편집하는 방식이 아니라 입력 문법을 컴파일해 오른쪽 결과를 보여 줍니다. 왼쪽에서 입력한 = 회의 기록 문자가 오른쪽에서 제목 모양으로 바뀌는지를 보면 두 영역의 역할을 바로 구분할 수 있습니다. 그림이나 표는 이 짧은 문서가 정상적으로 표시된 뒤 추가하세요.
- 왼쪽 편집기에 제목과 한 문단을 입력합니다.
- 오른쪽 미리보기에서 같은 내용이 조판되는지 확인합니다.
- 문장을 한 번 고쳐 결과가 갱신되는지 확인합니다.
완성한 문서를 PDF로 저장하고 파일을 엽니다
문서가 원하는 모양이면 Save as PDF를 선택해 저장할 폴더와 파일 이름을 정합니다. 1.8.0 릴리스에는 이 버튼의 단축키 표시와 성공·오류 알림 개선이 적혀 있습니다. 저장이 끝났다는 알림만 보고 마치지 말고 실제 PDF 파일을 열어 제목, 문단, 그림, 페이지가 맞는지 확인하세요.
원고를 다시 고쳤다면 PDF도 다시 내보내야 수정 내용이 파일에 반영됩니다. 1.8.0에서 Ctrl+S는 이미 만든 PDF를 다시 내보내는 동작으로 설명됩니다. 다른 이름의 PDF가 필요하면 저장 대화상자의 파일 이름과 대상 폴더를 다시 확인하세요.
공식 화면 오른쪽 위에는 디스켓 모양의 내보내기 동작이 보이고, 1.8.0 릴리스는 Save as PDF 버튼과 내보내기 알림을 명시합니다. 버튼의 그림만 보고 저장이 완료됐다고 생각하지 말고 실제 파일 대화상자에서 위치를 고른 뒤 완료 메시지를 읽으세요. 특히 문서에 그림을 넣었다면 PDF를 열어 그림이 잘리지 않았는지, 마지막 페이지가 빈 페이지로 남지 않았는지까지 확인하는 것이 좋습니다.
- 미리보기에서 마지막 페이지까지 확인합니다.
- Save as PDF로 폴더와 파일 이름을 정해 저장합니다.
- 저장된 PDF를 열어 수정한 내용이 반영됐는지 읽습니다.
미리보기가 비거나 파일이 안 보일 때
오른쪽 미리보기가 예상과 다르면 먼저 원고에 문법 오류가 있는지, 현재 프로젝트가 열려 있는지 확인하세요. 원고를 한 줄씩 되돌리며 제목과 본문 같은 최소 내용에서 미리보기가 다시 나타나는지 보는 방법이 빠릅니다. 1.8.0은 PDF 내보내기 오류를 알림으로 보여 주므로 그 메시지도 읽어야 합니다.
저장한 PDF가 보이지 않으면 마지막에 선택한 폴더와 파일 이름을 확인하고, 같은 이름의 예전 PDF를 열고 있지 않은지 살펴보세요. Flatpak 앱에서 외부 폴더 접근이 제한된 환경이라면 접근 가능한 문서 폴더를 선택해 다시 내보낼 수 있습니다.
프로젝트 없이 적은 원고가 다음 실행 때 남아 있어도 정식 프로젝트가 만들어진 것은 아닙니다. 1.8.0의 임시 초안 복원 기능과 프로젝트 폴더 저장을 구분하고, 계속 쓸 문서에는 프로젝트 이름과 경로를 지정하세요.
- 짧은 제목과 본문만 남겨 미리보기가 작동하는지 확인합니다.
- 내보내기 알림과 저장 폴더·파일 이름을 살펴봅니다.
- 임시 초안이라면 프로젝트를 만들어 관리할 경로를 지정합니다.
자주 묻는 질문
Typst IDE는 무료인가요?
Flathub의 Linux x86_64·aarch64 배포는 무료이며 프로젝트 라이선스는 GPL-3.0-only로 표시됩니다.
Typst 원고를 입력하면 PDF가 자동 저장되나요?
오른쪽 미리보기는 입력에 따라 갱신되지만 완성 PDF는 Save as PDF로 내보내야 합니다. 수정 후에도 PDF를 다시 저장하세요.
프로젝트를 만들기 전에 적은 내용은 사라지나요?
1.8.0은 프로젝트가 없을 때 적은 임시 초안을 다음 실행에서 복원합니다. 계속 관리할 문서는 프로젝트를 만들어 경로를 확인하세요.
미리보기와 원고의 같은 위치를 찾을 수 있나요?
공식 설명에 따르면 미리보기 클릭으로 대응하는 원고 위치로 이동하고 편집기 커서를 따라 미리보기가 움직입니다.
Windows나 macOS에도 이 Flatpakref를 쓰나요?
아닙니다. 이 공식 Flatpakref는 Linux용입니다. 다른 운영체제의 설치 파일과 혼동하지 마세요.
프로젝트를 만들고 실제 PDF까지 확인하세요
Typst IDE에서는 원고를 쓰는 화면과 결과를 보는 화면이 붙어 있어 짧은 수정도 바로 확인할 수 있습니다. 프로젝트 경로를 정하고 문서를 입력한 뒤 Save as PDF로 내보내세요. 마지막에는 저장된 PDF를 직접 열어 내용과 페이지가 맞는지 확인하면 작업이 끝납니다.
공식 자료와 확인일
Typst IDE 개발자 설치·사용 안내 · Typst IDE 1.8.0 공식 릴리스 · Typst IDE Flathub 무료 Linux 배포 | 2026-11-09T12:26:40.108158+00:00
