시작하기
제목과 문단
제목에는 #을 사용합니다(1~6단계). 대체 문법으로 H1에는 ===, H2에는 ---를 씁니다. 문단 사이에는 빈 줄이 필요합니다. Markdown은 일반 텍스트만으로도 읽기 쉽도록 설계되었습니다.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Alternative Heading 1
=====================
Alternative Heading 2
---------------------
This is a paragraph. Just write
plain text. Leave a blank line
between paragraphs.줄바꿈
줄 끝에 공백 두 개 또는 백슬래시를 넣으면 강제 줄바꿈(<br>)이 됩니다. 없으면 한 줄 개행은 문단 안에서 합쳐지는 소프트 랩(soft wrap)으로 처리됩니다. 문단을 구분할 때는 항상 빈 줄을 남겨 두세요.
First line
Second line (two trailing spaces above)
Or use a backslash at end of line\
to force a line break.
Soft wrap without break:
just continue on the next line
and it joins into one.주석
Markdown에는 공식 주석 문법이 없지만, HTML 주석(<!-- -->)은 대부분의 렌더러에서 동작하며 출력에 나타나지 않습니다. [//]: # 트릭은 빈 링크 참조를 이용해 메모를 추가합니다. 주석은 원본 소스에는 그대로 보입니다.
<!-- HTML comments work in most Markdown -->
[//]: # (This is a comment)
[//]: # "Another comment style"
<!--
Multi-line comment
not rendered in output
-->공백과 들여쓰기
줄 앞 공백 4개는 텍스트를 코드 블록으로 만들어 버리므로 의도치 않은 들여쓰기에 주의하세요. 중첩 리스트에서는 들여쓰기가 중요합니다(단계당 2~4칸). 탭은 보통 공백 4개로 취급됩니다. 파서마다 렌더링 차이를 피하려면 공백을 일관되게 사용하세요.
Paragraph one.
This is an indented code block
because of 4 spaces.
> Quoted text needs > prefix.
Three spaces is just text
(less than 4).수평선
하이픈, 별표, 밑줄 3개 이상이면 수평선(<hr>)이 됩니다. 하이픈이 가장 흔합니다. 문자 사이 공백은 허용됩니다. 가독성을 위해 수평선 앞뒤에 빈 줄을 두세요. --- (수평선)을 # (제목)과 혼동하지 않도록 주의하세요.
---
***
___
* * *
Text above
---
Text below텍스트 서식
굵게(Bold)
별표 또는 밑줄 두 개로 굵게(<strong>) 표시합니다. snake_case처럼 단어 중간에서는 밑줄이 동작하지 않으므로 별표 쪽이 권장됩니다. 굵은 텍스트 안에 다른 강조를 중첩할 수 있습니다. 필요하면 HTML <strong> 태그도 대안으로 쓸 수 있습니다.
**bold text**
__also bold__
**bold with *italic* inside**
<strong>HTML bold also works</strong>
**bold**기울임(Italic)
별표 또는 밑줄 한 개로 기울임(<em>)을 만듭니다. 별표는 단어 중간에서도 동작하지만, 밑줄은 단어 내부 밑줄을 문자 그대로 취급합니다(no_italic_here). 대안으로 <em>을 쓸 수 있습니다. 기울임은 단순 스타일이 아니라 강조의 의미로 사용합니다.
*italic text*
_also italic_
*italic*
<em>HTML italic</em>
normal *italic* normal굵게 + 기울임 조합
별표/밑줄 세 개는 굵게와 기울임을 동시에 적용합니다. 서로 중첩하는 것도 가능합니다. 굵은 텍스트 안에 기울임을 넣거나 그 반대도 됩니다. 렌더링 결과는 순서와 무관하지만, 가독성을 위해 순서를 일관되게 유지하세요.
***bold and italic***
___also both___
**_bold and italic_**
*__bold and italic__*
combine **bold** and *italic*취소선
물결표 두 개(~~)로 취소선을 만들며, GitHub Flavored Markdown의 기능으로 이제 널리 지원됩니다. HTML <del>과 <s> 태그가 동일한 대안입니다. 표준(원조) Markdown에는 취소선이 포함되어 있지 않습니다.
~~strikethrough~~
~~crossed out text~~
<del>HTML delete</del>
<s>HTML strikethrough</s>
~~done~~ and ~~pending~~하이라이트
등호 두 개(==)로 하이라이트하는 것은 일부 파서가 지원하는 확장 기능입니다(GFM 핵심에는 없음). HTML <mark> 태그는 어디서든 동작합니다. 핵심 용어에 주의를 끌 때 아껴서 사용하세요. 남용하면 효과가 줄어듭니다.
==highlighted text==
<mark>HTML mark</mark>
This is ==important== text.
Compare **bold**, *italic*, ==mark==.아래첨자와 위첨자
물결표(아래첨자)와 캐럿(위첨자) 문법(~ ~, ^ ^)은 표준 Markdown이나 GFM에는 없는 확장 기능입니다. Pandoc, R Markdown 등 일부에서 지원합니다. 어디서든 쓰려면 HTML <sub>, <sup> 또는 유니코드 문자를 사용하세요.
H~2~O is water
E = mc^2^
x^2^ + y^2^ = r^2^
1st^st^ January
CO~2~ emissions리스트
순서 없는 리스트
순서 없는 리스트 항목에는 -, *, +를 사용합니다. 하나를 골라 일관되게 쓰세요(-가 가장 흔합니다). 중첩 항목은 2~4칸 들여쓰기합니다. 같은 리스트에서 마커를 섞으면 일부 파서에서 문제가 생길 수 있습니다. 한 줄에 항목 하나씩 작성합니다.
- item one
- item two
- item three
* asterisk works too
+ plus sign also works
- sub-item (indent 2 spaces)
- another sub-item순서 있는 리스트
순서 있는 리스트는 숫자 뒤에 마침표를 붙입니다. 실제 숫자가 연속일 필요는 없습니다. Markdown이 번호를 다시 매깁니다. 특정 번호부터 시작하려면 첫 항목에 그 번호를 쓰세요(10.이면 10부터 시작). 모든 항목을 1.로 쓰면 자동 번호가 매겨집니다.
1. first
2. second
3. third
1. auto-numbered
1. still increments
1. third item
10. starts at 10
11. next중첩 리스트
중첩 리스트 항목은 2~4칸 들여쓰기합니다(혼합 타입에서는 4칸이 가장 안전). 단계별로 순서 있는/없는 리스트를 섞을 수 있습니다. 3단계 이상 깊은 중첩은 가독성을 해치므로 구조를 다시 고려해 보세요. 들여쓰기는 일관되게 유지하세요.
1. top level
- nested unordered
- second nested
2. back to top
1. nested ordered
2. another
3. third top
- fruits
- apple
- granny smith
- banana태스크 리스트
태스크 리스트 문법(- [x], - [ ])은 GitHub Flavored Markdown 확장입니다. 체크박스는 GitHub/GitLab에서 인터랙티브하게 렌더링됩니다. 순서 있는/없는 리스트 모두에서 동작합니다. README, 이슈 트래커, 진행 상황 추적에 유용합니다.
- [x] completed task
- [ ] incomplete task
- [ ] another todo
1. [x] done
2. [ ] not done
- [x] Write the docs
- [ ] Review PR
- [ ] Deploy느슨한 리스트 vs 조밀한 리스트
리스트 항목 사이에 빈 줄이 있으면 '느슨한(loose)' 리스트가 되어 각 항목이 <p>로 감쌉니다. 빈 줄이 없으면 '조밀한(tight)' 리스트가 되어 <p>로 감싸지 않습니다. HTML 출력에서 간격 차이로 이어집니다. 문단 감싸기를 조절하려면 빈 줄을 의도적으로 추가하세요.
- tight item
- tight item
- tight item
- loose item
- loose item
- loose item여러 문단이 있는 리스트
리스트 항목에 여러 문단이나 블록 요소를 넣으려면 이어지는 내용을 4칸(또는 리스트 마커 내용에 맞춰) 들여쓰기합니다. 빈 줄로 하위 블록을 구분합니다. 복잡한 리스트 구조에는 필수적이지만 실수하기 쉬운 부분입니다.
- First item
Second paragraph of first item.
- Second item
> A blockquote inside a list item.
>
> Must be indented to align.
- Third item링크
인라인 링크
인라인 링크는 [text](url) 형태입니다. 따옴표로 감싼 제목은 마우스를 올릴 때 툴팁으로 표시됩니다. 상대 경로는 사이트 내부 내비게이션에 사용됩니다. 앵커 링크(#id)는 같은 id를 가진 요소로 이동합니다. URL에 공백이 있으면 안 되며, 공백은 %20으로 쓰세요.
[link text](https://example.com)
[link with title](https://example.com "Title here")
[relative link](/about)
[anchor](#section-id)참조 링크
참조 링크는 URL을 분리해 본문을 읽기 쉽게 유지합니다. 문서 어디에서나 참조를 정의할 수 있습니다([ref]: url). 참조 정의 자체는 렌더링되지 않습니다. 암시적 형태 [text][]는 텍스트 자체를 참조 id로 사용합니다. 참조는 재사용할 수 있습니다.
[link text][ref]
[ref]: https://example.com "Optional title"
[link text][1]
[1]: https://example.com
[link text]
[link text]: https://example.com자동 링크와 URL
GitHub Flavored Markdown에서는 URL만 써도 자동으로 링크가 됩니다. 표준 준수를 위해서는 URL을 꺾쇠 괄호로 감싸세요(<url>). 꺾쇠 괄호 형태는 모든 Markdown 계열에서 동작합니다. 일부 파서에서는 자동 링크를 비활성화할 수 있습니다.
https://example.com
<https://example.com>
<http://www.google.com>
Auto-linking bare URLs is supported
in GFM: visit https://example.com now.이메일 자동 링크
꺾쇠 괄호로 감싼 이메일 주소는 클릭 가능한 mailto: 링크가 됩니다. 원조 Markdown 스펙도 <text@domain> 형태를 지원했습니다. 일부 렌더러는 스팸 수 집을 줄이기 위해 이메일 주소를 난독화합니다. 공개 사이트에서는 스팸 방지를 위해 연락처 폼을 쓰는 편이 좋습니다.
<[email protected]>
Contact: <[email protected]>
<John Doe <[email protected]>>
Mailto links work in most renderers.링크 제목
링크 제목은 마우스를 올릴 때 툴팁으로 표시됩니다. 제목은 큰따옴표 또는 작은따옴표로 감쌉니다. 제목은 선택 사항이며 UX/SEO 힌트일 뿐입니다. 링크 텍스트를 대체하지 않으며, 스크린 리더는 무시할 수 있습니다. 제목은 간결하게 유지하세요.
[hover for title](https://example.com "Example Site")
[reference with title][a]
[a]: https://example.com "Example Site"
[title with single quotes](https://example.com 'Single')내부 링크와 앵커
대부분의 파서는 제목 텍스트(소문자화, 공백을 하이픈으로, 문장부호 제거)에서 앵커를 자동 생성합니다. 커스텀 ID가 필요하면 HTML <a id="..."> 또는 {#id} 속성 확장(Pandoc/marked)을 사용하세요. 앵커 링크는 목차에 필수적입니다.
## Section Heading
[jump to Section](#section-heading)
[back to top](#top)
<a id="custom-id"></a>
[custom anchor](#custom-id)
## Heading {#explicit-id}이미지
기본 이미지
이미지 문법은 링크와 같지만 앞에 !가 붙습니다. alt 텍스트는 접근성을 위해 필수입니다. 스크린 리더에 이미지를 설명하고, 이미지 로드에 실패할 때 표시됩니다. 경로는 상대, 절대, URL 모두 가능합니다. 제목(title)은 선택 사항입니다.


alt 텍스트가 있는 이미지
alt 텍스트는 의미 있고 간결해야 합니다. 'image'가 아니라 이미지의 목적을 설명하세요. 장식용 이미지는 빈 alt(alt='')로 스크린 리더가 건너뛰게 하는 것이 허용됩니다. 'image of', 'picture of' 같은 표현은 쓰지 마세요. 스크린 리더가 이미 알려 줍니다.


링크된 이미지
이미지 문법을 링크 문법 안에 중첩하면 [](url) 이미지를 링크로 감쌀 수 있습니다. 전체 크기 이미지로 연결되는 썸네일, CI 상태에 연결되는 배지, 홈으로 연결되는 로고에 흔히 씁니다. alt 텍스트는 이미지가 아니라 이동 목적지를 설명하세요.
[](https://example.com/full)
[](/)
[](https://ci.example.com)참조 이미지
참조 이미지는 링크와 같은 참조 방식을 ! 접두사와 함께 사용합니다. 이미지 참조를 한 번 정의하고 재사용하세요. 같은 이미지가 여러 번 나올 때나 이미지가 많은 문단의 가독성을 지킬 때 유용합니다.
![alt text][img-ref]
[img-ref]: https://example.com/image.png "Title"
![alt][logo]
[logo]: /assets/logo.png이미 지 크기와 Figure
표준 Markdown에는 이미지 크기 문법이 없습니다. HTML <img>의 width/height 속성을 사용하세요. 백분율 너비로 반응형 크기 조절이 가능합니다. <figure> + <figcaption> 조합은 (HTML5) 의미론적 캡션을 제공합니다. 일부 확장 Markdown(Pandoc)은 {width=300}을 지원합니다.
<img src="image.png" width="300" height="200" alt="sized image">
<img src="banner.png" width="100%" alt="responsive">
<figure>
<img src="diagram.png" alt="flowchart">
<figcaption>Figure 1: System flow</figcaption>
</figure>인라인 코드와 이스케이프
인라인 코드
인라인 코드는 백틱 한 개로 감쌉니다. 코드 안에 백틱을 보여 주려면 구분자를 백틱 두 개(또는 더 많이) 사용하세요. 인라인 코드는 고정폭으로 렌더링되고 Markdown으로 파싱되지 않습니다. 파일명, 명령어, 코드 식별자에 적합합니다.
Use the `printf()` function.
Inline code: `const x = 42;`
Code with backticks: ``use `code` here``
A `<div>` element.코드 스팬에서 백틱 이스케이프
코드 스팬 안에 백틱을 넣으려면 내부의 백틱보다 많은 백틱을 구분자로 사용하세요. 백틱 하나는 백틱 두 개로 감쌉니다. 코드 스팬 밖에서는 백슬래시로 백틱을 이스케이프합니다. 닫는 펜스는 여는 펜스와 길이가 같아야 합니다.
To show a backtick inside code,
use more backticks as delimiters:
`` ` `` one backtick
`` a`b `` backtick inside text
Use \ to escape outside code:
A literal backtick: \`코드 스팬과 공백
코드 스팬은 내부 공백을 그대로 보존합니다. 알아 두면 좋은 트릭: 내용 앞뒤를 공백 하나로 감싸면, 원래라면 잘려 나갈 앞뒤 공백을 표시할 수 있습니다. 양쪽 끝 공백 하나씩은 자동으로 제거됩니다.
` spaced ` (spaces preserved)
` code ` with one space pad
`function f() { return; }`
` multi word code `백슬래시 이스케이프
백슬래시는 특수 Markdown 문자를 이스케이프합니다: 백틱, 별표, 밑줄, 중괄호, 대괄호, 괄호, 해시, 플러스, 마이너스, 마침표, 느낌표, 그리고 백슬래시 자체. 이스케이프된 문자는 그대로 렌더링됩니다. 서식으로 해석될 수 있는 문자만 이스케이프하세요.
\*not italic\*
\_not italic\_
\#not a heading
\[not a link](url)
\`not code\`
\\backslash itself
\!not an image이스케이프가 필요한 문자
위 문자들이 Markdown에서 이스케이프 가능한 문자들입니다. 모든 곳에서 다 이스케이프할 필요는 없습니다. #은 줄 시작에서만, -는 리스트 문맥에서만 의미가 있습니다. 확실하지 않으면 이스케이프하세요. 중괄호와 괄호는 보통 링크, 템플릿 문자열 같은 특정 문맥에서만 이스케이프가 필요합니다.
\\ backslash
\` backtick
\* asterisk
\_ underscore
\{ \} curly braces
\[ \] square brackets
\( \) parentheses
\# hash
\+ plus
\- minus
\. dot
\! exclamation코드 블록
들여쓰기 코드 블록
4칸(또는 탭) 들여쓰기는 코드 블록을 만듭니다. 들여쓰기 코드 블록은 문법 강조와 언어 태그가 없습니다. 리스트 항목 안에서는 (연속 줄로 취급되어) 사용할 수 없습니다. 새 문서에는 펜스 코드 블록을 권장하며, 들여쓰기 블록은 레거시 방식입니다.
Normal paragraph.
// indented code (4 spaces)
function hello() {
console.log("hi");
}
Back to normal text.펜스 코드 블록
백틱 세 개 또는 물결표 세 개로 펜스 코드 블록을 만듭니다. 펜스는 들여쓰기 블록보다 권장됩니다. 모호하지 않고 언어 힌트도 지원하기 때문입니다. 코드 자체에 백틱 세 개가 들어 있을 때 물결표(~~~)가 유용합니다. 항상 같은 문자 수로 펜스를 닫으세요.
```
plain code block
multiple lines
```
~~~
also a fenced block
using tildes
~~~문법 강조
여는 펜스 바로 뒤에 언어 식별자(예: js, python)를 붙이면 문법 강조가 적용됩니다. 대부분의 렌더러는 highlight.js 또는 Prism을 사용합니다. 흔한 별칭: js, ts, py, rb, sh, json, html, css. 언어를 모르면 생략하고 일반 고정폭으로 두세요.
```javascript
const greet = (name) => {
console.log(`Hello, ${name}!`);
};
```
```python
def greet(name):
print(f"Hello, {name}!")
```
```bash
echo "Hello, $USER"
```중첩 코드 펜스
코드 블록 안에 백틱을 표시하려면 다른 펜스를 사용하세요(백틱 내용에는 물결표, 또는 내부보다 많은 백틱). 백틱 네 개 펜스는 백틱 세 개를 포함하는 내용을 감쌉니다. 닫는 펜스는 여는 펜스와 길이가 같아야 합니다.
Use four backticks to wrap triple backticks:
````
```js
console.log("inside");
```
````
Or use tildes to wrap backtick content:
~~~
```js
code with backticks
```
~~~리스트 안의 코드
리스트 항목 안의 펜스 코드 블록은 리스트 텍스트에 맞춰 들여쓰기해야 합니다(일반적으로 - 리스트는 3칸, 1. 리스트는 4칸). 리스트 안의 들여쓰기 코드 블록은 8칸이 필요합니다(리스트 4칸 + 코드 4칸). 들여쓰기 맞추기는 Markdown에서 가장 까다로운 작업 중 하나입니다.
1. Item with code:
```
code block indented to align
```
2. Next item with inline `code`.
- Or indent code 4 spaces beyond
the list marker (8 total).인용 블록
기본 인용 블록
> 문자로 인용 블록을 시작합니다. 모든 줄에 붙일 수도 있고 첫 줄에만 붙일 수도 있으며, 대부분의 파서는 연속된 줄을 합칩니다. 인용 블록은 들여쓰기된 스타일 인용(<blockquote>)으로 렌더링됩니다. 인용, 콜아웃, 발췌 강조에 활용하세요.
> This is a blockquote.
> It can span multiple lines.
> Or just prefix the first line
and continuation lines without >
will still be part of the quote.여러 줄 인용 블록
인용 블록 안에서 문단을 구분하려면 빈 > 줄을 사용하세요(그렇지 않으면 합쳐집니다). 빈 줄의 >는 인용이 이어짐을 유지합니다. 문단 사이에 빈 줄이 없으면 하나의 문단으로 흐릅니다. 항상 일반 줄로 인용을 종료하세요.
> First paragraph of quote.
>
> Second paragraph of quote.
>
> > Nested quote starts here.
> > Continues on next line.
End of quote.중첩 인용 블록
> 여러 개로 인용 블록을 중첩합니다(두 단계는 >>, 세 단계는 >>>). 가독성을 위해 공백을 추가하세요. 3단계 이상 깊은 중첩은 읽기도 스타일링도 어려우니 평탄화를 권장합니다. HTML 출력에서는 단계마다 들여쓰기가 추가됩니다.
> Outer quote
>
> > Inner nested quote
> > still nested
>
> Back to outer
> Outer
>> Deeper
>>> Deepest level다른 요소와 함께 쓰는 인용
인용 블록에는 대부분의 Markdown 요소를 넣을 수 있습니다: 제목, 리스트, 코드, 강조, 심지어 표까지. 인용 안에 유지하려면 각 줄에 > (와 공백)를 붙이세요. 콜아웃용으로 강력하지만, 복잡한 내용은 > 정렬에 주의가 필요합니다.
> ## Heading in quote
>
> - list item one
> - list item two
>
> *italic* and **bold** work too.
>
> ```
> code block inside quote
> ```출처가 있는 인용
Markdown에는 공식 인용 출처 문법이 없습니다. 흔한 관례: 새 줄에 em 대시로 작성자를 표시하거나, 의미론적 인용을 위해 <footer>와 <cite>가 포함된 HTML <blockquote>를 사용합니다. 학술적 인용에는 출처를 각주로 남기는 것도 고려해 보세요.
> Be the change you wish to see
> in the world.
> — Mahatma Gandhi
> "Simplicity is the soul of efficiency."
> — Austin Freeman
<blockquote>
<p>Quote text.</p>
<footer>— <cite>Author</cite></footer>
</blockquote>표
기본 표
표는 파이프(|)로 열을 구분하고 하이픈 행으로 헤더를 구분합니다. 헤더 행은 필수입니다. 줄 양 끝의 파이프는 선택 사항이지만 가독성에 도움이 됩니다. 열 너비는 중요하지 않으며 셀이 자동으로 맞춰집니다. 표는 GitHub Flavored Markdown 확장 기능입니다.
| Name | Age | City |
|-------|-----|----------|
| Alice | 30 | NYC |
| Bob | 25 | London |
| Carol | 35 | Paris |셀 정렬
구분 행의 콜론이 정렬을 결정합니다: :--- 왼쪽, :---: 가운데, ---: 오른쪽. 콜론이 없으면 기본은 왼쪽입니다. 정렬은 열 전체에 적용되고 HTML 출력에서 text-align CSS로 반영됩니다. 숫자 열(오른쪽 정렬)과 헤더(가운데 정렬)에 유용합니다.
| Left | Center | Right |
|:-------|:------:|-------:|
| left | center | right |
| L | C | R |
| Default | alignment |
|---------|-----------|
| no mark | left |서식이 있는 표
셀에는 인라인 Markdown을 넣을 수 있습니다: 굵게, 기울임, 코드, 링크, 취소선, 이모지. 블록 요소(제목, 리스트, 코드 블록)는 셀 안에서 동작하지 않으며 필요하면 HTML을 사용하세요. 가독성을 위해 셀 내용은 짧게 유지하고, 리터럴 파이프는 백슬래시로 이스케이프하세요.
| Feature | Status | Notes |
|------------|:------:|--------------------|
| **Bold** | done | *finished* |
| `code` | wip | [docs](docs.md) |
| ~~old~~ | removed| gone in v2 |
| [link][1] | done | see [ref][1] |복잡한 표
표는 많은 행과 열로 확장할 수 있지만 셀 단위는 단순하게 유지됩니다. 콤마가 있는 코드 스팬은 백틱으로 감싸세요. 리터럴 파이프는 백슬래시와 파이프로 이스케이프합니다. 복잡한 데이터(여러 줄 셀, 중첩 표)에는 HTML <table>이 필요합니다. 표가 너무 넓어지면 리스트 사용을 고려하세요.
| Name | Role | Skills | Available |
|-------|---------|---------------------|:---------:|
| Alice | Lead | `js`, `ts`, `go` | yes |
| Bob | Junior | `py`, `sql` | no |
| Carol | Senior | `rust`, `c++` | yes |
Escaped pipe: \| literal표 팁과 한계
Markdown 표에는 한계가 있습니다: 셀 병합 불가, 여러 줄 내용 불가, 블록 요소 불가, 중첩 표 불가. 이런 경우 원시 HTML을 사용하세요. 표는 작고 훑어 보기 쉽게 유지하고, 각주나 긴 텍스트가 필요하면 분할하세요. TablesGenerator.com 같은 도구로 빠르게 만들 수 있습니다.
| A | B |
|---|---|
| 1 | 2 |
Tip: Use \| to escape pipes.
Limitation: no multi-line cells,
no blockquotes, no lists in cells.
For complex tables, use HTML:
<table><tr><td>cell</td></tr></table>각주
기본 각주
각주는 본문의 [^id] 마커와 다른 곳의 [^id]: 정의로 구성됩니다. id는 숫자나 단어 모두 가능합니다. 렌더러는 클릭 가능한 위첨자 번호와 문서 하단의 각주 섹션을 만듭니다. GFM, Pandoc 및 대부분의 최신 파서가 지원합니다.
Here is a sentence with a footnote.[^1]
[^1]: This is the footnote text.
Another sentence.[^note]
[^note]: Footnotes can use named labels.여러 참조
하나의 각주는 여러 번 참조될 수 있으며, 모든 [^id]가 같은 정의로 연결됩니다. 각주 정의의 연속 줄은 들여쓰기합니다. 첫 참조에 위첨자 번호가 붙고, 이후 참조는 같은 각주로 연결됩니다.
Use the term[^term] twice[^term] in the text.
[^term]: A single definition referenced
multiple times.
First[^1] and second[^1] reference.
[^1]: One definition, two links back.인라인 각주
인라인 각주(^[text])는 각주 내용을 참조 위치에 바로 넣으며, Pandoc과 일부 확장에서 지원합니다(GFM 핵심에는 없음). 모든 내용을 한곳에 두지만 읽는 흐름을 방해할 수 있습니다. 짧은 메모에 사용하고, 긴 각주는 참조 방식이 좋습니다.
Here is an inline footnote^[The note text
right here in the body.] in a sentence.
Pandoc also supports: ^[inline notes].
And another[^1].
[^1]: Traditional reference style.각주 위치
각주 정의는 문서 어디에 두어도 되며, 렌더러가 모아서 마지막에 표시합니다. 연속 줄은 들여쓰기하세요(4칸). 각주는 인용 블록과 리스트 항목 안에서도 동작합니다. 소스에서의 위치는 출력 위치에 영향을 주지 않습니다.
Body text with a note.[^1]
More paragraphs here.
[^1]: Definitions can appear anywhere.
They float to the bottom in output.
> Even inside blockquotes.[^2]
[^2]: The renderer collects all notes
and renders them at the end.코드와 서식이 있는 각주
각주 정의에는 인라인 Markdown(굵게, 기울임, 코드)과 여러 문단 내용(연속 줄을 4칸 들여쓰기)을 사용할 수 있습니다. 각주 안의 들여쓰기 코드 블록은 8칸이 필요합니다. 각주는 간결하게 유지하세요. 긴 기술 내용은 본문이나 부록이 좋습니다.
See the API[^api] for details.
[^api]: Use `fetch('/api/data')` to call.
Supports **bold** and *italic*.
Multi-paragraph: indent each line.
Code blocks need indentation:
indented code inside footnote정의 리스트
기본 정의 리스트
정의 리스트는 한 줄에 용어를 쓰고 다음 줄에 콜론(:)과 정의를 씁니다. PHP Markdown Extra, Pandoc 및 일부 확장에서 지원합니다(GFM 핵심에는 없음). <dl><dt><dd>로 렌더링됩니다. 용어집과 용어-정의 쌍에 유용합니다.
Term
: Definition of the term.
Markdown
: A lightweight markup language.
HTML
: HyperText Markup Language.