표

콰르토 마크다운으로 표를 만드는 방법은 여러가지가 있으나 여기에서는 가장 많이 사용되는 파이프(pipe) 방식을 설명한다. 파이프 방식은 표의 열을 구분하는데 파이프 기호(|)를 사용해서 붙여진 이름이다.

표 제작 기본

파이프 방식으로 표를 만드는 기본적인 방법은 다음과 같다.

  1. 세로선
    • 파이프 기호(|)로 표의 세로선을 표시한다.
    • 좌우의 가장자리 세로선은 생략해도 된다.
    • 파이프 기호에 인접한 공백과 각 줄 가장자리의 공백은 무시된다.
    • 파이프 기호의 세로 정렬 위치는 상관없다.
  2. 구분행
    • 제목행과 본문행의 구분행에는 빼기 기호(-)를 사용한다
    • 빼기 기호는 하나 이상 있어야 한다.
  3. 좌우정렬
    • 구분행의 빼기 기호의 좌우에 콜론 기호(:)를 붙여 해당 열의 좌우 정렬을 지정할 수 있다.
    • 콜론 기호가 왼쪽에 붙으면 왼쪽 정렬, 오른쪽이면 오른쪽 정렬, 양쪽에 붙으면 중앙정렬이다.
    • 콜론 기호가 없으면 디폴트로 왼쪽 정렬이다.
  4. 제목
    • 마지막에 콜론 기호로 시작하는 행을 붙여서 제목을 표시할 수 있다.
    • 제목행은 표와 여러 줄 떨어져도 상관없다.
sample/c02/table/02_table_basic1.qmd 코드
|  왼쪽 정렬  | 오른쪽 정렬 |  중앙정렬  |  디폴트   |
|:------------|------------:|:----------:|-----------|
|          12 |          12 |         12 |        12 |
|         123 |         123 |        123 |       123 |
|           1 |           1 |          1 |         1 |
: 파이프 방식 표

sample/c02/table/02_table_basic1.qmd 결과

파이프 방식 표
왼쪽 정렬 오른쪽 정렬 중앙정렬 디폴트
12 12 12 12
123 123 123 123
1 1 1 1

세로줄의 위치나 가장자리 공백 등은 영향을 미치지 않는다. 아래의 예제는 위의 예제와 동일하지만 일부러 보기 흉하게 정렬을 하지 않았다. 표 결과가 동일함을 알 수 있다.

sample/c02/table/02_table_basic2.qmd 코드
  |왼쪽 정렬 |오른쪽 정렬| 중앙정렬 | 디폴트 |
|   :------------  | ------------:|:----------:    |-----------|
  | 12|12 |12| 12 |
 | 123 | 123| 123 |123|
       | 1 |1|1 | 1 |


: 파이프 방식 표

sample/c02/table/02_table_basic2.qmd 결과

파이프 방식 표
왼쪽 정렬 오른쪽 정렬 중앙정렬 디폴트
12 12 12 12
123 123 123 123
1 1 1 1

제목행

제목행에 내용을 넣지 않으면 제목행 자체가 없어진다.

sample/c02/table/02_table_basic3.qmd 코드
| | | | |
|-|-|-|-|
|1|1|1|1|
|2|2|2|2|
|3|3|3|3|

: 제목행이 없는 경우

sample/c02/table/02_table_basic3.qmd 결과

제목행이 없는 경우
1 1 1 1
2 2 2 2
3 3 3 3

스타일

제목 문자열 뒤에 중괄호를 사용하여 다음과 같은 부트스트랩(Bootstrap) 스타일을 지정할 수 있다. 다음은 전체 부트스트랩 스타일의 일부이다.

  • striped
  • hover
  • active
  • bordered
  • borderless
  • sm
sample/c02/table/02_table_style.qmd 코드
|c1|c2|c3|c4|c5|
|--|--|--|--|--|
|00|01|02|03|04|
|05|06|07|08|09|
|10|11|12|13|14|
|15|16|17|18|19|

: 부트스트랩 스타일 적용 {.sm .bordered .striped}

sample/c02/table/02_table_style.qmd 결과

부트스트랩 스타일 적용
c1 c2 c3 c4 c5
00 01 02 03 04
05 06 07 08 09
10 11 12 13 14
15 16 17 18 19

폭 조정

제목 문자열 뒤의 중괄호에 tbl-colwidths 속성값으로 각 열의 폭을 조정할 수 있다. 숫자는 각 열의 상대적인 크기를 나타낸다. 이 숫자는 목표치일 뿐이며 표 내부의 문자열 크기, 마진, 패딩 등 여러가지 요소로 인해 정확한 비율을 가지지 못할 수 있다.

sample/c02/table/02_table_width.qmd 코드
| A | B | C |
|:-:|:-:|:-:|
| 1 | 2 | 3 |
| 4 | 5 | 6 |
| 7 | 8 | 9 |

: 열 폭 조정 {tbl-colwidths="[1,2,4]" .sm .bordered}

sample/c02/table/02_table_width.qmd 결과

열 폭 조정 {tbl-colwidths='[1,2,4]'}
A B C
1 2 3
4 5 6
7 8 9

아이디와 라벨

표 제목에 {#tbl-아이디문자열}과 같은 형식으로 표에 아이디를 붙이고 다른 위치에서 [@tbl-아이디문자열] 형식으로 해당 표를 참조할 수 있다.

sample/c02/table/02_table_ref.qmd 코드
| A | B | C |
|:-:|:-:|:-:|
| 1 | 2 | 3 |
| 4 | 5 | 6 |
| 7 | 8 | 9 |

: 아이디가 있는 표 {#tbl-1}

자세한 내용은 [@tbl-1]을 참조한다.

sample/c02/table/02_table_ref.qmd 결과

표 1: 아이디가 있는 표
A B C
1 2 3
4 5 6
7 8 9

자세한 내용은 [@tbl-1]을 참조한다.