하나의 원고, 네 개의 엔진:
Markdown, pandoc, Quarto & Typst

대부분의 글쓰기 도구는 형식을 하나 고르고 그 출력에 만족하라고 합니다. Folio Writer는 두 결정을 분리합니다. 일반 텍스트로 한 번 쓰고, 컴파일할 때마다 렌더링 엔진을 고르세요. 학위논문 심사위원회, 저널, 프리프린트 서버가 같은 것을 원하는 일은 드물기 때문입니다.

Markdown: 원본이 되는 소스

Folio Writer 프로젝트의 일반 문서는 모두 평범한 .md 파일입니다. 학술 글쓰기에 중요한 확장을 갖춘 pandoc 방식의 Markdown으로, [@citations], $math$ , 각주, 파이프 표와 그리드 표, @fig:/@tbl:/@eq: 상호 참조, 작업 목록, 위키링크를 지원합니다. 편집기는 이를 실시간으로 렌더링하지만(스타일이 적용된 제목, 조판된 수식, 해석된 인용), 파일은 grep으로 검색하고, diff로 비교하고, 2040년에도 열 수 있는 텍스트로 남습니다. 아래의 어떤 것도 이 사실을 바꾸지 않습니다. 엔진은 파일 형식이 아니라 출력의 선택입니다.

pandoc: 만능 번역기

기본 파이프라인입니다. 컴파일은 바인더를 하나의 문서로 이어 붙여 pandoc에 넘기고, pandoc은 Word (.docx), OpenDocument (.odt), LaTeX (.tex), HTML, EPUB을 만들어 냅니다. TeX 배포판이 있으면 xelatex, pdflatex, lualatex, tectonic을 통해 저널에서 익숙한 고전적인 PDF도 만듭니다. 인용은 citeproc이 어떤 CSL 스타일로든 서식화하고, pandoc-crossref가 그림, 표, 수식에 번호를 매깁니다. Folio는 이어 붙인 독립형 .md도 내보낼 수 있습니다. pandoc manuscript.md -o out.pdf --citeproc 하나로 어디서든 같은 결과물을 재현할 수 있고, 그것이 바로 일반 텍스트의 핵심입니다.

Quarto: 저널과 실행 가능한 코드

렌더러를 Quarto로 바꾸면 두 개의 문이 열립니다. 첫째, 출판사 양식 그대로의 출력(저널 제출 가이드 참고): 저널 확장(AGU, Elsevier, Copernicus…)을 추가하고, 메타데이터 한 줄(quarto-to: agu-pdf)을 설정한 뒤 컴파일하세요. Folio는 구조화된 저자와 소속 정보를 저널 템플릿이 쓸 수 있도록 그대로 넘기고, 저널 클래스와 충돌할 일반 레이아웃 키는 제거합니다. 둘째, 실행 가능한 원고: {python}과 {r} 셀이 컴파일할 때 실행되므로, 빌드할 때마다 그림이 데이터에서 다시 생성됩니다(동적 플롯 참고). 어디서든 @fig:xrd라고 쓰세요. Folio가 Quarto 고유의 대시 문법으로 자동 변환하므로, 두 렌더러 모두 하나의 문법으로 충분합니다.

Typst: 빠르고 현대적인 조판기

Typst는 LaTeX를 오늘날 설계했다면 이런 모습이었을 것입니다. TeX 배포판 없이 1초도 안 되어 LaTeX 수준의 PDF를 만들어 냅니다. Typst는 작은 단일 바이너리(brew install typst)로, 조판된 PDF에 이르는 단연 가장 가벼운 길입니다. Folio는 Markdown 원고를 Typst 소스로 변환하고(인용, 상호 참조, 번호, 목차 포함) 컴파일합니다. 또는 .typ 파일 자체를 내보내 typst watch로 직접 다듬을 수도 있습니다. 변환을 넘어 Typst는 일급 문서 유형이기도 합니다. 바인더에 네이티브 .typ 문서를 만들어(맞춤 표, 정밀한 그림 배치, #show 규칙) 한 프로젝트 안에서 Markdown 장과 섞고 함께 컴파일하세요.

언제 어떤 엔진을?

필요한 것	사용할 것
심사위원회나 공저자를 위한 Word 파일	pandoc → .docx(변경 내용 추적 지원)
LibreOffice / OpenOffice용 OpenDocument	pandoc → .odt(수식은 네이티브 ODF 수식으로)
최소한의 설정으로 만드는 아름다운 PDF	Typst 렌더러(`brew install typst` — TeX 불필요)
저널 양식 그대로의 제출(AGU, Elsevier…)	Quarto + 저널 확장
컴파일할 때 데이터로 생성하는 그림	Quarto + `{python}`/`{r}` 셀
제출 시스템용 LaTeX 소스	pandoc 또는 Quarto → .tex
손으로 하는 정밀한 타이포그래피 제어	네이티브 .typ 문서 / .typ 내보내기

도구 안내: App Store 버전은 샌드박스 안에서 실행되므로, 외부 도구(pandoc, pandoc-crossref, TeX 배포판, Quarto, 그리고 Typst까지)는 무료 Folio Helper를 통해 실행됩니다. Folio Helper는 Folio Writer가 요청할 때만, 고정된 허용 목록에 있는 도구만 실행합니다. 그중 Typst가 가장 가볍습니다. 단일 바이너리이고 TeX 배포판이 필요 없습니다. 실시간 미리보기에는 도구가 전혀 필요 없습니다. 텍스트, 수식, 인용을 오프라인에서 자체적으로 조판합니다.

관통하는 원칙

네 개의 엔진, 하나의 원칙: 원고는 결코 렌더러의 것이 아닙니다. 같은 일반 파일 폴더로 월요일에는 심사위원회에 낼 Word 문서를, 수요일에는 저널에 낼 LaTeX를, 금요일에는 Typst로 조판한 프리프린트를 만들 수 있습니다. 그리고 언젠가 Folio Writer를 떠나더라도 그 파일들은 모두 여전히 열리고, 읽히고, 컴파일됩니다.

Folio Writer 무료 다운로드 → · 더 많은 가이드

하나의 원고, 네 개의 엔진:Markdown, pandoc, Quarto & Typst