서버 없이 브라우저에서 pdfTeX를 돌리는 LaTeX 에디터 'TeXbrain'

LaTeX로 논문이나 보고서를 써 본 사람이라면 도구 자체와 씨름했던 기억이 있을 것이다. 로컬에 TeX 배포판을 설치하면 기기를 옮길 때마다 환경이 어긋나고, 온라인 편집기는 편하지만 git 연동 같은 기본기를 유료 기능으로 묶어 두는 경우가 많다. 최근 공개된 오픈소스 프로젝트 'TeXbrain'은 이 두 갈래의 불편함을 모두 피하려는 시도다. 계정도, 설치도, 서버도 없이 브라우저 탭 하나에서 LaTeX를 작성하고 PDF로 컴파일한다는 것이 핵심 주장이다. 개발자는 지난해 학위 논문을 LaTeX로 쓰면서 글쓰기보다 도구 설정에 더 많은 시간을 썼던 경험을 만든 이유로 밝히고 있다.

백엔드 없는 구조

TeXbrain의 가장 큰 특징은 문자 그대로 서버가 없다는 점이다. 편집기, 컴파일러, git 클라이언트가 전부 클라이언트 측에서 동작한다. 앱은 SvelteKit의 정적 어댑터로 빌드되어 HTML·CSS·JS 형태로 GitHub Pages에 배포되며, SSR이나 API 라우트가 존재하지 않는다. 사용자가 명시적으로 원격 저장소에 push하지 않는 한 파일은 로컬 기기를 떠나지 않는다. 컴퓨팅 부하와 데이터 보관을 모두 브라우저로 넘긴 셈인데, 이는 개인정보나 미공개 원고를 다루는 연구자에게는 매력적이지만 동시에 브라우저 성능과 저장 공간에 의존한다는 뜻이기도 하다.

실제 컴파일은 SwiftLaTeX의 pdfTeX 엔진을 WebAssembly로 컴파일한 것을 사용한다. 엔진은 메모리 파일시스템(MEMFS) 위에서 돌아가고, 컴파일 전에 프로젝트 파일이 이 가상 파일시스템에 기록된다. 편집기는 CodeMirror 6를 기반으로 하며, Lezer 파서로 만든 LaTeX 문법과 자동완성, 테마 시스템, 탭 기반 다중 파일 편집을 지원한다. PDF 출력은 Mozilla의 pdf.js로 렌더링되어 여러 페이지와 텍스트 선택·검색이 가능하다.

패키지 해석과 오프라인 동작

LaTeX 환경에서 늘 골칫거리인 것이 클래스·패키지·폰트 같은 의존성 처리다. TeXbrain은 엔진이 갖고 있지 않은 파일을 요청하면 서비스 워커가 단계적으로 해결한다. 먼저 이전에 캐시된 파일을 찾고, 없으면 앱에 번들된 패키지 부분집합을, 그래도 없으면 jsDelivr의 texmf-dist 미러(커뮤니티 SwiftLaTeX 서버를 폴백으로)에서 내려받는다. 한 번 받은 파일은 브라우저 캐시에 저장돼 같은 패키지를 두 번 내려받지 않는다. 첫 컴파일이 성공한 뒤에는 번들된 부분집합을 백그라운드에서 미리 받아 두어 핵심 패키지 세트는 오프라인에서도 작동하도록 했다. 다만 잘 쓰이지 않는 패키지는 결국 외부 미러에 의존하므로, 완전한 오프라인 사용을 보장하지는 않는다는 점은 감안해야 한다.

git 통합과 파일 접근

실무에서 눈여겨볼 부분은 git 연동이 처음부터 포함돼 있다는 것이다. 모든 git 작업은 순수 자바스크립트 구현체인 isomorphic-git으로 처리되고, 저장소는 IndexedDB로 뒷받침되는 인메모리 파일시스템(LightningFS)에 존재한다. 사용자는 로컬 폴더를 열어 편집하고, 변경을 커밋한 뒤 GitHub에 push하는 흐름을 한 탭 안에서 끝낼 수 있다. 브라우저가 git 프로토콜을 직접 말하지 못하기 때문에 push·pull·clone 같은 원격 작업은 CORS 프록시를 경유한다. 유료 서비스가 흔히 잠가 두던 기능을 기본 제공한다는 점에서, 버전 관리를 이미 습관화한 개발자·연구자에게는 진입 장벽이 낮다.

로컬 디스크의 실제 파일을 읽고 쓰는 데는 File System Access API가 쓰인다. 이 때문에 완전한 기능은 Chrome, Edge, Arc, Brave, Opera 같은 Chromium 계열 브라우저에서만 동작한다. Firefox와 Safari에서는 편집기 자체는 쓸 수 있지만 로컬 폴더에 직접 접근하지 못하고, 대신 Origin Private File System(OPFS) 기반의 가상 파일시스템 폴백을 사용해야 한다. 브라우저 호환성이 사실상 사용 경험을 가르는 조건인 셈이다.

정리하면 TeXbrain은 '설치 없는 이식성'과 '무료 git 연동'이라는 두 가지 요구를 브라우저 안에서 풀어내려는 프로젝트다. WASM으로 옮긴 pdfTeX, pdf.js, isomorphic-git 같은 검증된 클라이언트 기술을 조합해 백엔드 비용과 데이터 유출 우려를 함께 제거했다는 발상이 흥미롭다. 반면 무거운 문서 컴파일 시 브라우저 성능, 특정 패키지의 외부 미러 의존, Chromium 편중이라는 제약은 실사용 전에 확인해 볼 지점이다. 도구 설정보다 글쓰기에 시간을 쓰고 싶은 사람이라면, 로컬 환경을 건드리지 않고 한번 시험해 볼 만한 대안이다.