quarto

어떤 작업에 쓰는가

Quarto는 연구자, 데이터 분석가, 기술 문서 작성자가 설명과 계산 결과를 함께 관리할 때 적합합니다. 원고 안에 분석 코드를 넣어 렌더링하면 글·표·그래프가 하나의 결과물로 만들어집니다. 데이터가 바뀌는 보고서를 반복 작성하거나, 같은 내용을 웹 문서와 제출용 문서로 제공하는 작업에 유용합니다.

독립적인 워드프로세서보다는 기존 편집기와 명령줄을 연결하는 출판 시스템에 가깝습니다. VS Code·RStudio·JupyterLab 등에서 작성할 수 있으며, 분석 코드가 없는 일반 기술 문서도 만들 수 있습니다. [공식 홈페이지](https://quarto.org/)

지원 운영체제와 배포 상태

입력 정보에는 macOS만 기재되어 있지만 공식 FAQ는 Windows·macOS·Linux 설치를 안내합니다. 따라서 macOS 전용 프로그램으로 소개하면 부정확합니다.

2026-10-09 확인한 공식 GitHub 배포 페이지에는 v1.10.19가 Latest로 표시되어 입력 버전과 일치했습니다. 공식 다운로드 페이지에도 현재 배포 안내와 변경 기록이 있어 지원 종료 프로그램으로 볼 근거는 확인되지 않았습니다. 다만 기기별 최소 OS 버전과 CPU 호환성은 설치 전 배포 조건을 별도로 확인해야 합니다. [공식 FAQ](https://quarto.org/docs/faq/index.html), [v1.10.19 배포](https://github.com/quarto-dev/quarto-cli/releases/tag/v1.10.19)

설치와 첫 문서 작성 순서

공식 다운로드 페이지에서 운영체제에 맞는 Quarto 설치 파일을 선택하고, 사용할 편집기를 정하는 순서로 시작합니다. Python 분석을 포함하려면 Python·Jupyter와 해당 분석에 필요한 패키지도 준비해야 합니다.

첫 작업은 코드 없이 hello.qmd에 제목과 짧은 Markdown 본문을 작성하는 방식이 간단합니다. 파일이 있는 폴더에서 quarto preview hello.qmd로 브라우저 미리보기를 확인한 뒤, quarto render hello.qmd --to html로 결과물을 생성합니다. Word 문서가 필요하면 --to docx를 사용합니다. 이후 코드 셀과 그림 설명을 추가하면 문제 발생 지점을 구분하기 쉽습니다. [첫 작업 튜토리얼](https://quarto.org/docs/get-started/hello/text-editor.html)

실무 예시와 출력 형식 선택

예를 들어 월별 매출 CSV를 Python으로 집계하는 보고서에 계산 코드, 추이 그래프, 해설을 함께 넣을 수 있습니다. 다음 달에는 데이터와 설명을 갱신하고 다시 렌더링하는 흐름입니다. 분석 환경과 입력 데이터도 함께 관리해야 같은 계산을 재현할 수 있습니다.

HTML에서는 코드 접기나 대화형 그래프를 활용하고, 검토용 문서는 Word로 출력하는 구성이 가능합니다. 그림 번호와 본문 참조를 연결하면 문서 구조를 바꿀 때 번호를 일일이 고칠 부담도 줄어듭니다. 출력 형식마다 표현 방식이 다르므로 최종 결과를 각각 확인하는 것이 좋습니다. [공식 기능 안내](https://quarto.org/)

무료 사용과 기능상의 제약

공식 FAQ는 Quarto를 무료로 사용할 수 있는 오픈소스로 설명합니다. 작성한 독자적인 콘텐츠에는 사용자가 원하는 라이선스를 적용할 수 있다고 안내합니다. 확인한 자료에는 Quarto 자체의 무료판·유료판 기능 구분이 제시되어 있지 않습니다.

외부 호스팅이나 조직용 서비스의 이용 조건은 별도입니다. 또한 Quarto 자체에는 전용 실시간 공동 편집 기능이 없으며, .qmd를 일반 텍스트·코드 파일처럼 협업합니다. PDF를 LaTeX 경로로 생성하려면 별도의 TeX 환경이 필요하므로 기본 설치만으로 모든 출력 준비가 끝나는 것은 아닙니다. [공식 FAQ](https://quarto.org/docs/faq/index.html), [PDF 준비 조건](https://quarto.org/docs/output-formats/pdf-basics.html)

문제가 생겼을 때 확인 순서

Python 코드 실행에 실패하면 먼저 quarto check jupyter로 연동 상태를 확인합니다. 이어 Quarto가 선택한 Python 환경, Jupyter 설치 여부, 코드에서 사용하는 패키지 순서로 점검합니다. macOS에서는 PATH를 통해 Python을 선택하며, 필요한 경우 QUARTO_PYTHON으로 사용할 실행 파일을 지정할 수 있습니다. [Python 환경 안내](https://quarto.org/docs/computations/python.html)

HTML은 만들어지는데 PDF만 실패하면 TeX 설치와 오류 로그를 먼저 확인합니다. 한국어 글자가 빠지거나 깨지면 해당 글자를 지원하는 시스템 글꼴과 PDF의 mainfont·CJKmainfont 설정을 점검합니다. 데이터 실행 문제와 출력 형식 문제를 나누어 확인하면 원인 범위를 줄일 수 있습니다. [PDF 글꼴 안내](https://quarto.org/docs/output-formats/pdf-basics.html)

다른 도구와 선택 기준

이미 R Markdown으로 안정적인 보고서를 운영한다면 전환 자체가 필수는 아닙니다. 공식 문서는 R Markdown을 계속 지원하며 폐기 계획이 없다고 설명합니다. 새 프로젝트에서 여러 언어와 문서·책·웹사이트를 공통 흐름으로 관리하려면 Quarto를 검토할 만합니다. 기존 Rmd도 대부분 수정 없이 렌더링할 수 있지만 사용자 정의 형식은 호환성을 확인해야 합니다.

Jupyter를 사용한다면 편집기를 바꾸기보다 기존 노트북을 Quarto로 출력하는 접근도 가능합니다. 선택 기준은 분석 언어, 필요한 결과 형식, 반복 생성 여부입니다. [R Markdown 사용자 FAQ](https://quarto.org/docs/faq/rmarkdown.html)

공식 안내

• Quarto · 확인 2026-10-09
• Download Quarto · 확인 2026-10-09
• Frequently Asked Questions · 확인 2026-10-09
• Release v1.10.19 · quarto-dev/quarto-cli · 확인 2026-10-09
• Tutorial: Hello, Quarto · 확인 2026-10-09
• PDF Basics · 확인 2026-10-09
• Using Python · 확인 2026-10-09
• FAQ for R Markdown Users · 확인 2026-10-09