1. 작성 환경과 출력 선택
HTML·Word 문서
Quarto CLI와 편집기
.qmd 문서를 작성하고 원하는 출력 형식으로 발행합니다. Quarto와 문서를 편집하는 앱은 역할이 다릅니다.
계산이 있는 보고서
R·Python 환경 확인
코드가 포함된 문서에는 선택한 knitr·Jupyter 등 실행 환경을 별도로 준비합니다.
PDF 문서
LaTeX·Typst 구분
LaTeX 경로는 TeX 준비가 필요하고 Typst 출력은 Quarto에 포함된 Typst CLI를 사용합니다.
한 파일의 형식만 바꾸려면 Pandoc, Markdown 작성 환경이 중심이면 편집기를 먼저 비교하세요.
2. 개요
Quarto는 Posit PBC와 기여자가 개발하는 오픈소스 문서 발행 시스템입니다. Pandoc을 기반으로 Markdown 문서와 코드가 있는 보고서를 HTML·DOCX·PDF 등으로 발행하며 웹 자료·발표·책을 구성하는 환경도 제공합니다. 문서 한 개의 형식 변환보다 작성 파일과 출력 설정을 함께 관리하려는 기술 문서·보고서 작업에 맞는지 검토할 수 있습니다. 보드게임이나 이름이 같은 다른 서비스와는 다른 소프트웨어입니다.
Quarto CLI와 글을 쓰는 편집기, 계산 코드를 실행하는 환경은 구분해야 합니다. 텍스트 편집기에서 .qmd 파일을 작성할 수 있고 VS Code·RStudio·Positron 같은 환경과도 연결할 수 있습니다. 문서에 R이나 Python 코드를 넣어 실행하려면 선택한 엔진의 준비 조건이 추가됩니다. R 패키지 quarto는 설치된 Quarto CLI를 호출하는 선택적 인터페이스이므로 R 패키지를 설치한 것만으로 CLI까지 준비됐다고 보지 마세요. 단순 텍스트 문서를 발행하는 모든 사용자에게 R이 필수인 것은 아닙니다.
출력 형식에 따라 필요한 도구도 달라집니다. HTML·Word 문서와 LaTeX 기반 PDF의 준비를 한 가지로 묶지 마세요. LaTeX PDF를 만들려면 TeX 배포 환경이 필요하고, Typst 형식으로 PDF를 발행할 때는 Quarto에 포함된 Typst CLI를 사용합니다. 같은 PDF라도 기능·문법·레이아웃 조건은 선택한 형식에 따라 달라지므로 자신의 문서 요소와 출력 목적을 먼저 확인하는 것이 좋습니다.
다운로드 허브에서는 현재 안정판과 사전판을 구분해 설치 파일을 고릅니다. 일반 작업을 시작할 때는 안정판을 기준으로 OS·아키텍처를 확인하세요. 현재 CLI는 MIT 라이선스이지만 Visual Editor와 포함된 의존성에는 각자의 라이선스가 있습니다. 한 파일을 Word로 바꾸려는 목적은 Pandoc, 문서를 쓰고 수정할 환경은 Zettlr나 VS Code와 비교하고 필요한 범위의 도구를 선택할 수 있습니다.
3. 주요 기능
- Markdown·.qmd 기반 문서 작성·발행
- HTML·DOCX 등 문서 출력
- R·Python 실행 엔진과 연결하는 보고서
- LaTeX·Typst 방식의 PDF 발행
- 웹 자료·발표·책 등 출력 환경
- 텍스트 편집기와 개발 환경의 연동
- 설정과 작성 파일을 관리하는 발행 프로젝트
4. 시스템 요구사항
- Windows
- 공식 MSI·ZIP의 현재 설치 조건 확인
- macOS
- 공식 PKG의 현재 설치 조건 확인
- Linux
- 현재 배포판·아키텍처에 맞는 패키지 선택
- 계산 문서
- 선택한 R·Python 실행 엔진 별도 준비
- PDF 출력
- LaTeX는 TeX 필요 · Typst는 포함 CLI 사용
5. 설치 방법
- 1.
위 안정판 선택 버튼에서 공식 배포 허브를 엽니다.
- 2.
Current Release와 Pre-release를 구분하고 현재 OS·아키텍처에 맞는 설치 파일을 고릅니다.
- 3.
Quarto CLI를 준비하고 문서를 작성할 편집기를 정합니다.
- 4.
코드를 실행하는 문서라면 선택한 R·Python 엔진의 준비 조건을 확인합니다.
- 5.
작은 문서로 필요한 출력 형식을 확인합니다. LaTeX PDF와 Typst의 추가 준비는 구분하세요.
6. Quarto와 비슷한 프로그램 비교
7. 자주 묻는 질문
Quarto는 무료인가요?
+
무료 오픈소스 프로젝트이며 CLI는 1.4 이후 MIT 라이선스입니다. Visual Editor와 포함 의존성에는 별도 라이선스가 있으므로 모든 구성요소를 MIT로 묶지 마세요.
Quarto를 설치하면 편집기도 생기나요?
+
Quarto CLI와 문서를 쓰는 앱은 구분합니다. 텍스트 편집기나 지원 개발 환경을 사용해 문서를 작성하고 Quarto로 발행하는 흐름입니다.
R을 꼭 설치해야 하나요?
+
모든 문서에 필수는 아닙니다. 코드가 없는 텍스트 문서와 R·Python 코드를 실행하는 보고서를 구분하고 사용하는 엔진의 요구사항을 확인하세요.
R에서 quarto 패키지를 설치하면 준비가 끝나나요?
+
R 패키지는 설치된 Quarto CLI를 호출하는 선택적 인터페이스입니다. Quarto CLI를 별도로 설치해야 하며 R 패키지 설치만으로 CLI 준비가 끝나지 않습니다.
PDF를 만들려면 TeX와 Typst를 모두 설치해야 하나요?
+
선택한 출력 방식을 기준으로 준비합니다. LaTeX PDF에는 TeX 환경이 필요하고 Typst 형식은 Quarto에 포함된 Typst CLI를 사용합니다. 두 방식의 기능과 문법은 같지 않습니다.
안정판과 사전판 중 무엇을 받나요?
+
일반 작업은 다운로드 허브의 Current Release 안정판을 기준으로 OS·설치 조건을 확인하세요. Pre-release는 별도 개발 단계의 배포이며 같은 것으로 선택하지 마세요.
8. 참고 자료
관련 프로그램
