새로운 기능
Oleafly의 최신 노트, Markdown, 인용, 편집기, Typst, 다이어그램, 연구, 에이전트 기능을 설명하는 가이드를 찾아보세요.
가장 최근 작업에서는 연구 노트를 Markdown 파일로 보관하는 실험 기능인 노트가 추가되었고, Markdown 문서를 책, 슬라이드, 포스터, 편지로 빌드할 수 있게 되었습니다. 이제 미리보기에 Quarto 웹 페이지가 표시되며, TeX가 없는 컴퓨터에서는 엔진 창이 TinyTeX를 먼저 제안합니다. 그 이전에는 컴파일할 때마다 프로젝트 폴더의 PDF가 최신 상태로 유지되고, 이미 쓰고 있는 CLI 에이전트로 도구를 실행할 수 있게 되었으며, Zen 모드가 추가되고, 입력하는 동안 Zotero에서 인용할 수 있게 되었습니다. 이 페이지는 릴리스 노트 목록을 되풀이하는 대신 전체 설명서로 안내합니다.
연구 노트(실험 기능)
섹션 제목: “연구 노트(실험 기능)”노트는 연구 노트를 내 컴퓨터에 Markdown 파일로 보관합니다. 콜아웃, 표, 차트, 다이어그램, 수식, 링크, 마감일이 있는 할 일을 갖춘 리치 편집기로 씁니다. 설정 → 실험 기능에서 노트를 켜기 전에는 꺼져 있습니다. 노트는 나눠서 도킹할 수 있는 탭에서 열리며, 검색, 태그, 할 일, 날짜로 다시 찾을 수 있습니다. 노트는 프로젝트 안에 둘 수도 있고 공동 작업 서버에서 다른 사람과 함께 쓸 수도 있으며, 어시스턴트나 CLI 에이전트가 제안한 변경을 노트에서 수락하거나 거부할 수 있습니다. 빠른 캡처는 어떤 앱을 쓰고 있든 남기고 싶은 생각을 적을 수 있는 작은 창을 엽니다.
노트 켜기 · 노트에 쓰기 · 노트 찾기와 정리 · 프로젝트 노트와 공유 노트 · AI와 함께 쓰는 노트
유형이 있는 Markdown 문서
섹션 제목: “유형이 있는 Markdown 문서”Markdown 문서의 프런트 매터에 type:을 추가하면 보고서, 책, 슬라이드, 포스터, 편지, 이력서로 빌드됩니다. 슬라이드는 발표로 보여 줄 수 있는 16:9 Beamer 슬라이드로 빌드되고, 편지는 to와 from에서 주소를 가져옵니다. 직접 쓴 프런트 매터가 여전히 우선합니다. 문서 설정의 문서 유형이 그 줄을 대신 써 주며, LaTeX 내보내기와 oleafly build도 이 유형을 따릅니다.
문서 유형 · Markdown 문서 설정 · 슬라이드 발표
미리보기의 Quarto 웹 페이지
섹션 제목: “미리보기의 Quarto 웹 페이지”format: html이나 reveal.js 덱처럼 웹 페이지를 빌드하는 Quarto 문서는 이제 미리보기 창에 그 페이지를 표시합니다. 이 페이지는 Oleafly의 나머지 부분에 접근할 수 없습니다. 내 브라우저에서 열려면 미리보기 도구 모음에서 브라우저에서 열기를 선택하세요.
TeX가 없을 때는 TinyTeX를 먼저
섹션 제목: “TeX가 없을 때는 TinyTeX를 먼저”프로젝트에 latexmk가 필요한데 이 컴퓨터에 작동하는 TeX가 없으면, 이제 엔진 창에 TinyTeX 내려받기가 권장으로 표시되어 가장 먼저 나옵니다. TinyTeX 내려받아 사용은 TinyTeX를 설치하고 프로젝트를 컴파일합니다. 기본 제공 엔진을 계속 쓰려면 맨 아래의 Tectonic 계속 사용 카드를 사용하세요.
TeX가 설치되어 있지 않을 때 · Tectonic으로 부족할 때
항상 최신 상태로 프로젝트 폴더에 있는 PDF
섹션 제목: “항상 최신 상태로 프로젝트 폴더에 있는 PDF”이제 PDF 미리보기의 저장 버튼이 메뉴를 엽니다. 여기서 컴파일할 때 PDF 동기화를 켜면, 컴파일에 성공할 때마다 Oleafly가 프로젝트 폴더에 프로젝트 제목을 딴 이름의 PDF(예: Thesis_Final_Draft.pdf)를 갱신합니다. 일반 파일이므로 클라우드 동기화와 체크포인트에도 함께 담기고, Oleafly는 자신이 만들지 않은 파일을 덮어쓰지 않습니다. 이전 PDF를 되찾으려면 체크포인트의 파일을 열고 PDF 저장을 선택하세요.
컴파일할 때 PDF 동기화 · 체크포인트에서 PDF 저장하기
CLI 에이전트로 쓰는 도구
섹션 제목: “CLI 에이전트로 쓰는 도구”이미지를 LaTeX로, 이미지를 Typst로, 수식 도구, 스캔한 PDF는 Claude Code나 Codex 같은 연결된 CLI 에이전트를 쓸 수 있습니다. API 키 없이 내 로그인으로 실행됩니다. 키가 없으면 논문 검토, 인라인 편집, AI로 수정도 그 에이전트를 씁니다. Antigravity CLI가 이제 기본 제공 에이전트입니다.
API 키 대신 에이전트 사용하기 · 에이전트 카탈로그
어느 폴더의 TeX든, 미러에서 받는 다운로드
섹션 제목: “어느 폴더의 TeX든, 미러에서 받는 다운로드”설정 → 엔진 → LaTeX의 TeX 폴더 선택을 쓰면 Oleafly가 찾아보지 않는 위치에 설치된 TeX로 컴파일할 수 있습니다. TinyTeX, Typst 등의 다운로드는 이제 Oleafly 미러에서 먼저 받습니다. 설정 → 다운로드 → 다운로드 소스에서 원래 호스트나 내 미러로 바꾸고, TeX 패키지를 받아 오는 저장소도 정할 수 있습니다. TinyTeX 다운로드는 취소했다가 이어 받을 수 있습니다.
latexmk와 시스템 TeX · 다운로드 소스 탭 · TinyTeX 설치와 업데이트
PDF에서 빠진 텍스트
섹션 제목: “PDF에서 빠진 텍스트”TeX는 글꼴이 표시하지 못하는 문자를 건너뛰고도 성공했다고 보고하므로, 한국어, 중국어, 일본어 문단이 빈 채로 나올 수 있었습니다. 이제 알림이 나타나고, 로그에 빠진 문자가 나열되며, 내장 엔진과 함께 제공되는 글꼴로 각 문자 체계에 맞는 설정을 알려 줍니다.
생각 단계를 건너뛰는 로컬 모델
섹션 제목: “생각 단계를 건너뛰는 로컬 모델”답하기 전에 생각하는 Ollama와 Lemonade 모델의 추론 강도 메뉴에 이제 없음이 나타납니다. 간단한 요청에는 이것을 골라 훨씬 빠른 응답을 받으세요.
CJK 편집기 글꼴, 그리고 이름으로 쓰는 다운로드 글꼴
섹션 제목: “CJK 편집기 글꼴, 그리고 이름으로 쓰는 다운로드 글꼴”CJK 글꼴 설정은 편집기에서 한국어, 중국어, 일본어 문자에 코딩용 글꼴과는 별도의 글꼴을 지정합니다. 내려받은 Lato, PT Sans, PT Serif는 이름으로 쓸 수 있습니다. Typst가 찾아 주고, 프로젝트에 추가는 LaTeX 프로젝트에 글꼴을 복사합니다.
글을 쓰면서 Zotero에서 인용하기
섹션 제목: “글을 쓰면서 Zotero에서 인용하기”LaTeX, Typst, Markdown 파일에서 @를 입력하면 프로젝트 자체의 참고문헌 옆에 Zotero 라이브러리 전체가 나타납니다. 논문을 고르면 인용이 삽입되고, 그 항목만 프로젝트의 .bib에 추가됩니다. 이후에는 Zotero에서 추가와 Zotero에서 업데이트로 파일을 라이브러리와 맞춰 둘 수 있습니다. 같은 컴퓨터에서 Zotero 7을 열어 두었거나 zotero.org 계정이 있으면 사용할 수 있습니다.
Zotero 라이브러리에서 인용하기 · Zotero 연결하기
편집기 테마와 색상
섹션 제목: “편집기 테마와 색상”라이트 모드용 편집기 테마와 다크 모드용 편집기 테마를 하나씩 고르면, 앱을 전환할 때 편집기도 함께 바뀝니다. 따뜻한 오프화이트인 Paper와 One Light가 새로 추가되었습니다. 편집기 색상에서는 테마의 모든 색을 바꿀 수 있으며, LaTeX, Typst, Markdown에서 실시간 미리보기를 볼 수 있습니다. 색은 역할별로 묶여 있어서 제목, 인용, 수식이 세 언어에서 같은 색을 갖습니다.
Zen 모드
섹션 제목: “Zen 모드”Ctrl+⌘⇧F(Windows와 Linux에서는 Shift+F11)를 누르면 툴바, 사이드바, 어시스턴트, 터미널이 숨겨집니다. 편집기만 남고, 모서리에 컴파일 버튼이 표시됩니다. Esc를 두 번 누르면 모든 것이 돌아옵니다.
이름을 바꾸거나 옮긴 파일을 따라가는 경로
섹션 제목: “이름을 바꾸거나 옮긴 파일을 따라가는 경로”파일 이름을 바꾸거나 다른 폴더로 드래그하면, 그 파일을 가리키는 \input, \includegraphics, #include, image(), Markdown 링크도 함께 바뀝니다. 항상 또는 절대 업데이트하지 않도록 정해 두지 않았다면 Oleafly가 먼저 묻습니다.
기본 컴파일 엔진이 모든 새 LaTeX 프로젝트에 적용됩니다
섹션 제목: “기본 컴파일 엔진이 모든 새 LaTeX 프로젝트에 적용됩니다”설정 → 엔진 → LaTeX에서 고른 엔진이 이제 새 프로젝트, 가져온 프로젝트, 변환된 문서, 그 자리에서 여는 신뢰한 폴더에 적용됩니다. 거기서 latexmk를 고르면 새 프로젝트가 처음부터 내 TeX 설치로 컴파일됩니다.
확대와 축소, 글꼴, 새 단축키
섹션 제목: “확대와 축소, 글꼴, 새 단축키”⌘=와 ⌘-는 앱 전체를 확대하거나 축소하고, ⌘,는 설정을 열며, ⌘⌥P는 PDF를 표시하거나 숨깁니다. 앱과 편집기의 글꼴은 컴퓨터에 설치된 어떤 글꼴이든 쓸 수 있습니다. 편집기에는 줄 높이, 글자 간격, 커서의 너비와 색에 대한 설정도 추가되었습니다.
시스템 LaTeX와 외부 명령
섹션 제목: “시스템 LaTeX와 외부 명령”Tectonic이 문서를 빌드하지 못하면 엔진 대화 상자가 저절로 열리며, 프로젝트를 시스템 LaTeX로 옮길 수 있습니다. 편집기 위의 배너에서는 minted, PythonTeX, \write18을 위해 외부 명령 허용을 제공합니다. Linux에서는 Oleafly가 이제 자체 제목 표시줄을 그리고, 파일 관리자에서 끌어다 놓은 파일을 받습니다.
Tectonic으로 부족할 때 · 외부 명령 허용 · Linux에 설치하기
LaTeX만큼 완성된 Typst
섹션 제목: “LaTeX만큼 완성된 Typst”Typst 프로젝트에도 이제 LaTeX 프로젝트에 있던 기능이 갖춰졌고, Typst만의 기능도 몇 가지 있습니다. 프로젝트마다 0.11부터 0.15까지 Typst 버전을 고르면 Oleafly가 내려받아 공개된 체크섬과 대조해 확인합니다. 패키지는 Typst Universe에서 받아 오며 프로젝트 안에 둘 수도 있어서 오프라인에서도 컴파일됩니다. 프로젝트 자체의 글꼴, 빌드 변형, 재현 가능한 빌드는 Typst와 언어 서버 모두에 적용됩니다.
편집기에서 Typst는 비주얼 모드, 접기, 고정 제목, 함수, 경로, 레이블, 패키지 자동 완성, 이름 바꾸기, 문서 서식 정리를 사용할 수 있습니다. LaTeX에 있던 그림, 표, 인용, 수식 도구도 쓸 수 있습니다. PDF로 이동과 PDF에서의 클릭으로 소스와 페이지 사이를 오갈 수 있습니다. 내보내기 형식에는 PNG, SVG, HTML, PDF/A, PDF/UA가 있고, 프리플라이트는 Typst 소스도 검사합니다.
Typst 프로젝트 설정하기 · Typst로 글쓰기 · LaTeX 프로젝트를 Typst로 변환하기
모든 엔진을 위한 패키지, 문서 설정, 문서 분석
섹션 제목: “모든 엔진을 위한 패키지, 문서 설정, 문서 분석”편집기 툴바의 버튼 세 개는 이제 해당되는 경우 LaTeX, Typst, Markdown에서 같은 방식으로 작동합니다.
- 패키지는 LaTeX에서는 CTAN을, Typst에서는 Typst Universe를 검색하고 패키지를 불러오는 줄을 추가합니다.
- 문서 설정은 용지 크기, 여백, 글꼴, 언어, 줄 간격, 번호 매기기를 바꿉니다. 프리앰블,
#set규칙, 프런트 매터를 대신 편집해 줍니다. - 문서 분석은 문서에 있는 그림, 표, 수식, 레이블, 인용, TODO를 나열하고 투고용 메타데이터를 복사합니다.
TikZ, Typst, Mermaid를 위한 하나의 다이어그램 작성기
섹션 제목: “TikZ, Typst, Mermaid를 위한 하나의 다이어그램 작성기”다이어그램 작성기는 이제 다이어그램이 어떤 언어용인지 묻습니다. LaTeX용 TikZ, Typst용 fletcher 다이어그램, Markdown용 Mermaid 순서도 중에서 고릅니다. 세 가지가 같은 캔버스를 쓰며, 코드와 그림은 양방향으로 서로 맞춰집니다. 문서 툴바의 다이어그램 그리기는 질문을 건너뛰고 그 문서의 언어를 사용합니다. Markdown에 삽입한 Mermaid 다이어그램은 컴파일된 PDF에도 나타납니다.
PDF로 슬라이드 발표하기
섹션 제목: “PDF로 슬라이드 발표하기”컴파일된 PDF를 전체 화면으로 발표할 수 있으며, 다음 슬라이드, 타이머, 메모를 보여 주는 발표자 보기를 선택적으로 쓸 수 있습니다.
GitHub 이슈처럼 라이브러리 검색하기
섹션 제목: “GitHub 이슈처럼 라이브러리 검색하기”홈 화면의 프로젝트 검색은 engine:typst, is:bookmarked, created:>@today-1w 같은 한정자와 AND, OR, 괄호, 정렬을 이해합니다. 입력하는 동안 제안이 나타나며, 고급 필터는 같은 텍스트를 편집합니다.
Zotero와 alphaXiv
섹션 제목: “Zotero와 alphaXiv”Zotero 라이브러리 전체를 프로젝트의 참고문헌으로 가져오고, alphaXiv를 연결해 어시스턴트가 그곳의 논문을 검색하고 읽을 수 있게 하세요.
확인하고 되돌릴 수 있는 CLI 에이전트
섹션 제목: “확인하고 되돌릴 수 있는 CLI 에이전트”설정의 각 CLI 에이전트에는 Oleafly가 찾은 프로그램이 표시되며, 아무것도 저장하기 전에 테스트로 실행해 볼 수 있습니다. 에이전트가 파일을 변경한 뒤에는 각 변경 사항을 검토하고 실행 취소하거나 다시 실행할 수 있습니다. 에이전트 홈에는 문헌 조사나 인용 점검 같은 연구 시작점도 있습니다.
CLI 에이전트 설정하기 · 변경 사항 검토하고 실행 취소하기 · 연구 시작점
검색할 수 있는 설정
섹션 제목: “검색할 수 있는 설정”설정에서 “테마”, “Zotero”, “맞춤법” 같은 단어를 입력하면 해당 설정으로 바로 이동합니다. 초기화 버튼의 점은 그 섹션에서 기본값과 다른 항목이 있다는 표시이며, 파일 경로는 마우스를 올리기 전까지 흐리게 가려져 있습니다.
모든 Oleafly 도구를 위한 가이드
섹션 제목: “모든 Oleafly 도구를 위한 가이드”선택 사항인 LaTeX 도구 갤러리에는 이제 Typst 변환기 열 개를 포함해 특정 용도에 맞춘 도구 47개가 있습니다. LaTeX, Typst, Markdown, Word, HTML, PDF, 이미지, 스프레드시트, Mermaid 다이어그램 사이에서 문서를 변환하고, 참고문헌을 만들고 검증하고, 논문, 연구실, 마감일을 검색하고, 통계 계산을 하고, 작은 글쓰기 도우미를 사용할 수 있습니다.
각 도구에는 이제 입력, 단계, 예시, 개인정보 처리 방식, 제한 사항, 그리고 그 도구가 맞지 않을 때의 더 나은 방법을 담은 전용 페이지가 있습니다.
창이 둘로 나뉜 도구에는 드래그할 수 있고 키보드로도 조작할 수 있는 구분선이 있습니다. 각 도구는 데스크톱에서의 분할 위치를 기억하며, 좁은 창에서는 입력과 결과를 위아래로 쌓습니다.
소스 파일을 이해하는 교정
섹션 제목: “소스 파일을 이해하는 교정”이제 교정은 LaTeX, Typst, Markdown에서 맞춤법 검사와 Harper의 문법 및 문체 검사를 함께 수행합니다. 산문으로 취급하면 안 되는 소스 구문은 건너뛰고, 검사 결과는 바꾸거나, 이번만 무시하거나, 한 프로젝트에서 무시하거나, 모든 곳에서 무시할 수 있습니다. 학술 프로필은 연구 글쓰기에 맞는 검사를 더하며, 검사 결과에서 Harper 규칙을 개별적으로 끌 수 있습니다.
더 빨라진 LaTeX 편집
섹션 제목: “더 빨라진 LaTeX 편집”편집기는 수식 구분 기호, 괄호, 환경의 짝을 맞추고, 목록을 이어 주고, 현재 환경을 닫고, 패키지를 인식하는 명령, 참조, 인용, 프로젝트 경로를 자동으로 완성합니다. 자동 완성, 괄호, 수식, 환경 닫기는 각각 따로 켜고 끌 수 있습니다.
더 믿을 수 있는 참고문헌
섹션 제목: “더 믿을 수 있는 참고문헌”인용 삽입은 일반적인 BibTeX와 Biber 설정을 포함해 문서가 선언한 참고문헌을 따릅니다. 라이브러리 가져오기는 BibTeX, RIS, EndNote XML, Zotero RDF를 받습니다. 참고문헌 정리 도구는 파일을 바꾸기 전에 정규화된 키와 중복을 미리 보여 주고, 키가 바뀌면 인용도 업데이트하며, 백업을 저장합니다. 새로운 독립 실행형 도구는 DOI, arXiv, ISBN, PubMed, URL, 서식을 갖춘 인용, 여덟 가지 인용 스타일을 다룹니다.
글쓰기 형식 간 가져오기와 내보내기
섹션 제목: “글쓰기 형식 간 가져오기와 내보내기”Word와 HTML 문서는 LaTeX, Markdown, Typst 프로젝트가 될 수 있습니다. Markdown은 LaTeX나 Typst로, Typst는 LaTeX나 Markdown으로 바꿀 수 있습니다. 열려 있는 프로젝트는 지원되는 경로에 따라 Word, MathML이 포함된 HTML, Markdown, Typst, LaTeX, 일반 텍스트, PDF, 소스 ZIP, 페이지 이미지로 내보낼 수 있습니다. LaTeX 프레젠테이션과 책은 PowerPoint나 EPUB로도 내보낼 수 있습니다. Markdown 프로젝트는 둘 다 지원하고, Typst 프로젝트는 EPUB을 지원합니다.
21개 언어로 제공되는 인터페이스
섹션 제목: “21개 언어로 제공되는 인터페이스”설정 → 일반 → 언어에서 시스템 기본값이나 21개 언어 중 하나를 고르세요. 简体中文, 日本語부터 Deutsch, Español까지 있습니다. 인터페이스는 다시 시작하지 않아도 즉시 바뀝니다. 이 설정은 앱의 레이블과 메시지를 제어합니다. 문서 언어, 교정 사전, 어시스턴트 출력 언어는 별도로 선택합니다.
PDF 접근성과 투고 점검
섹션 제목: “PDF 접근성과 투고 점검”프리플라이트는 컴파일, 레이아웃, 참조, 에셋, 블라인드 심사, ATS, 접근성 점검 결과를 한곳에 모아 보여 줍니다. PDF/UA 섹션은 기계로 검사할 수 있는 범위로 정해 둔 항목을 점검하고, 태그된 PDF 워크플로는 호환되는 LaTeX 프로젝트를 LuaLaTeX용으로 준비합니다. 가이드는 어떤 결과가 확정적이고 어떤 결과가 휴리스틱인지, 그리고 문제없이 끝난 실행이 정식 PDF/UA 인증이 아닌 이유를 설명합니다.
TeX 패키지 복구
섹션 제목: “TeX 패키지 복구”latexmk 빌드에서 TeX 파일이 없다고 보고되면, Oleafly가 그 파일이 속한 TeX Live 패키지를 찾아 설치하고 다시 컴파일할 수 있습니다. 패키지 관리자는 TeX Live 전체 카탈로그를 검색할 수도 있으며, 패키지가 시스템 트리에 있는지 개인 트리에 있는지 보여 줍니다.
더 쉬워진 소프트웨어 인용
섹션 제목: “더 쉬워진 소프트웨어 인용”설정 → 도움말 및 정보에 Oleafly용 BibTeX 항목이 바로 복사할 수 있는 형태로 들어 있습니다. 열려 있는 프로젝트에서 이 논문에서 Oleafly 인용하기를 쓰면 문서가 사용하는 참고문헌에 그 항목을 추가할 수 있습니다.
릴리스 노트와 업데이트
섹션 제목: “릴리스 노트와 업데이트”버전별 변경 사항은 GitHub Releases (새 탭에서 열림)에서 확인하세요. 앱에서는 설정 → 도움말 및 정보를 열어 업데이트를 확인합니다. 업데이트 과정은 앱 업데이트에서 설명합니다.