Revealjs 옵션

Revealjs는 오픈 소스 HTML 프레젠테이션 프레임워크입니다. 자세한 내용은 https://revealjs.com/을 참고하세요.

Quarto로 Revealjs 출력을 만드는 자세한 방법은 Revealjs 형식 사용자 가이드를 참고하세요.

format: revealjs

제목 및 저자

title	문서 제목
subtitle	문서의 부제목을 지정합니다.
date	문서 날짜
date-format	문서의 날짜 형식
author	문서의 저자
institute	프레젠테이션의 저자 소속입니다.
order	웹사이트 자동 사이드바 메뉴에 포함될 때 사용할 문서 순서입니다.

형식 옵션

brand	이 문서에 사용할 브랜딩 정보입니다. 문자열이면 브랜드 파일의 경로입니다. false이면 이 문서에 브랜딩을 사용하지 않습니다. 객체이면 인라인 브랜드 정의이거나, 밝은/어두운 브랜드 경로 또는 정의를 가진 객체입니다.
theme	테마 이름, 테마 scss 파일, 또는 둘의 조합입니다.
css	CSS 스타일시트 하나 이상입니다.
identifier-prefix	HTML 및 DocBook 출력의 모든 식별자와 내부 링크, Markdown 및 Haddock 출력의 각주 번호에 접두사를 추가합니다. 다른 페이지에 포함될 조각을 생성할 때 중복 식별자를 방지하는 데 유용합니다.
email-obfuscation	HTML 문서에서 mailto: 링크를 난독화하는 방법을 지정합니다. javascript: JavaScript로 링크를 난독화합니다. references: 문자를 10진수 또는 16진수 문자 참조로 출력하여 링크를 난독화합니다. none (기본값): 링크를 난독화하지 않습니다.
html-q-tags	HTML에서 인용에 <q> 태그를 사용합니다.
quarto-required	이 문서 또는 프로젝트에서 지원되는 quarto 버전을 설명하는 semver 범위입니다. 예시: >= 1.1.0: quarto 버전 1.1 이상 필요 1.*: 주요 버전 번호가 1인 모든 quarto 버전 필요

목차

toc	출력 문서에 자동 생성된 목차를 포함합니다(또는 latex, context, docx, odt, opendocument, rst, ms의 경우 목차를 생성하라는 지시를 포함합니다). ms를 통해 PDF를 생성하는 경우 목차는 제목 앞의 문서 시작 부분에 나타납니다. 문서 끝에 두고 싶다면 pdf-engine-opt: --no-toc-relocation 옵션을 사용합니다.
toc-depth	목차에 포함할 섹션 레벨 수를 지정합니다. 기본값은 3입니다.
toc-title	목차에 사용할 제목입니다.

번호 매기기

number-sections	출력에 렌더링된 섹션 제목에 번호를 매깁니다. 기본적으로 섹션은 번호가 매겨지지 않습니다. 클래스가 .unnumbered인 섹션은 number-sections가 지정되어도 번호가 매겨지지 않습니다.
number-depth	기본적으로 문서의 모든 제목은 번호가 매겨진 섹션을 만듭니다. number-depth 옵션으로 번호 매기기 깊이를 사용자 지정할 수 있습니다. 예를 들어 장(chapter) 바로 아래 수준의 섹션에만 번호를 매기려면 다음과 같이 지정합니다: number-depth: 1
number-offset	출력에서 섹션 제목 번호의 오프셋입니다(기본값은 0). 첫 번째 숫자는 최상위 제목의 번호에, 두 번째는 2단계 제목에 더해지는 식으로 적용됩니다. 예를 들어 문서의 첫 최상위 제목 번호를 “6”으로 하려면 number-offset: 5를 지정합니다. 문서가 레벨 2 제목으로 시작하고 이를 “1.5”로 번호 매기고 싶다면 number-offset: [1,4]를 지정합니다. number-sections를 암시합니다.
shift-heading-level-by	제목 레벨을 양수 또는 음수 정수만큼 이동합니다. 예를 들어 shift-heading-level-by: -1이면 레벨 2 제목이 레벨 1 제목이 되고, 레벨 3 제목이 레벨 2 제목이 됩니다. 제목 레벨은 1보다 낮을 수 없으므로 레벨 1 아래로 이동되는 제목은 일반 문단이 됩니다. 예외적으로 -N만큼 이동할 때, 문서 시작의 레벨 N 제목은 메타데이터 제목을 대체합니다.

슬라이드

incremental	슬라이드 쇼의 목록 항목을 하나씩 단계적으로 표시합니다. 기본값은 목록을 한 번에 표시하는 것입니다.
slide-level	지정된 수준의 제목이 슬라이드를 생성하도록 지정합니다. 이 수준보다 상위의 제목은 슬라이드쇼를 섹션으로 나누는 데 사용되며, 하위 제목은 슬라이드 내의 하위 제목으로 사용됩니다. 값은 0~6입니다. 슬라이드 수준을 0으로 지정하면 제목에 의해 자동으로 분할되지 않으며, 슬라이드 경계는 수평선으로 표시해야 합니다. 슬라이드 수준을 명시적으로 지정하지 않으면 문서 내용에 따라 자동으로 설정됩니다.
slide-number	현재 슬라이드의 페이지 번호를 표시합니다. true: 슬라이드 번호 표시 false: 슬라이드 번호 숨김 번호 형식을 지정하는 문자열로 설정할 수도 있습니다: h.v: 가로 . 세로 슬라이드 번호 h/v: 가로 / 세로 슬라이드 번호 c: 평면화된 슬라이드 번호 c/t: 평면화된 슬라이드 번호 / 전체 슬라이드 수(기본값)
show-slide-number	슬라이드 번호를 표시할 컨텍스트입니다(all, print, speaker).
title-slide-attributes	reveal.js 프레젠테이션의 제목 슬라이드에 대한 추가 속성을 속성 이름과 값의 맵으로 지정합니다. 예: title-slide-attributes: data-background-image: /path/to/title_image.png data-background-size: contain (여기서는 data- 접두사가 자동으로 추가되지 않으므로 반드시 포함해야 합니다.)
title-slide-style	제목 슬라이드 스타일입니다. pandoc를 사용하면 Pandoc 기본 제목 슬라이드 스타일을 선택합니다.
center-title-slide	제목 슬라이드의 세로 중앙 정렬
show-notes	발표자 노트를 모든 뷰어에 표시합니다.
rtl	프레젠테이션 방향을 RTL로 변경합니다.

슬라이드 콘텐츠

logo	로고 이미지(슬라이드 오른쪽 아래에 배치)
footer	모든 슬라이드에 포함할 바닥글입니다. 슬라이드에 .footer 클래스의 div를 포함하면 슬라이드별로 설정할 수도 있습니다.
scrollable	슬라이드에서 세로로 넘치는 콘텐츠를 스크롤할 수 있게 하려면 true를 사용합니다. 슬라이드 제목에 .scrollable 클래스를 포함해 슬라이드별로 설정할 수도 있습니다.
smaller	슬라이드 콘텐츠에 더 작은 기본 글꼴을 사용하려면 true를 사용합니다. 슬라이드 제목에 .smaller 클래스를 포함해 슬라이드별로 설정할 수도 있습니다.
output-location	코드에 대해 출력이 위치하는 곳입니다. 가능한 값은 다음과 같습니다: default: 코드 다음에 일반적인 슬라이드 흐름 fragment: 프래그먼트 안(진행하기 전에는 보이지 않음) slide: 현재 슬라이드 다음의 새 슬라이드 column: 인접한 컬럼 column-fragment: 인접한 컬럼(진행하기 전에는 보이지 않음) 이 옵션은 revealjs 형식에서만 지원됩니다.

슬라이드 도구

overview	슬라이드 개요 모드를 활성화합니다.
menu	revealjs 메뉴 설정입니다.
chalkboard	revealjs 칠판(chalkboard) 설정입니다.
multiplex	reveal 프레젠테이션 멀티플렉싱 설정입니다.
scroll-view	Revealjs의 스크롤 보기 기능을 제어합니다.

전환

transition	슬라이드 배경의 전환 스타일입니다. (none, fade, slide, convex, concave, zoom)
transition-speed	슬라이드 전환 속도(default, fast, slow)
background-transition	전체 페이지 슬라이드 배경의 전환 스타일입니다. (none, fade, slide, convex, concave, zoom)
fragments	프래그먼트를 전역으로 켜거나 끕니다.
auto-animate	자동 애니메이션을 전역으로 활성화/비활성화합니다(기본값 활성화).
auto-animate-easing	자동 애니메이션의 기본 CSS 이징 함수입니다. 슬라이드 또는 요소별 속성으로 재정의할 수 있습니다.
auto-animate-duration	자동 애니메이션 전환의 지속 시간(초)입니다. 슬라이드 또는 요소별 속성으로 재정의할 수 있습니다.
auto-animate-unmatched	일치하지 않는 요소를 자동 애니메이션 처리합니다. 슬라이드 또는 요소별 속성으로 재정의할 수 있습니다.
auto-animate-styles	자동 애니메이션이 가능한 CSS 속성입니다( top, left 같은 위치 관련 스타일은 항상 애니메이션됨).

내비게이션

progress	프레젠테이션 진행 표시줄을 표시합니다.
history	각 슬라이드 변경을 브라우저 히스토리에 기록합니다.
navigation-mode	내비게이션 방향 동작을 변경합니다. linear: 위/아래 화살표를 제거합니다. 왼쪽/오른쪽 화살표로 모든 슬라이드(가로/세로)를 이동합니다. vertical: 왼쪽/오른쪽 화살표는 가로 슬라이드 사이를 이동하고, 위/아래 화살표는 세로 슬라이드 사이를 이동합니다. 스페이스 키는 모든 슬라이드(가로/세로)를 이동합니다. grid: 활성화하면 세로 스택에서 좌/우로 이동 시 인접 세로 스택의 같은 세로 인덱스로 이동합니다.
touch	터치 입력 기기에서 터치 내비게이션을 활성화합니다.
keyboard	내비게이션용 키보드 단축키를 활성화합니다.
mouse-wheel	마우스 휠로 슬라이드 내비게이션을 활성화합니다.
hide-inactive-cursor	비활성 상태일 때 커서를 숨깁니다.
hide-cursor-time	커서가 숨겨지기 전 대기 시간(밀리초)
loop	프레젠테이션을 반복합니다.
shuffle	프레젠테이션이 로드될 때마다 슬라이드 순서를 무작위로 바꿉니다.
controls	슬라이드 이동을 위한 화살표 컨트롤을 표시합니다. true: 항상 컨트롤 표시 false: 컨트롤 표시하지 않음 auto (기본값): 세로 슬라이드가 있거나 덱이 iframe에 임베드된 경우에만 표시
controls-layout	내비게이션 컨트롤 위치(edges 또는 bottom-right)
controls-tutorial	시각적 힌트로 사용자가 조작 방법을 익히도록 돕습니다.
controls-back-arrows	뒤로 가기 내비게이션 화살표의 표시 규칙입니다(faded, hidden, visible).
auto-slide	지정된 간격으로 모든 슬라이드를 자동 진행합니다.
auto-slide-stoppable	사용자 입력 후 자동 슬라이딩을 중지합니다.
auto-slide-method	자동 슬라이딩 시 사용할 내비게이션 방법입니다(기본값 navigateNext).
default-timing	슬라이드당 예상 평균 시간(발표자 보기의 페이싱 타이머에서 사용)
pause	프레젠테이션 일시 정지(암전) 가능 여부를 설정합니다.
help	? 키를 누르면 도움말 오버레이를 표시합니다.
hash	현재 슬라이드를 URL 해시에 추가합니다.
hash-type	URL 해시 유형(number 또는 title)
hash-one-based-index	슬라이드 번호에 맞추기 위해 해시 링크를 1부터 시작하는 인덱싱을 사용합니다.
respond-to-hash-changes	해시를 모니터링하고 이에 따라 슬라이드를 변경합니다.
fragment-in-url	현재 프래그먼트를 URL에 포함합니다.
slide-tone	슬라이드 전환 시 은은한 소리를 재생합니다.
jump-to-slide	슬라이드로 점프하는 기능을 비활성화합니다.

PDF로 인쇄

pdf-max-pages-per-slide	한 페이지에 들어가지 않을 만큼 높은 슬라이드는 여러 페이지로 확장됩니다. 이 옵션으로 슬라이드가 확장될 수 있는 페이지 수를 제한할 수 있습니다.
pdf-separate-fragments	각 프래그먼트를 별도 슬라이드로 출력합니다.
pdf-page-height-offset	내보낸 PDF 페이지에서 콘텐츠 높이를 줄이기 위한 오프셋입니다. PDF 출력 방식에 따른 환경 차이를 보정하기 위해 존재합니다. phantomjs, wkpdf 같은 CLI 출력은 문서 전체 높이에서 정확히 끝날 수 있지만, 브라우저 출력은 1픽셀 전에 끝나야 합니다.

미디어

preview-links	링크를 iframe 미리보기 오버레이에서 엽니다. true: iframe 미리보기 오버레이로 링크 열기 false: iframe 미리보기 오버레이로 열지 않음 auto (기본값): 전체 화면 모드로 iframe 미리보기 오버레이에서 링크 열기
auto-play-media	임베드된 미디어를 자동 재생합니다(null, true, false). 기본값은 null이며 autoplay 속성이 지정된 경우에만 적용됩니다.
preload-iframes	지연 로드된 iframe의 사전 로딩을 전역으로 재정의합니다. null: data-src와 data-preload가 모두 있는 iframe은 viewDistance 안에 들어오면 로드되고, data-src만 있는 iframe은 보일 때 로드됩니다. true: data-src가 있는 모든 iframe을 viewDistance 안에 들어오면 로드합니다. false: data-src가 있는 모든 iframe을 보일 때만 로드합니다.
view-distance	현재 슬라이드에서 몇 장 떨어진 곳까지 리소스를 사전 로드할지 설정합니다.
mobile-view-distance	(모바일 기기) 현재 슬라이드에서 몇 장 떨어진 곳까지 리소스를 사전 로드할지 설정합니다.
parallax-background-image	패럴랙스 배경 이미지
parallax-background-size	패럴랙스 배경 크기(예: ‘2100px 900px’)
parallax-background-horizontal	슬라이드당 패럴랙스 배경의 가로 이동 픽셀 수입니다.
parallax-background-vertical	슬라이드당 패럴랙스 배경의 세로 이동 픽셀 수입니다.

슬라이드 레이아웃

auto-stretch	최상위 이미지가 하나인 슬라이드는 자동으로 늘려 슬라이드를 채웁니다.
width	프레젠테이션의 ‘기본’ 너비입니다. 해상도에 맞게 스케일링할 때 종횡비가 유지됩니다. 퍼센트 단위로 지정할 수 있습니다.
height	프레젠테이션의 ‘기본’ 높이입니다. 해상도에 맞게 스케일링할 때 종횡비가 유지됩니다. 퍼센트 단위로 지정할 수 있습니다.
margin	revealjs의 경우 콘텐츠 주변에 비워둘 화면 크기 비율입니다(예: 0.1). typst의 경우 Typst 문서에 정의된 필드를 가진 딕셔너리입니다: x, y, top, bottom, left, right(여백은 cm 단위, 예: 5cm).
min-scale	콘텐츠에 적용할 수 있는 최소 스케일 한계
max-scale	콘텐츠에 적용할 수 있는 최대 스케일 한계
center	슬라이드의 세로 중앙 정렬
disable-layout	기본 reveal.js 슬라이드 레이아웃(확대/축소 및 중앙 정렬)을 비활성화합니다.
code-block-height	프레젠테이션에 표시되는 소스 코드 블록의 최대 높이를 설정합니다.

레이아웃

cap-location	그림 및 표 캡션을 배치할 위치입니다(top, bottom, margin).
fig-cap-location	그림 캡션을 배치할 위치입니다(top, bottom, margin).
tbl-cap-location	표 캡션을 배치할 위치입니다(top, bottom, margin).
classoption	LaTeX/PDF 출력에서 문서 클래스에 설정할 옵션입니다. KaTeX를 사용하는 HTML 출력의 경우 classoption: fleqn으로 디스플레이 수식을 왼쪽 정렬할 수 있습니다.
brand-mode	문서를 렌더링할 때 사용할 브랜드 모드(light 또는 dark)입니다.
grid	Quarto HTML 페이지를 레이아웃하는 데 사용하는 그리드 시스템의 속성입니다.
max-width	body 요소에 CSS max-width를 추가합니다.
margin-left	HTML 출력의 경우 Body 요소에 margin-left 속성을 설정합니다. LaTeX 출력의 경우 geometry가 사용되지 않으면 왼쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다). ConTeXt 출력의 경우 layout을 사용하지 않으면 왼쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다. wkhtmltopdf의 경우 왼쪽 페이지 여백을 설정합니다.
margin-right	HTML 출력의 경우 Body 요소에 margin-right 속성을 설정합니다. LaTeX 출력의 경우 geometry가 사용되지 않으면 오른쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다). ConTeXt 출력의 경우 layout을 사용하지 않으면 오른쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다. wkhtmltopdf의 경우 오른쪽 페이지 여백을 설정합니다.
margin-top	HTML 출력의 경우 Body 요소에 margin-top 속성을 설정합니다. LaTeX 출력의 경우 geometry가 사용되지 않으면 위쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다). ConTeXt 출력의 경우 layout을 사용하지 않으면 위쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다. wkhtmltopdf의 경우 위쪽 페이지 여백을 설정합니다.
margin-bottom	HTML 출력의 경우 Body 요소에 margin-bottom 속성을 설정합니다. LaTeX 출력의 경우 geometry가 사용되지 않으면 아래쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다). ConTeXt 출력의 경우 layout을 사용하지 않으면 아래쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다. wkhtmltopdf의 경우 아래쪽 페이지 여백을 설정합니다.

코드

code-fold	코드를 HTML <details> 태그로 접어 필요할 때 펼쳐 볼 수 있게 합니다. true: 코드 접기 false (기본값): 코드 접지 않음 show: <details> 태그를 사용하되 처음에 펼친 상태로 표시
code-summary	code-fold로 접힌 코드 블록에 사용할 요약 텍스트
code-overflow	코드 줄이 컨테이너보다 넓을 때 오버플로 처리 방식을 선택합니다. scroll wrap
code-line-numbers	코드 블록 출력에 줄 번호를 포함합니다(true 또는 false). revealjs 출력에서만 특정 줄을 강조 표시하거나(또는 강조 단계 간 애니메이션을) 문자열로 지정할 수 있습니다. 줄 집합은 쉼표로 구분합니다: 3,4,5 1,10,12 범위는 대시로 표기하고 쉼표로 결합할 수 있습니다: 1-3,5 5-10,12,14 마지막으로 애니메이션 단계는 |로 구분합니다: 1-3|1-3,5는 먼저 1-3, 다음에 1-3,5를 표시 |5|5-10,12는 먼저 번호 없음, 다음 5, 이후 5-10과 12
code-copy	코드 블록에 코드 복사 아이콘을 활성화합니다. true: 항상 아이콘 표시 false: 아이콘 표시하지 않음 hover (기본값): 마우스를 코드 블록 위에 올렸을 때 아이콘 표시
code-link	코드 블록 내 함수에 온라인 문서로의 하이퍼링크를 활성화합니다. 코드 링크는 현재 knitr 엔진에서만(downlit 패키지 통해) 구현됩니다. downlit의 제한으로 code-line-numbers가 true인 경우 코드 링크가 동작하지 않습니다.
code-annotations	코드 주석을 표시할 때 사용할 스타일입니다. 이 값을 false로 설정하면 코드 주석을 숨깁니다.
highlight-style	하이라이트된 소스 코드에 사용할 색상 스타일을 지정합니다. STYLE 이름 대신 확장자가 .theme인 JSON 파일을 제공할 수 있습니다. 이 파일은 KDE 구문 강조 테마로 파싱되며(유효한 경우) 강조 스타일로 사용됩니다.
syntax-definitions	KDE 언어 구문 정의 파일(XML)
indented-code-classes	모든 들여쓰기 코드 블록에 사용할 클래스를 지정합니다.

실행

실행 옵션은 execute 키 아래에 지정해야 합니다. 예:

execute:
  echo: false
  warning: false

eval	코드 셀을 실행합니다(false이면 코드만 출력에 에코합니다). true (기본값): 코드 셀을 실행 false: 코드 셀을 실행하지 않음 [...]: 표현식을 선택적으로 포함 또는 제외하기 위한 양수 또는 음수 숫자 목록 (표현식의 명시적 포함/제외는 knitr 엔진을 사용할 때만 가능합니다)
echo	렌더링된 출력에 셀 소스 코드를 포함합니다. true (대부분의 형식에서 기본값): 소스 코드를 출력에 포함 false (beamer, revealjs, pptx 같은 프레젠테이션 형식의 기본값): 소스 코드를 출력에 포함하지 않음 fenced: 에코 외에도 셀 구분자를 출력의 일부로 포함 [...]: 선택적으로 포함하거나 제외할 줄 번호의 양수 또는 음수 목록 (줄의 명시적 포함/제외는 knitr 엔진을 사용할 때만 가능합니다)
output	코드 실행 결과를 출력에 포함합니다. 가능한 값: true: 결과를 포함합니다. false: 결과를 포함하지 않습니다. asis: 출력물을 원시 마크다운으로 처리하고 감싸는 컨테이너를 사용하지 않습니다.
warning	렌더링된 출력에 경고를 포함합니다.
error	출력에 오류를 포함합니다(이는 코드 실행 오류가 문서 처리를 중단하지 않음을 의미합니다).
include	어떤 출력(코드 또는 결과)도 출력에 포함되지 않도록 하는 포괄 옵션입니다.
cache	계산 결과를 캐시합니다(R 문서에는 knitr cache를, Jupyter 문서에는 Jupyter Cache를 사용). 캐시 무효화는 청크 소스 코드 변경 (또는 정의한 다른 캐시 속성 변경)으로 트리거됩니다. true: 결과를 캐시 false: 결과를 캐시하지 않음 refresh: 다른 이유로 무효화되지 않았더라도 캐시를 강제로 새로 고침
freeze	렌더링 시 이전 계산 출력의 재사용을 제어합니다. true: 전역 프로젝트 렌더 시 이전에 생성된 계산 출력은 재계산하지 않음 false (기본값): 이전에 생성된 계산 출력을 재계산 auto: 소스 파일이 변경된 경우에만 이전 계산 출력을 재계산

그림

fig-align	그림의 가로 정렬(default, left, right, center)
fig-cap-location	그림 캡션을 배치할 위치입니다(top, bottom, margin).
fig-width	Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 너비입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.
fig-height	Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 높이입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.
fig-format	Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 형식(retina, png, jpeg, svg, pdf)
fig-dpi	Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 DPI입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.
fig-asp	그림의 종횡비, 즉 높이/너비 비율입니다. fig-asp를 지정하면 그림의 높이(fig-height 옵션)는 fig-width * fig-asp에서 계산됩니다. fig-asp 옵션은 knitr 엔진에서만 사용할 수 있습니다.
fig-responsive	이 문서의 이미지를 반응형으로 만들지 여부입니다.

표

tbl-colwidths	columns 문자(기본 72)보다 넓은 마크다운 그리드/파이프 표에 대해 명시적 열 너비를 적용합니다. 일부 형식(예: HTML)은 표 열 너비를 자동으로 잘 조정하므로 명시적 열 너비 지정의 효과가 크지 않습니다. 다른 형식(예: LaTeX)은 긴 셀 콘텐츠를 올바르게 흐르게 하려면 열 크기가 필요합니다(이 때문에 72열을 넘는 표에는 Pandoc이 명시적 너비를 지정합니다). 다음과 같이 지정할 수 있습니다: auto: 표에 하이퍼링크가 있을 때를 제외하고 마크다운 표 열 너비를 적용(하이퍼링크는 셀의 마크다운 텍스트 폭 기준 자동 계산을 흔들 수 있음). (auto는 HTML 출력 형식의 기본값) true: 항상 마크다운 표 너비 적용(true는 비HTML 형식의 기본값) false: 마크다운 표 너비를 적용하지 않음. 숫자 배열(예: [40, 30, 30]): 명시적 너비 백분율 배열.
tbl-cap-location	표 캡션을 배치할 위치입니다(top, bottom, margin).
df-print	Knitr 엔진 문서에서 표를 출력하는 데 사용하는 방법입니다: default: 데이터 프레임의 기본 S3 메서드를 사용 kable: knitr::kable() 함수를 사용하는 마크다운 표 tibble: tibble 패키지를 사용하는 일반 텍스트 표 paged: 행과 열 오버플로에 페이징을 적용한 HTML 표 기본 출력 방식은 kable입니다.

링크

link-external-icon	현재 사이트를 떠나는 링크 옆에 특수 아이콘을 표시합니다.
link-external-newwindow	외부 링크를 현재 탭이 아닌 새 창/탭에서 엽니다.
link-external-filter	링크가 내부 링크인지 판단하는 데 사용할 수 있는 정규식입니다. 예를 들어 다음 정규식은 http://www.quarto.org/custom 또는 https://www.quarto.org/custom로 시작하는 링크를 내부 링크로 간주합니다(그 외는 외부 링크로 간주). ^(?:http:|https:)\/\/www\.quarto\.org\/custom

참고문헌

bibliography	문서 참고문헌(BibTeX 또는 CSL). 단일 파일 또는 파일 목록일 수 있습니다.
csl	참고문헌 서식에 사용할 Citation Style Language 파일입니다.
citations-hover	인용 위에 마우스를 올리면 참고문헌 정보를 보여주는 팝업을 활성화합니다.
citeproc	내장 인용 처리를 활성화합니다. 이 기능을 사용하려면 인용이 포함된 문서와 서지 데이터 소스가 필요합니다. 외부 참고문헌 파일 또는 문서의 YAML 메타데이터에 있는 references 목록을 사용할 수 있습니다. 선택적으로 csl 인용 스타일 파일도 포함할 수 있습니다.
citation-abbreviations	form="short"가 지정된 경우 형식화된 참고문헌에서 사용할 저널 약어를 포함하는 JSON 파일입니다. 파일 형식은 다음 예시로 설명할 수 있습니다: { "default": { "container-title": { "Lloyd's Law Reports": "Lloyd's Rep", "Estates Gazette": "EG", "Scots Law Times": "SLT" } } }

각주

footnotes-hover	각주에 마우스를 올리면 각주 내용을 보여주는 팝업을 활성화합니다.
reference-location	각주의 위치를 지정합니다. reference-links가 설정된 경우 참고문헌 위치도 함께 제어합니다. block: 현재 최상위 블록 끝에 배치 section: 현재 섹션 끝에 배치 margin: 여백에 배치 document: 문서 끝에 배치

상호 참조

crossref	상호 참조 레이블과 접두사 설정입니다. 자세한 내용은 Cross-Reference Options을 참조하세요.
crossrefs-hover	상호 참조에 마우스를 올리면 참조 항목을 보여주는 팝업을 활성화합니다.

인용

citation

문서 자체에 대한 인용 정보를 문서 front matter의 CSL YAML로 지정합니다. 지원되는 옵션에 대한 자세한 내용은 Citation Metadata를 참조하세요.

언어

lang	IETF 언어 태그( BCP 47 표준 준수)를 사용해 문서의 기본 언어를 식별합니다. 예: en, en-GB. Language subtag lookup 도구로 태그를 조회하거나 검증할 수 있습니다. 이 설정은 대부분의 형식에 영향을 주며, LaTeX(PDF 출력의 경우 babel 및 polyglossia) 또는 ConTeXt를 사용할 때 줄바꿈(하이픈화)을 제어합니다.
language	사용자 정의 언어 번역이 포함된 YAML 파일입니다.
dir	문서의 기본 문자 방향입니다(rtl 또는 ltr). 양방향 문서의 경우 dir 속성이 있는 pandoc 기본 span과 div를 사용해 일부 출력 형식에서 기본 방향을 재정의할 수 있습니다. 최종 렌더러(예: HTML 생성 시 브라우저)가 [Unicode Bidirectional Algorithm]을 지원한다면 항상 필요하지는 않을 수 있습니다. LaTeX에서 양방향 문서를 사용할 때는 xelatex 엔진만 완전히 지원됩니다 (--pdf-engine=xelatex 사용).

포함

include-before-body	문서 본문의 시작 부분(예: HTML의 <body> 태그 뒤, 또는 LaTeX의 \begin{document} 명령 뒤)에 내용을 포함합니다. 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.
include-after-body	마크다운 콘텐츠 바로 뒤, 문서 본문의 끝부분에 내용을 포함합니다. HTML의 닫는 </body> 태그와 LaTeX의 \end{document} 명령 앞에 포함되지만, 이 옵션은 마크다운 콘텐츠의 끝을 의미합니다. 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.
include-in-header	헤더의 끝에 내용을 포함합니다. 예를 들어 HTML 문서에 특수한 CSS 또는 JavaScript를 포함하는 데 사용할 수 있습니다. 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.
resources	이 문서와 함께 배포할 파일의 경로(또는 glob)입니다.
metadata-files	제공된 YAML(또는 JSON) 파일에서 메타데이터를 읽습니다. 이 옵션은 모든 입력 형식에서 사용할 수 있지만, YAML 파일의 문자열 스칼라는 항상 마크다운으로 파싱됩니다. 일반적으로 입력은 YAML 메타데이터 블록에서와 동일하게 처리됩니다. 목록에서 나중에 지정된 파일의 값이 앞서 지정된 파일의 값보다 우선합니다. 문서 내부에서 지정하거나 -M을 사용해 지정한 메타데이터 값은 이 옵션으로 지정된 값을 덮어씁니다.

메타데이터

keywords	문서 메타데이터에 포함할 키워드 목록입니다.
pagetitle	문서의 제목 메타데이터를 설정합니다.
title-prefix	HTML 헤더에 표시되는 제목 앞에 문자열을 접두사로 지정합니다(본문 시작에 표시되는 제목에는 적용되지 않음).
description-meta	문서의 설명 메타데이터를 설정합니다.
author-meta	문서의 저자 메타데이터를 설정합니다.
date-meta	문서의 날짜 메타데이터를 설정합니다.

렌더링

from	읽을 형식입니다. 형식 이름 뒤에 +EXTENSION 또는 -EXTENSION을 붙여 확장을 개별적으로 활성화하거나 비활성화할 수 있습니다(예: markdown+emoji).
output-file	작성할 출력 파일
output-ext	생성된 출력 파일에 사용할 확장자
template	생성된 문서에 사용할 사용자 정의 템플릿 파일을 지정합니다.
template-partials	생성된 콘텐츠에 대해 템플릿에서 접근 가능한 partial로 지정된 파일을 포함합니다.
embed-resources	외부 의존성 없이 독립형 HTML 파일을 생성합니다. data: URI를 사용해 연결된 스크립트, 스타일시트, 이미지, 비디오의 내용을 포함합니다. 결과 파일은 외부 파일이나 네트워크 접근 없이 브라우저에서 올바르게 표시될 수 있는 ‘자체 포함(self-contained)’ 파일입니다. 이 옵션은 html4, html5, html+lhs, html5+lhs, s5, slidy, slideous, dzslides, revealjs를 포함한 HTML 출력 형식에서만 동작합니다. 절대 URL의 스크립트/이미지/스타일시트는 다운로드되며, 상대 URL은 (첫 소스 파일이 로컬이면) 작업 디렉터리 기준 또는 (첫 소스 파일이 원격이면) 기본 URL 기준으로 찾습니다. data-external="1" 속성이 있는 요소는 그대로 두며, 연결된 문서는 문서에 포함되지 않습니다. 제한 사항: JavaScript로 동적으로 로드되는 리소스는 포함할 수 없으므로 오프라인 ‘self-contained’ reveal.js 슬라이드쇼에서 일부 고급 기능(예: 줌, 발표자 노트)이 동작하지 않을 수 있습니다.
self-contained-math	self-contained 출력에 수학 라이브러리(예: MathJax)를 내장합니다. 수학 라이브러리는 크기가 크고 다운로드에 시간이 걸리는 경우가 많아 기본으로 내장되지 않습니다.
filters	입력이 파싱된 뒤 출력이 작성되기 전에 pandoc AST를 변환하는 필터로 사용할 실행 파일 또는 Lua 스크립트를 지정합니다.
shortcodes	숏코드 처리기를 구현하는 Lua 스크립트를 지정합니다.
keep-md	코드 실행으로 생성된 markdown 파일을 유지합니다.
keep-ipynb	코드 실행으로 생성된 노트북 파일을 유지합니다.
ipynb-filters	ipynb 파일을 markdown으로 렌더링하기 전에 전처리하는 필터입니다.
ipynb-shell-interactivity	어떤 노드를 대화형으로 실행할지(표현식 출력 표시) 지정합니다.
plotly-connected	true이면 “notebook_connected” plotly 렌더러를 사용하며, 이 렌더러는 CDN에서 종속성을 다운로드하므로 보려면 인터넷 연결이 필요합니다.
extract-media	원본 문서에 포함되거나 연결된 이미지 및 기타 미디어를 DIR 경로로 추출합니다. 필요한 경우 디렉터리를 생성하고, 문서의 이미지 참조가 추출된 파일을 가리키도록 조정합니다. 미디어는 다운로드되거나 파일 시스템에서 읽히거나, 필요에 따라 바이너리 컨테이너(예: docx)에서 추출됩니다. 원래의 파일 경로가 상대 경로이면서 …을 포함하지 않는 경우 해당 경로를 사용합니다. 그 외에는 콘텐츠의 SHA1 해시를 기반으로 파일 이름이 생성됩니다.
resource-path	이미지 및 기타 리소스를 검색할 경로 목록입니다.
default-image-extension	이미지 경로/URL에 확장자가 없을 때 사용할 기본 확장자를 지정합니다. 이렇게 하면 서로 다른 종류의 이미지가 필요한 형식에서 동일한 소스를 사용할 수 있습니다. 현재 이 옵션은 Markdown 및 LaTeX 리더에만 영향을 줍니다.
abbreviations	한 줄에 하나씩 약어를 적은 사용자 정의 약어 파일을 지정합니다. 이 목록은 Markdown 입력을 읽을 때 사용됩니다. 목록에서 발견된 문자열 뒤에는 줄바꿈 방지 공백이 추가되며, 마침표는 LaTeX와 같은 형식에서 문장 끝 공백을 생성하지 않습니다. 문자열에는 공백을 포함할 수 없습니다.
dpi	픽셀을 인치/센티미터로 변환하거나 그 반대로 변환할 때 사용할 기본 dpi(인치당 도트) 값을 지정합니다(엄밀히는 ppi: inch당 픽셀). 기본값은 96입니다. 이미지에 dpi 정보가 내부적으로 포함되어 있으면 이 옵션에 지정된 기본값 대신 인코딩된 값을 사용합니다.
html-table-processing	none이면 HTML 입력의 표를 처리하지 않습니다.

텍스트 출력

strip-comments	마크다운 소스의 HTML 주석을 제거하고, 이를 마크다운/텍스타일/HTML 출력으로 원시 HTML로 전달하지 않습니다. markdown_in_html_blocks 확장이 설정되지 않은 경우 원시 HTML 블록 내부의 HTML 주석에는 적용되지 않습니다.
ascii	출력에 ASCII 문자만 사용합니다. 현재 XML 및 HTML 형식(이 옵션 선택 시 UTF-8 대신 엔티티 사용), CommonMark, gfm, Markdown(엔티티 사용), roff ms(16진수 이스케이프 사용), 그리고 제한적으로 LaTeX(가능한 경우 표준 명령으로 악센트 문자 처리)에서 지원됩니다. roff man 출력은 기본적으로 ASCII를 사용합니다.

라이브러리

revealjs-url

reveal.js 파일이 들어 있는 디렉터리입니다.