Markdown vs Quarto 완전 비교 가이드
기본 개념
- *Markdown*: 가벼운 마크업 언어, 텍스트 포맷팅 중심
- *Quarto*: Pandoc 기반의 과학적 출판 시스템, 코드 + 문서 통합
—
1. 제목과 목차 기능
일반 Markdown
# 제목 1
## 제목 2
### 제목 3
#### 제목 4
##### 제목 5
###### 제목 6
<!— 목차는 수동으로 만들어야 함 —>
## 목차
- [섹션 1](#섹션-1)
- [섹션 2](#섹션-2)
Quarto
—
title: “문서 제목”
toc: true # 자동 목차 생성
toc-depth: 3 # 목차 깊이 설정
toc-title: “차례” # 목차 제목 커스터마이징
—
# 섹션 1 {#sec-intro}
## 하위 섹션 1.1
### 세부 섹션 1.1.1
# 섹션 2 {#sec-methods}
결과: Quarto는 자동으로 클릭 가능한 목차를 생성하고, 각 섹션에 고유 ID 부여
—
2. 주석 기능
일반 Markdown
<!— 이것은 HTML 주석입니다 —>
<!— 렌더링된 결과에는 보이지 않습니다 —>
[^1]: 이것은 각주입니다
텍스트에 각주 참조[^1]를 넣을 수 있습니다.
Quarto
<!— HTML 주석 (동일) —>
<!— Quarto 전용 주석 —>
{{< comment >}}
이것은 Quarto 전용 주석 블록입니다.
여러 줄로 작성 가능합니다.
{{< /comment >}}
<!— 마진 주석 —>
이것은 본문 텍스트입니다. [마진에 나타날 주석입니다.]{.aside}
<!— 각주 (향상된 기능) —>
텍스트에 각주^[인라인 각주도 가능합니다]를 넣거나
참조형 각주[^note1]도 사용할 수 있습니다.
[^note1]: 이것은 참조형 각주입니다. 더 복잡한 내용을 넣을 수 있어요.
—
3. 기본 텍스트 포맷팅
공통 문법 (동일)
*기울임* 또는 _기울임_
**굵게** 또는 __굵게__
***굵은 기울임***
~~취소선~~
`인라인 코드`
> 인용문
> 여러 줄 인용문
- 순서 없는 목록
- 항목 2
- 중첩 항목
1. 순서 있는 목록
2. 항목 2
1. 중첩 순서 목록
Quarto 추가 기능
[밑줄 텍스트]{.underline}
[작은 대문자]{.smallcaps}
[하이라이트]{.mark}
H~2~O (아래 첨자)
E = mc^2^ (위 첨자)
—
4. 링크와 이미지
일반 Markdown
[링크 텍스트](https://example.com)
[링크 텍스트](https://example.com “툴팁 텍스트”)
Quarto (크로스 레퍼런스 추가)
<!— 기본 링크 (동일) —>
[링크 텍스트](https://example.com)
<!— 그림 참조 —>
{#fig-example width=50%}
@fig-example 에서 보는 바와 같이...
<!— 표 참조 —>
| 항목 | 값 |
|——|——|
| A | 1 |
| B | 2 |
: 표 캡션 {#tbl-data}
@tbl-data 는 데이터를 보여줍니다.
—
5. 코드 블록
일반 Markdown
markdownpython
def hello():
print(“Hello World”)
Quarto (실행 가능한 코드)
```{python}
#| echo: true # 코드 표시
#| eval: true # 코드 실행
#| warning: false # 경고 숨김
#| fig-cap: “그래프 제목”
import matplotlib.pyplot as plt
plt.plot([1,2,3,4])
plt.show()
```
```{r}
#| label: fig-cars
#| fig-cap: “자동차 데이터 산점도”
plot(cars)
```
—
6. Callout 블록 (Quarto 전용)
::: {.callout-note}
## 참고사항
이것은 파란색 노트 박스입니다.
:::
::: {.callout-warning}
## 경고
이것은 노란색 경고 박스입니다.
:::
::: {.callout-important}
## 중요
이것은 빨간색 중요 박스입니다.
:::
::: {.callout-tip}
## 팁
이것은 초록색 팁 박스입니다.
:::
::: {.callout-caution collapse=“true”}
## 주의 (접기 가능)
클릭하면 펼쳐지는 접을 수 있는 박스입니다.
:::
—
7. 레이아웃 기능 (Quarto 전용)
<!— 탭 패널 —>
::: {.panel-tabset}
## 탭 1
첫 번째 탭 내용
## 탭 2
두 번째 탭 내용
## 탭 3
세 번째 탭 내용
:::
<!— 다중 컬럼 —>
::: {.grid}
::: {.g-col-6}
왼쪽 절반 (50%)
:::
::: {.g-col-6}
오른쪽 절반 (50%)
:::
:::
<!— 마진 콘텐츠 —>
::: {.column-margin}
이 내용은 페이지 마진에 표시됩니다.
:::
—
8. 수식
일반 Markdown (제한적)
인라인 수식: $E = mc^2$
블록 수식:
$$
\sum_{i=1}^n x_i = \bar{x} \cdot n
$$
Quarto (레이블링과 참조)
Einstein의 공식:
$$
E = mc^2
$$ {#eq-einstein}
@eq-einstein 에서 보듯이...
정리:
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$ {#eq-gaussian}
—
9. YAML 프론트매터
일반 Markdown (선택적)
—
title: “문서 제목”
author: “작성자”
date: “2024-01-01”
—
Quarto (강력한 설정)
—
title: “고급 문서”
author:
- name: “작성자 1”
affiliation: “소속기관”
- name: “작성자 2”
date: today
format:
html:
toc: true
theme: cosmo
code-fold: true
pdf:
documentclass: article
geometry: margin=1in
bibliography: references.bib
—
—
10. 조건부 콘텐츠 (Quarto 전용)
::: {.content-visible when-format=“html”}
이 내용은 HTML 출력에서만 보입니다.
웹용 인터랙티브 요소들을 여기에...
:::
::: {.content-visible when-format=“pdf”}
이 내용은 PDF 출력에서만 보입니다.
인쇄용 레이아웃이나 정적 이미지 사용.
:::
::: {.content-hidden when-format=“revealjs”}
이 내용은 프레젠테이션에서는 숨겨집니다.
:::
—
요약: 언제 무엇을 사용할까?
일반 Markdown 사용 시기:
- GitHub README, 블로그 포스트
- 단순한 문서화
- 빠른 메모나 노트
- 호환성이 중요한 경우
Quarto 사용 시기:
- 학술 논문, 리포트
- 데이터 분석 결과 공유
- 인터랙티브 문서 필요
- 다양한 출력 형식 필요 (HTML, PDF, Word, PowerPoint)
- 코드와 문서 통합 필요
핵심: Quarto는 Markdown의 모든 기능을 포함하면서, 과학적/기술적 문서 작성을 위한 강력한 추가 기능들을 제공합니다!
Hyungrok 