표 출력 사용자 정의

Quarto에는 마크다운 표 출력을 쉽게 작성하고 사용자 정의할 수 있도록 하는 여러 기능이 포함되어 있습니다. 예를 들면 다음과 같습니다.

Specifying column alignment and widths.
Providing captions, subcaptions, and cross-references.
Generating tables dynamically from executable code cells.

이 글에서는 이러한 기능을 개괄적으로 소개합니다. 표 작성의 모든 기능은 표 문서를 참고하세요.

마크다운 표

가장 흔히 사용하는 마크다운 표는 파이프 표입니다. 파이프 표는 열별 정렬과 캡션을 지정할 수 있습니다. 예:

| Default | Left | Right | Center |
|---------|:-----|------:|:------:|
| 12      | 12   |    12 |   12   |
| 123     | 123  |   123 |  123   |
| 1       | 1    |     1 |   1    |

: Demonstration of pipe table sytnax

다음은 이 표를 HTML로 렌더링한 결과입니다.

Demonstration of pipe table syntax
Default	Left	Right	Center
12	12	12	12
123	123	123	123
1	1	1	1

캡션 위치

기본적으로 표 캡션은 표 위에 표시됩니다. tbl-cap-location 옵션으로 이 동작을 바꿀 수 있습니다. 예:

---
tbl-cap-location: top
---

명시적 열 너비

표준 파이프 표 문법으로 열 너비를 표현하는 것 외에도 tbl-colwidths 속성이나 문서 수준 옵션으로 열 너비를 명시할 수 있습니다. 개별 마크다운 표에는 캡션 뒤에 속성을 추가하세요. 예:

| fruit  | price  |
|--------|--------:
| apple  | 2.05   |
| pear   | 1.37   |
| orange | 3.09   |

: Fruit prices {tbl-colwidths="[75,25]"}

이 옵션은 PDF와 HTML 포맷에서 함께 사용할 수 있도록 최상위에 지정합니다. 단일 포맷만 대상이라면 다른 format 전용 옵션 옆에 둘 수 있습니다.

캡션 위치에 사용할 수 있는 값은 다음과 같습니다.

값	설명
`top`	캡션을 표 위에 표시합니다.
`bottom`	캡션을 표 아래에 표시합니다.
`margin`	캡션을 여백에 표시합니다.

계산 결과

앞서 설명한 옵션은 실행 가능한 코드 셀에서 생성된 표에도 동일하게 적용됩니다. 예를 들어 아래에서는 tbl-cap, tbl-colwidths, tbl-caption-location 옵션을 코드 셀에 적용합니다.

```{r}
#| tbl-cap: "Cars"
#| tbl-colwidths: [60,40]
#| tbl-cap-location: margin

library(knitr)
kable(head(cars))
```

위에서는 마크다운 파이프 표 작성과 관련된 Quarto의 기능 일부를 살펴봤습니다. 이외에도 grid 문법으로 표를 작성할 수 있습니다. 자세한 내용은 문서를 참고하세요.