Zettlr 4.8.0은 마크다운 문서와 연구 노트를 폴더 단위로 관리하고 HTML·DOCX·PDF 등으로 내보내는 무료 오픈 소스 편집기입니다. Windows, macOS와 Linux용 공식 설치 파일을 제공합니다.
공식 4.8.0 릴리스와 Windows에 직접 설치한 화면을 기준으로 파일 선택, 작업공간 열기, 제목·목록·표 작성, 검색·인용 설정, 내장 Pandoc 내보내기와 PDF 오류 해결을 설명합니다.
Zettlr는 어떤 마크다운 편집기인가요?
긴 글과 연구 노트를 일반 마크다운 파일로 작성하고 작업공간·태그·링크로 관리하는 무료 오픈 소스 데스크톱 앱입니다.
내장 Pandoc로 여러 형식으로 변환하며 인용 데이터베이스와 분할 편집을 지원합니다.
Zettlr 4.8.0 실제 편집·내보내기·환경 설정 화면
첫 화면은 파일 관리자와 마크다운 렌더링, 문서 탭과 분할 편집이 보이는 실제 4.8.0 화면입니다. 다음은 형식과 결과 디렉터리를 고르는 내보내기 창, 마지막은 한국어·자동 저장·업데이트를 조정하는 환경 설정입니다.
| 편집 | Markdown·YAML·표·할 일 |
|---|---|
| 관리 | 작업공간·태그·파일 링크 |
| 검색 | 문서 검색·전체 텍스트 검색 |
| 인용 | CSL JSON·BibTeX·Zotero |
| 출력 | HTML·DOCX·PDF 등 |
| 변환 | 내장 Pandoc |
Zettlr 설치 후 작업 폴더를 열고 문서를 내보내는 순서
Windows Intel·AMD 64비트 PC는 `Zettlr-4.8.0-x64.exe`를 설치합니다. Apple Silicon Mac은 arm64 DMG, Intel Mac은 x64 DMG를 고르고, Linux는 배포판과 CPU에 맞는 DEB·RPM·AppImage를 선택합니다.
Zettlr를 실행한 뒤 파일 > 작업공간 열기에서 마크다운 문서를 보관할 폴더를 선택합니다. 새 파일을 만들고 제목·목록·링크·표를 작성한 다음 저장합니다. 현재 문서 탭을 활성화하고 파일 > 내보내기 또는 Ctrl+E를 열어 HTML, DOCX, Simple PDF 같은 프로필과 결과 폴더를 정합니다. 내보내기를 실행한 뒤 생성된 파일을 열어 제목, 표, 링크와 한글 글꼴을 확인합니다.
- 운영체제와 CPU에 맞는 Zettlr 4.8.0 설치 파일을 받습니다.
- 설치 후 파일 > 작업공간 열기에서 문서 폴더를 선택합니다.
- 새 마크다운 파일을 만들고 제목·목록·링크·표를 작성합니다.
- Ctrl+S로 원본 `.md` 파일을 저장합니다.
- 현재 문서 탭을 선택하고 Ctrl+E로 내보내기 창을 엽니다.
- 출력 형식과 결과 디렉터리를 정하고 내보내기를 실행합니다.
- 생성된 HTML·DOCX·PDF를 열어 내용과 글꼴을 확인합니다.
Zettlr는 어떤 마크다운 편집기인가요?
Zettlr는 긴 글, 연구 노트와 학술 문서를 마크다운으로 작성하고 폴더 단위로 관리하는 무료 오픈 소스 데스크톱 편집기입니다. 왼쪽 파일 관리자에 작업공간과 문서가 표시되고 가운데 편집기는 제목, 목록, 표, 링크, 인용과 YAML front matter를 읽기 편하게 렌더링합니다.
문서는 일반 `.md` 파일로 남으므로 다른 편집기와 함께 쓸 수 있습니다. Zettlr는 작업공간을 색인해 파일 링크, 태그와 전체 텍스트 검색을 제공하고, 포함된 Pandoc를 이용해 여러 출력 형식으로 변환합니다.
현재 버전 4.8.0과 무료 라이선스
공식 최신 안정 버전은 4.8.0이며 GPL-3.0 라이선스로 무료 배포됩니다. 4.8.0 릴리스는 note, tip, warning, important, caution 형식의 admonition 렌더링을 추가하고 한국어 번역과 표 편집 동작을 개선했습니다.
직접 받은 Windows x64 설치 파일은 157,306,080바이트이고 SHA-256은 `4078C648AFD1141EC0230CB6CACFBB032BBD1D8AFDDCD822049EF9A2E6D1E8D6`입니다. 4.8.0은 macOS 12와 Ubuntu 17.04 이하를 지원하는 마지막 Electron 43 계열 릴리스라고 예고되어 있으므로 오래된 운영체제 사용자는 다음 버전으로 올리기 전에 호환성을 확인해야 합니다.
Windows·macOS·Linux 설치 파일 선택
Windows는 공식 릴리스의 x64 EXE를 사용합니다. 현재 릴리스에는 Windows ARM64 전용 EXE가 따로 없으므로 Snapdragon PC에서는 에뮬레이션 호환성을 확인해야 합니다. macOS는 Apple Silicon용 arm64 DMG와 Intel용 x64 DMG가 분리되어 있습니다.
Debian·Ubuntu 계열은 amd64 또는 arm64 DEB, Fedora·RHEL 계열은 x86_64 RPM을 선택합니다. 설치 없이 실행하려면 CPU에 맞는 x86_64 또는 arm64 AppImage를 받고 실행 권한을 부여합니다. 아키텍처가 다른 파일은 설치되지 않거나 실행 직후 종료될 수 있습니다.
실제 편집 화면과 작업공간
직접 실행한 4.8.0 화면에는 왼쪽 파일 관리자, 여러 문서 탭, 가운데 편집 영역과 분할 편집 창이 함께 보입니다. 파일 관리자에는 독립 파일과 작업공간이 나뉘며, 작업공간은 컴퓨터의 일반 폴더입니다.
파일 > 작업공간 열기 또는 도구 막대의 폴더 아이콘으로 폴더를 추가하면 Zettlr가 그 안의 마크다운 문서, 태그와 링크를 색인합니다. 작업공간을 닫아도 디스크의 폴더와 파일은 삭제되지 않습니다.
마크다운 문서 작성과 실시간 렌더링
새 파일을 만들고 `#`으로 제목, `-`로 목록, `- [ ]`로 할 일, `>`로 인용구를 입력합니다. 링크는 `[표시 이름](주소)` 형식이며 표는 세로선으로 열을 나눕니다. 화면에서는 문법 기호가 정돈된 형태로 보이지만 저장되는 원본은 텍스트 기반 마크다운입니다.
문서 맨 위에 `—`로 감싼 YAML front matter를 두면 title, author, keywords 같은 메타데이터를 내보내기에 전달할 수 있습니다. 들여쓰기나 콜론 뒤 공백이 잘못되면 YAML 경고가 표시될 수 있으므로 front matter부터 수정합니다.
탭과 분할 보기로 긴 글 비교하기
문서를 여러 개 열면 상단 탭에 표시됩니다. 탭을 다른 편집 영역으로 끌면 분할 보기가 만들어져 본문과 자료 노트를 동시에 볼 수 있습니다. 직접 확인한 튜토리얼 작업공간은 가운데 문서와 오른쪽 위·아래 문서를 한 화면에서 나눠 보여 줬습니다.
내보내기나 저장을 실행하기 전에 활성 탭 제목을 확인하세요. 분할 보기에서는 마지막으로 커서를 둔 문서가 현재 문서가 되므로 다른 참고 파일을 내보내는 실수를 줄일 수 있습니다.
파일 필터와 전체 텍스트 검색
왼쪽 파일 관리자 위의 필터는 파일 이름을 빠르게 좁힙니다. Ctrl+Shift+T로 필터에 초점을 옮기고 글자를 입력하면 일치하지 않는 항목이 숨겨집니다. 현재 문서 안에서 찾으려면 Ctrl+F를 사용합니다.
여러 문서의 본문을 찾을 때는 전체 텍스트 검색을 사용합니다. 4.8.0부터 공백으로 나눈 검색어는 모두 포함하는 AND 검색으로 처리되고, 둘 중 하나를 찾으려면 파이프 기호 `|`로 대안을 표시합니다. 이전 동작에 맞춘 검색 습관이 있다면 결과 수가 달라질 수 있습니다.
태그와 내부 링크로 노트 연결하기
작업공간을 열면 Zettlr가 문서의 태그와 파일 링크를 색인합니다. `#태그`를 입력해 주제를 묶고 자동 완성으로 기존 태그를 재사용하면 철자가 다른 중복 태그를 줄일 수 있습니다.
내부 링크를 만들 때는 자동 완성 목록에서 실제 파일을 선택하고, 대상 파일을 이동하거나 이름을 바꾼 뒤 링크가 계속 열리는지 확인합니다. 클라우드 동기화 폴더를 작업공간으로 쓸 때는 같은 문서를 여러 기기에서 동시에 편집하지 않는 편이 충돌 파일을 줄입니다.
인용 데이터베이스와 Zotero 연동
Zettlr는 CSL JSON, BibTeX와 BibLaTeX 인용 데이터베이스를 읽을 수 있습니다. 환경 설정의 인용 항목에서 데이터베이스 파일을 지정하면 citekey 자동 완성을 사용하고, Pandoc 내보내기에서 참고문헌을 만들 수 있습니다.
Zotero 라이브러리는 Better BibTeX 등으로 지원 형식에 내보내고 자동 갱신을 설정합니다. CSL JSON에서 첨부 PDF 경로를 열려면 Zotero가 실행 중이어야 할 수 있습니다. 인용 키가 보이지 않으면 내보낸 파일의 경로와 갱신 시각부터 확인합니다.
HTML·DOCX·PDF로 내보내기
파일 > 내보내기 또는 Ctrl+E를 누르면 현재 문서 이름, 형식 목록, 임시 디렉터리·현재 디렉터리·직접 선택 옵션이 표시됩니다. 4.8.0 설치본에는 Pandoc가 포함되어 있어 HTML과 DOCX 같은 형식은 별도 Pandoc 설치 없이 만들 수 있습니다.
Simple PDF는 HTML을 만든 뒤 브라우저 인쇄 방식으로 PDF를 생성합니다. XeLaTeX PDF 프로필은 별도의 LaTeX 배포판과 XeLaTeX 실행 파일이 필요합니다. 한글 논문처럼 글꼴과 수식 품질이 중요하면 LaTeX를 설치하고 프로필의 글꼴과 PDF 엔진을 확인합니다.
내보내기 형식이 없거나 결과가 실패할 때
먼저 환경 설정 > 가져오기 및 내보내기에서 활성화된 내보내기 프로필을 확인합니다. 프로필이 비활성화되었거나 YAML 문법이 잘못되면 목록에 없거나 Pandoc 오류가 납니다. 기본 프로필을 복구한 뒤 짧은 문서로 다시 시험합니다.
PDF 오류에 `xelatex`를 찾을 수 없다는 내용이 있으면 LaTeX 배포판을 설치하거나 Simple PDF를 선택합니다. 결과 폴더에 쓰기 권한이 없으면 바탕화면 같은 단순한 로컬 폴더로 바꾸고, 파일 이름에 사용할 수 없는 문자를 제거합니다.
환경 설정에서 자동 저장·언어·업데이트 확인
직접 확인한 환경 설정에는 애플리케이션 언어, 자동 저장, 기본 이미지 폴더, 외부 수정 반영과 자동 업데이트 확인이 있습니다. 자동 저장은 사용 안 함, 즉시, 잠시 쉴 때 중에서 작업 방식에 맞게 고를 수 있습니다.
맞춤법 검사 언어와 편집기 렌더링은 별도 항목에서 조정합니다. 한국어 인터페이스와 맞춤법 사전은 같은 설정이 아니므로 밑줄이 기대와 다르면 맞춤법 검사 언어를 확인합니다. 업데이트 후 설정이 바뀌면 환경 설정의 가져오기 및 내보내기 프로필도 함께 확인합니다.
작업공간이 보이지 않거나 파일이 중복될 때
파일 관리자에서 작업공간이 사라졌다면 파일 > 작업공간 열기로 같은 폴더를 다시 지정합니다. 독립 파일은 작업공간 밖에서 연 파일이므로 Files 영역에 따로 보일 수 있습니다. 닫기와 디스크 삭제는 다른 작업이므로 문맥 메뉴의 이름을 읽고 실행합니다.
동기화 프로그램이 만든 충돌 복사본은 실제 별도 `.md` 파일입니다. 내용과 수정 시간을 비교해 필요한 부분을 합친 뒤 정리하세요. Zettlr를 종료한 상태에서 폴더를 이동했다면 새 경로를 작업공간으로 다시 열어 색인이 끝날 때까지 기다립니다.
표·경고 상자·링크가 내보내기에서 다르게 보일 때
편집기의 렌더링은 작성 중 미리보기이고 최종 모양은 선택한 내보내기 프로필에 따라 달라집니다. 4.8.0의 admonition을 출력물에 유지하려면 해당 프로필의 Pandoc reader가 `alerts` 확장을 지원하고 활성화해야 합니다.
표가 깨지면 헤더 구분 행과 열 수를 맞추고, 상대 이미지 경로는 마크다운 파일 위치를 기준으로 확인합니다. 링크와 각주를 포함한 짧은 시험 문서를 먼저 내보낸 뒤 긴 프로젝트에 같은 프로필을 적용하세요.
업데이트와 제거 전에 문서를 백업하는 방법
마크다운 원본은 작업공간 폴더에 있으므로 폴더 전체를 복사하면 가장 중요한 문서를 보존할 수 있습니다. 인용 데이터베이스, 사용자 내보내기 프로필, 스니펫과 환경 설정도 별도로 보관하면 새 설치에서 작업 환경을 복구하기 쉽습니다.
프로그램을 제거해도 작업공간 파일을 함께 삭제하지 않도록 제거 화면을 확인합니다. 업데이트 후 문제가 생기면 동일한 짧은 문서를 열어 편집, 검색과 내보내기를 차례로 시험하고 오류 로그와 프로필 변경을 비교합니다.
자주 묻는 질문
Zettlr는 무료인가요?
네. GPL-3.0으로 배포되는 무료 오픈 소스 마크다운 편집기입니다.
Windows ARM64 전용 파일이 있나요?
4.8.0 공식 자산에는 Windows x64 EXE만 있습니다. ARM64 PC에서는 에뮬레이션 호환성을 확인하세요.
Pandoc를 따로 설치해야 하나요?
4.8.0 설치본에는 Pandoc가 포함되어 있습니다. 다만 XeLaTeX PDF에는 별도 LaTeX 배포판이 필요합니다.
작업공간을 닫으면 파일도 삭제되나요?
아닙니다. 작업공간 닫기는 파일 관리자에서 폴더를 제거할 뿐 디스크의 폴더와 문서는 남습니다.
현재 문서를 PDF로 만드는 가장 간단한 방법은 무엇인가요?
Ctrl+E로 내보내기를 열고 Simple PDF와 결과 폴더를 선택합니다. XeLaTeX 프로필은 LaTeX 설치가 필요합니다.
작업공간에서 문서를 저장하고 내보낸 결과까지 확인하세요
Zettlr 4.8.0을 설치하고 마크다운 폴더를 작업공간으로 연 뒤 제목·목록·링크·표를 작성합니다. 현재 문서 탭을 확인하고 Ctrl+E에서 출력 형식과 폴더를 정해 내보낸 다음, 생성된 파일을 열어 한글 글꼴·링크·표가 의도대로 보이는지 확인하세요.
공식 자료와 확인일
Zettlr 공식 다운로드 · Zettlr 4.8.0 공식 릴리스 · Zettlr 공식 문서 · Zettlr 공식 내보내기 문서 | 2026-10-01T14:46:37.866565+00:00
