Markdown문법 정리하기

Quarto

Markdown문법을 정리합니다.

Author

gabriel yang

Published

September 12, 2023

Markdown

마크다운은 텍스트를 이용해 문서를 작성하는 도구입니다. 일반 텍스트를 이용해서 Table, 링크 등 다양한 문서형태를 작성할 수 있습니다. Quart는 Pandoc을 기반으로 하고 있으며 Markdown으로 문서를 작성합니다. 자주 사용하는 Markdown 문법을 정리합니다.

Text Formatting

텍스트의 형태를 변경하는 다양한 문법을 확인합니다.

Markdown Syntax	Output
`italics, bold, *bold italics*`	italics, bold, *bold italics*
`superscript^2^ / subscript~2~`	superscript² / subscript₂
`~~strikethrough~~`	~~strikethrough~~

Link 및 이미지 연결

링크에 보일 글자와 함께 링크정보를 표시합니다.

# 링크 연결
<https://quarto.org>
[Quarto](https://quarto/org)

https://quarto.org Quarto

# 이미지표시
![Caption](cover.png)

Table

Markdown으로 table을 구성하는 방법을 정리합니다.

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

Right	Left	Default	Center
12	12	12	12
123	123	123	123
1	1	1	1

소스 코드

Quarto에서 소스코드를 추가하는 방법을 정리힙니다.

코드의 처음과 마지막에 ```를 이용해서 코드 영역을 표시합니다.

```
code
```

코드에 맞는 언어를 표시하여 언어별 코드 하이라이트를 적용할 수 있습니다.

```python
1 + 1
```

Pandoc에서 지원하는 하이라이트 기능을 사용할 수 있습니다. 140 언어 지원 정보를 확인하세요. 만약 지원하는 언어가 없다면 default를 사용할 수 있습니다.

```default
code
```

수식

$ 구분기호를 이용하여 인라인 수식을 추가하고 $$ 구분기호를 이용하여 수식만 표현할 수 있습니다.

Markdown Syntax Output

Markdown Syntax	Output
`인라인 수식: $E = mc^{2}$`	인라인 수식: \(E=mc^{2}\)
`수식 단독표현: $$E = mc^{2}$$`	수식 단독표현: \[E = mc^{2}\]

인라인 수식: $E = mc^{2}$

인라인 수식: $E=mc^{2}$

수식 단독표현:

$$E = mc^{2}$$

수식 단독표현:

\[E = mc^{2}\]

다이어그램

Quarto는 Mermaid와 Graphviz 다이어그램을 지원합니다. 플로우차트, 시퀀스 다이어그램, 스테이트 다이어그램, 간트차트등을 그릴 수 있습니다. Mermaid를 이용해서 플로우 차트를 생성합니다.

```{mermaid}
flowchart LR
  A[입력] --> B(전처리)
  B --> C{판단로직}
  C --> D[성공]
  C --> E[실패]
```

flowchart LR
  A[입력] --> B(전처리)
  B --> C{판단로직}
  C --> D[성공]
  C --> E[실패]

동영상 연결

문서 내부에 동영상을 연결할 수 있습니다. {{< video >}} 를 이용해서 유튜브 동영상은 연결할 수 있습니다.

{{< video https://www.youtube.com/embed/wo9vZccmqwc >}}

HTML 코드 (Divs, Spans)

HTML의 div 블럭을 만들 수 있습니다. class 정보를 border로 정의합니다.

::: {#special .border}
class를 "border"로 정의한 div block으로 변환됩니다.
:::

Quarto를 렌터링하고 나면 아래의 HTML 코드로 변경됩니다.

<div id="special" class="border">
  <p>class를 "border"로 정의한 div block으로 변환됩니다.</p>
</div>

대괄호 []로 표현된 문자열은 span으로 변환됩니다.

[테스트 *SPAN* 코드입니다.]{.class key="val"}

<span class="class" data-key="val">
  테스트 <em>SPAN</em> 코드입니다.
</span>

참고

https://quarto.org/docs/authoring/markdown-basics.html