LaTeX Workshop 그 너머: 내 컴퓨터에서 쓰는 연구용 편집기

프로젝트 전체를 이해하는 기능, SyncTeX, 오프라인 교정, 내장 컴파일러, 진짜 Git, 인용 관리를 갖춘 연구 전용 편집기. VS Code + LaTeX Workshop은 여전히 레시피, 원격 개발, 확장 마켓플레이스에서 앞섭니다.

VS Code의 LaTeX Workshop (새 탭에서 열림)은 훌륭합니다. 무료이고, MIT 라이선스이며, 꼼꼼하게 관리됩니다. 한 주의 작업이 자유로운 컴파일 레시피, texdoc, Docker/WSL/원격 개발, Live Share, 또는 확장 마켓플레이스 전체에 기대고 있다면 그 환경을 계속 쓰세요. 그런 삶에 맞게 만들어진 도구입니다.

이 글은 문서 중심 앱을 원할 때를 위한 것입니다. 여러 파일로 된 논문, 컴파일러, PDF, Git, 인용, 그림, 교정이 이미 한데 연결되어 있습니다. 무료 오픈소스(AGPL)입니다. LaTeX, Typst, Markdown을 지원합니다. 일반 폴더를 그대로 씁니다. 계정이 필요 없습니다.

기능 대응표와 단축키: LaTeX Workshop에서 넘어오기 (새 탭에서 열림).

편집기

CodeMirror 6에 LaTeX, Typst, Markdown, BibTeX를 아우르는 프로젝트 전체 인덱스를 얹었습니다.

날마다 실제로 얻는 것은 다음과 같습니다.

  • 정의로 이동, 참조 찾기, 레이블과 매크로 이름 바꾸기 (충돌 경고 포함)
  • 깨진 참조, 잘못된 인용, 빠진 include를 실시간으로 검사 (\cref, \eqref, 범위 참조 등)
  • 로컬 구조 보기와 프로젝트 구조 보기, 필터링과 바로 이동
  • 키, 경로, 그리고 프로젝트가 정의한 매크로에 대한 자동 완성 (\newcommand, xparse 인수 형태)
  • .tex, .ltx, .sty, .cls 지원, 인수 스니펫, 환경 검사
  • LaTeX용 TexLab (직접 켜는 방식), Typst용 Tinymist는 기본 포함
  • 통합 진단: 구문, 컴파일, 언어 서비스, 참조, 인용, 맞춤법, 문법
  • KaTeX 수식 실시간 미리보기, 소스는 계속 편집 가능
  • Harper + Hunspell로 본문 텍스트만 오프라인 검사 (명령어와 수식은 제외)
  • 자주 쓰는 구조를 위한 비주얼 모드, Vim, 슬래시 명령, 여러 파일 탭
  • 대규모 말뭉치를 바탕으로 패키지를 인식하는 명령어 자동 완성이 다음에 들어옵니다 (LaTeX Workshop의 MIT 라이선스 데이터를 출처를 밝히고 포함)

PDF 작업 공간: 연속 스크롤, 펼침면, 검색, 개요, 분리 가능한 창. 장(chapter) 파일 전체에 걸친 양방향 SyncTeX. 재빌드가 대기 중일 때도 위치 매핑이 동작합니다. 마지막으로 정상 컴파일된 PDF가 계속 화면에 남아 있습니다. 컴파일된 소스 상태로 실행 취소하면 전체 재컴파일 없이도 미리보기가 최신 상태로 돌아갈 수 있습니다.

책 규모 CI: 약 6,200줄의 원고, 여러 계열의 수식, 장, 인용, 교정을 갖추고, 스크롤·입력·붙여넣기·실행 취소·자동 완성·재컴파일·SyncTeX에 성능 예산을 둡니다.

LaTeX Workshop은 범용 IDE 안에서 강력한 확장 기능입니다. Oleafly는 이 문서 작업 루프를 이미 조립된 상태로 제공하므로, 매 학기 설정과 마켓플레이스에서 고른 확장으로 같은 구성을 다시 엮을 필요가 없습니다.

앱에 내장된 컴파일러

Tectonic(LaTeX)과 Typst가 앱에 포함되어 있습니다. Markdown은 필요할 때 관리되는 Pandoc을 통해 처리합니다. 첫 컴파일에서 패키지를 캐시하고, 그 뒤에는 캐시된 빌드를 오프라인에서도 쓸 수 있습니다. 오프라인 모드는 컴파일러를 캐시에만 묶어 둘 수 있습니다.

자동 컴파일(디바운스, 취소 가능, 최신 요청 우선). Cmd/Ctrl-Enter로 다시 컴파일. 중지 버튼. 해당 줄에 붙는 알기 쉬운 오류 카드. 새 빌드가 진행되는 동안에는 마지막으로 정상 컴파일된 PDF를 보여 줍니다.

레시피, latexmk 체인, shell-escape, 사용자 정의 .latexmkrc는 계속 LaTeX Workshop의 영역입니다. 대부분의 논문과 학위논문에는 안정적으로 관리되는 엔진 하나면 충분합니다.

템플릿: 기본 제공 시작 템플릿 23개(IEEE, ACM, Elsevier, Beamer, 학위논문, 이력서, Typst 빈 문서 등)에 더해 내려받을 수 있는 팩에 99개가 더 있습니다. 어떤 프로젝트든 템플릿으로 저장할 수 있습니다. 모델을 설정해 두면 AI로 템플릿을 생성할 수도 있습니다(선택 사항).

라이브러리, Git, 연구 도구

프로젝트를 책처럼 다룹니다. 표지 색상, 엔진 배지, 포크 계보, 마지막 PDF 페이지의 마우스 오버 미리보기, 북마크, 모든 문서를 대상으로 하는 /docs 검색이 있습니다. 포크는 전체 Git 이력을 유지하므로, 제출본 옆에서 위험 부담이 큰 전면 재작성을 시도할 수 있습니다.

첫날부터 진짜 Git입니다. 스테이지, 나란히 보는 diff(작업 트리 편집 가능), 변경 사항 버리기, 복원을 지원합니다. 컴파일이 성공한 뒤와 편집이 잠시 멈췄을 때 자동으로 체크포인트를 만들고, AI 작업은 첫 번째 쓰기 전에 체크포인트를 남깁니다. GitHub 연동은 선택 사항입니다(PAT 또는 디바이스 플로 OAuth). 터미널의 git log가 앱과 일치합니다.

DOI / arXiv / 제목을 붙여 넣으면 → 중복 제거 → .bib → \cite로 이어집니다. BibTeX, RIS, EndNote, Zotero RDF를 일괄 가져오기. arXiv, Semantic Scholar, Crossref, PubMed, OpenAlex를 아우르는 인용 검색. 편집 가능한 TikZ로 이어지는 다이어그램 작성기. 검사기, 표, 수식, 연구실 검색, 마감일, PDF를 LaTeX로 바꾸기, 비전 모델로 이미지를 LaTeX로 바꾸기.

선택 사항인 AI

설정하기 전까지는 꺼져 있습니다. OpenAI, Anthropic, Z.AI, Groq, OpenRouter, DeepSeek, Mistral, xAI, Ollama를 지원합니다. 키는 디스크에 암호화되어 저장됩니다. 요청은 내가 고른 제공자에게만 전달됩니다.

어시스턴트는 편집, 컴파일, 로그 읽기, PDF 텍스트 추출, 문헌 검색을 하고 계획을 유지합니다. 쓰기는 승인 diff를 거칩니다. 삭제에는 별도의 확인이 필요합니다. 선택 영역에 바로 쓰는 AI에게 묻기가 있습니다. Claude Code, Cursor 같은 도구를 위한 루프백 MCP도 있습니다. AI를 꺼도 편집기, 컴파일, Git, 인용은 그대로 동작합니다.

프리플라이트, 내보내기, 개인정보 보호

프리플라이트: 구조, 정의되지 않은 참조, 중복 레이블, 파서 방식의 텍스트 추출 미리보기, 화면 낭독기를 고려한 검사 결과. 위험 표시마다 직접 확인할 수 있을 만큼의 맥락이 함께 제공되므로, 블랙박스 점수를 믿지 않아도 됩니다.

내보내기: PDF는 항상, Pandoc을 쓸 수 있으면 DOCX/HTML/Markdown, 슬라이드는 PowerPoint, 책은 EPUB, 인계용으로는 소스 ZIP을 지원합니다.

Oleafly 계정이 없습니다. 제품 텔레메트리도 없습니다. 충돌 신고는 내용이 미리 채워진 GitHub 이슈를 열어 주며, 보내기 전에 직접 검토합니다. 네트워크는 패키지, 템플릿, 호스팅 AI, 인용, 업데이트, GitHub에만 씁니다. 편집, 캐시된 컴파일, 문법 검사, 맞춤법 검사, 로컬 Git은 오프라인에서도 동작합니다.

LaTeX Workshop이 여전히 맞는 경우

  • 자유로운 레시피, latexmk, shell-escape, .latexmkrc
  • 편집기 안에서 texdoc 사용
  • Docker, WSL, 원격 개발
  • Live Share와 실시간 다중 사용자 편집
  • 문서 작업이 아닌 일에도 VS Code 마켓플레이스 안에서 지내는 경우

Oleafly는 공개 베타입니다. 무거운 출판사 클래스 파일은 아직 Tectonic을 걸고넘어질 수 있으니, 발견하면 알려 주세요.

써 보기

  1. 릴리스 페이지 (새 탭에서 열림)에서 내려받습니다 (macOS는 서명·공증 완료, Windows는 SmartScreen 경고가 한 번 뜰 수 있음).
  2. .tex, .bib, 그림 파일을 가져옵니다 (또는 템플릿에서 시작합니다).
  3. 한 번 컴파일해 본 뒤, 하루 동안 실제 논문을 써 봅니다.

VS Code는 그대로 설치해 두세요. 같은 파일을 어느 앱에서든 쓸 수 있습니다. 실제 논문으로 보낸 하루가 Oleafly에서 더 잘 풀렸다면 프로젝트를 더 옮기고, 어떤 프로젝트는 레시피와 원격 개발이 여전히 낫다면 그 프로젝트는 Workshop에 두세요.

모든 게시물