AsciiDoc 옵션

AsciiDoc은 문서, 기사, 책, 전자책, 슬라이드쇼, 웹 페이지, man 페이지, 블로그를 작성하기 위한 텍스트 문서 형식입니다. 자세한 내용은 https://asciidoc.org/를 참고하세요.

format: asciidoc
format: asciidoctor

Asciidoc vs Asciidoctor 형식

Pandoc은 asciidoc과 asciidoctor 형식을 모두 지원합니다. asciidoc 형식은 이제는 일반적으로 사용되지 않는 오래된 문법을 생성하는 반면, asciidoctor 형식은 공식 AsciiDoc 사양의 최신 마크다운 문법을 생성합니다.

Quarto에서는 asciidoc과 asciidoctor가 모두 asciidoctor 형식의 별칭입니다.

제목과 저자

`title`	문서 제목
`date`	문서 날짜
`date-format`	문서 날짜 형식
`author`	저자
`abstract`	문서 요약
`order`	사이트 자동 사이드바 메뉴 내 문서 순서

형식 옵션

`brand`	브랜딩 정보 또는 brand 파일 경로. false면 비활성화. 객체로 밝은/어두운 브랜드 정의 가능.
`quarto-required`	지원하는 Quarto 버전 범위(예: `>= 1.1.0`, `1.*`).

번호 매기기

`number-sections`	섹션 제목 번호 매기기(기본 비활성; `.unnumbered` 클래스는 항상 무시).
`shift-heading-level-by`	헤딩 레벨을 정수만큼 이동. 레벨1보다 낮을 수없고, -N일 때 문서 시작 레벨-N은 메타 제목을 대체.

레이아웃

grid

Quarto HTML 페이지 레이아웃에 쓰이는 그리드 시스템 속성.

코드

code-annotations

코드 주석 표시 스타일(False면 숨김).

실행

execute 키 내부에 실행 옵션 지정 예시. 예:

execute:
  echo: false
  warning: false

`eval`	코드 셀을 실행할지를 결정합니다(`false`이면 코드만 출력). `true` (기본): 코드 실행 `false`: 코드 실행 안 함 `[...]`: 표현식을 선택 포함/제외하는 양수/음수 숫자 리스트(명시적 포함/제외는 knitr 엔진에서만 지원)
`echo`	렌더링 결과에 소스 코드를 포함합니다. `true` (대부분 형식 기본): 소스 포함 `false` (`beamer`/`revealjs`/`pptx` 등 프레젠테이션 기본): 소스 미포함 `fenced`: 소스와 함께 셀 구분자도 포함 `[...]`: 행 번호 리스트로 선택 포함/제외(명시적 포함/제외는 knitr 엔진에서만 지원)
`output`	코드 실행 결과 포함 방식: `true`: 결과 포함 `false`: 결과 제외 `asis`: 마크업 없이 원시 Markdown으로 처리
`warning`	렌더링 결과에 경고 포함
`error`	오류를 출력에 포함(코드 오류 발생 시 문서 처리는 계속됨)
`include`	코드/결과를 출력에 포함하지 않기 위한 종합 설정
`cache`	계산 결과 캐시 사용(기본 R은 knitr, Jupyter는 Jupyter Cache). 청크 소스 코드 또는 정의된 캐시 속성 변경 시 무효화. `true`: 캐시 사용 `false`: 캐시 사용 안 함 `refresh`: 무효화 여부와 관계없이 캐시 강제 갱신
`freeze`	렌더링 시 이전 계산 결과 재사용 제어: `true`: 글로벌 렌더에서 기존 결과 절대 재계산 안 함 `false` (기본): 기존 결과 재계산 `auto`: 소스 파일 변경 시에만 결과 재계산

그림

`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-width * fig-asp`로 높이를 계산. `fig-asp`는 knitr 엔진에서만 사용 가능.

표

df-print

Knitr 문서에서 테이블 출력 방식(기본 S3/default, kable, tibble, paged). 기본은 kable.

참고문헌

`bibliography`	문서 참고문헌(BibTeX 또는 CSL, 단일 또는 복수 파일).
`csl`	참고문헌 서식을 위한 CSL 파일.
`citeproc`	내장 인용 처리 활성화(인용이 있는 문서 및 참고자료 필요, CSL 선택 가능).
`citation-abbreviations`	`form="short"`일 때 사용할 저널 약어 JSON 파일.

상호 참조

crossref

상호 참조 레이블/접두사 설정(Cross-Reference Options).

인용

citation

문서 자체 인용 정보(CSL YAML, Citation Metadata 참고).

언어

`lang`	BCP 47 언어 태그로 문서 주 언어 지정(예: `en`, `en-GB`). 하이픈화 및 LaTeX via babel/polyglossia 영향.
`language`	맞춤 언어 번역을 담은 YAML 파일.
`dir`	문서 기본 스크립트 방향(`rtl` 또는 `ltr`). Bidi 문서는 pandoc span/div dir로 재정의 가능. LaTeX은 xelatex 권장.

포함

`include-before-body`	문서 본문 시작 부분에 포함(HTML 직후, LaTeX egin{document}). 파일 또는 텍스트 객체 지정 가능.
`include-after-body`	마크다운 내용 뒤, HTML 또는 LaTeX \end{document} 직전 포함. 파일/텍스트 지정 가능.
`include-in-header`	헤더 끝에 내용 포함(css/js 삽입 등). 파일 또는 텍스트 지정 가능.
`metadata-files`	제공한 YAML/JSON 파일에서 메타데이터 읽기(후순위 파일 우선, 문서 메타 및 -M이 덮어씀).

메타데이터

keywords

문서 메타데이터에 포함할 키워드 목록.

렌더링

`from`	입력 형식 지정. `format+EXTENSION`/`-EXTENSION`으로 확장자 제어 가능.
`output-file`	생성할 출력 파일 경로.
`output-ext`	생성 출력 파일 확장자.
`template`	지정 파일을 생성 문서의 사용자 템플릿으로 사용.
`template-partials`	생성 콘텐츠 템플릿에서 접근 가능한 파셜 파일 포함.
`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로 추출(필요 시 생성)하고, 참조를 추출한 파일로 조정. 상대경로는 그대로, 아닌 경우 SHA1 해시 기반 이름. docx 등의 바이너리 컨테이너도 지원.
`resource-path`	이미지/자원 검색 경로 목록.
`default-image-extension`	확장자가 없는 이미지 경로/URL에 사용할 기본 확장자 지정(형식별로 다른 이미지를 지원하며 현재 Markdown/LaTeX 리더에만 적용).
`abbreviations`	한 줄당 약어를 적은 약어 파일 지정(Markdown 입력에서 약어 뒤에 nbsp, LaTeX 등에서 문장 종료 공백 없음).
`dpi`	픽셀↔︎인치/센티미터 변환용 기본 DPI 값(기본 96). 이미지 내부 DPI가 있으면 해당 값 사용.
`html-table-processing`	`none`이면 HTML 입력 테이블 처리하지 않음.

텍스트 출력

`wrap`	텍스트(소스 코드)의 줄 바꿈 방식 결정(`auto`, `none`, `preserve`).
`columns`	줄 길이 문자 수 지정(텍스트 줄 바꿈 및 일반 텍스트 테이블 열 너비 계산, Typst는 본문 열 수).
`tab-stop`	탭당 공백 수 지정(기본 4). 일반 텍스트 탭은 공백으로, 코드 탭은 `preserve-tabs: false`로 비활성화 가능.
`preserve-tabs`	코드 내 탭을 공백으로 변환하지 않고 유지(기본 pandoc은 공백 변환, 일반 텍스트는 항상 공백).
`eol`	줄 끝 유형 수동 지정(`crlf`, `lf`, `native`).

`toc`	자동 생성된 목차 포함(HTML/latex 등에서는 생성 지시). PDF via ms인 경우 문서 시작 부분에 나타나며 끝으로 이동하려면 `pdf-engine-opt: --no-toc-relocation` 사용.
`toc-depth`	목차에 포함할 섹션 레벨 수 지정(기본값 3).