빠른 시작

TeX64 개요

TeX64는 macOS 전용의 로컬 우선 LaTeX 에디터입니다. 워크스페이스 폴더를 열고 .tex 파일을 편집한 뒤 한 번의 클릭으로 빌드하고, 통합 PDF 뷰어에서 미리볼 수 있습니다. Apple Silicon(M1/M2/M3/M4)과 Intel을 모두 네이티브로 지원합니다. AI 기능을 제외하고 완전히 오프라인에서 동작합니다.

필수 환경

  • macOS 12(Monterey) 이상
  • Apple Silicon(M1/M2/M3/M4) 또는 Intel Mac
  • TeX 환경: MacTeX 권장(latexmk, lualatex, latexindent, synctex 필요)
  • 약 150MB의 여유 디스크 공간

TeX64 설치

  • /download에서 DMG 다운로드(Apple Silicon 또는 Intel 선택)
  • DMG를 열고 TeX64.app을 응용 프로그램 폴더로 드래그
  • 처음 실행 시 Gatekeeper 경고가 나타날 수 있습니다. Control+클릭 후 「열기」를 선택하세요.
  • 아키텍처 확인: 터미널에서 `uname -p` 실행(arm = Apple Silicon, i386 = Intel)

TeX 환경 설치

TeX64의 모든 기능을 사용하려면 TeX Live 배포판을 설치해야 합니다. MacTeX를 권장합니다.

  • MacTeX(권장)
    전체 TeX Live + GUI 도구, 약 4GB
  • BasicTeX
    최소 설치, 약 100MB. 필요한 경우 `sudo tlmgr install`로 추가 패키지 설치.

TeX 배포판 자세한 가이드 보기 →

7단계로 시작하기

  1. TeX64 실행
  2. File > Open Workspace(또는 폴더를 앱에 드래그&드롭)
  3. 파일 트리에서 메인 .tex 파일 선택(TeX64가 자동 감지)
  4. 툴바의 빌드 버튼(재생 아이콘)을 클릭
  5. PDF가 통합 뷰어에 표시됩니다
  6. 소스 편집 → 빌드 버튼 클릭 → PDF가 자동 업데이트
  7. PDF 위에서 Cmd+클릭으로 소스 코드로 이동(역방향 SyncTeX)

에디터 기능

  • 파일 트리: 워크스페이스의 디렉터리 구조를 접고 펼쳐 표시
  • 탭 편집: 여러 파일을 동시에 열고 전환
  • 분할 보기: 에디터와 PDF를 좌우 또는 상하로 나란히 표시
  • 별도 PDF 창: PDF 뷰어를 별도 창으로 분리(멀티 모니터 환경 지원)
  • 아웃라인 보기: 장, 절, 그림, 라벨, 인용, TODO를 자동 감지하여 목록 표시. 클릭하면 해당 위치로 이동
  • 프로젝트 검색: 워크스페이스 전체에서 전체 텍스트 검색(ripgrep 사용)
  • 이름 변경 지원: 프로젝트 전체에서 파일명과 라벨 변경을 지원

빌드 시스템

  • 툴바에서 원클릭 빌드
  • 내부적으로 latexmk 사용(증분 빌드 지원, 두 번째 이후로 훨씬 빠름)
  • 빌드 출력 패널에 진행 상황, 경고, 오류 표시. 오류를 클릭하면 해당 줄로 이동
  • 빌드 성공 시에만 PDF 자동 업데이트(실패 시 직전의 성공 PDF 유지)
  • 루트 파일 선택: 자동 감지 또는 수동 지정
  • 빌드 프로파일: 여러 컴파일 대상을 구성 가능

키보드 단축키

  • Cmd+B — \textbf{} 입력 또는 감싸기
  • Cmd+, — 설정 열기
  • Cmd+Click(PDF 위) — 소스 코드로 이동(역방향 SyncTeX)
  • Cmd+Shift+E — 블록 에디터 열기

환경 확인

TeX64가 필요한 도구를 모두 찾았는지 확인하려면 설정 > 환경을 확인하세요.

  • 확인 대상 도구: lualatex, latexmk, latexindent, synctex
  • ✅ 녹색 체크 = 발견됨
  • ❌ 빨간색 = 없음
  • 없을 경우: MacTeX를 설치하거나 `tlmgr`로 누락 패키지를 추가하세요

다음 단계

TeX64의 모든 기능을 활용하려면 다음 가이드를 참고하세요: