Markdown 구문 가이드: 기초부터 고급까지

Markdown은 개발자가 실제로 즐겨 사용하는 작성 포맷입니다. 포맷팅 메뉴를 클릭하거나 WYSIWYG 편집기와 씨름할 필요 없이 — 몇 가지 기호가 포함된 일반 텍스트가 깨끗한 HTML로 변환됩니다. README 파일, 문서, 블로그 글, 채팅 메시지, 심지어 이 글도 Markdown으로 작성되었습니다.

Markdown 미리보기에서 실시간으로 Markdown을 미리보세요 — 한쪽에서 작성하고 다른 쪽에서 포맷된 결과를 확인합니다.

기본 구문

제목

# 제목 1
## 제목 2
### 제목 3
#### 제목 4

제목은 계층적으로 사용하세요. 레벨을 건너뛰지 마세요 (H1에서 H3으로 점프) — 가독성과 접근성 모두 저하됩니다.

강조

*이탤릭* 또는 _이탤릭_
**볼드** 또는 __볼드__
***볼드 이탤릭***
~~취소선~~

링크와 이미지

[링크 텍스트](https://example.com)
[타이틀이 있는 링크](https://example.com "타이틀")
![대체 텍스트](image.png)

- 순서 없는 항목
- 다른 항목
  - 중첩 항목

1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목

인용구

> 이것은 인용구입니다.
> 여러 줄에 걸쳐 작성할 수 있습니다.

코드

인라인 코드

인라인 코드에는 백틱을 사용합니다: `const x = 42`

코드 블록

선택적 언어 식별자가 포함된 트리플 백틱:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

지원되는 언어에는 javascript, python, json, yaml, html, css, bash 등이 있습니다.

표

| 헤더 1 | 헤더 2 | 헤더 3 |
|----------|----------|----------|
| 셀 1   | 셀 2   | 셀 3   |
| 셀 4   | 셀 5   | 셀 6   |

정렬:

| 왼쪽 | 가운데 | 오른쪽 |
|:-----|:------:|------:|
| L    |   C    |     R |

고급 구문

작업 목록

- [x] 완료된 작업
- [ ] 대기 중인 작업
- [ ] 다른 작업

각주

여기에 문장이 있습니다[^1].

[^1]: 이것은 각주 내용입니다.

정의 목록

용어
: 용어의 정의

수평선

---
***
___

GitHub Flavored Markdown (GFM)

GitHub은 표준 Markdown에 유용한 기능을 확장합니다:

자동 링크 URL — 단순 URL이 클릭 가능하게 됨
작업 목록 — 이슈와 PR에서 체크박스
표 — 위에 표시된 파이프 구문
취소선 — ~~삭제된 텍스트~~
구문 강조 — 언어별 코드 색상 지정
이모지 — :smile:이 웃는 얼굴로 변환

작성 팁

문단을 짧게 유지 — 최대 3-5문장
제목을 사용하여 스캔 가능한 구조 만들기
단계나 기능에는 긴 문단보다 목록 선호
기술적 개념을 논의할 때 코드 예제 추가
정기적으로 미리보기 — Markdown 미리보기에서 입력하면서 결과 확인

자주 묻는 질문

Markdown과 HTML의 차이점은 무엇인가요?

Markdown은 HTML로 변환되는 간소화된 작성 포맷입니다. 훨씬 적은 구문으로 가장 일반적인 포맷팅 요구를 충족합니다. Markdown이 지원하지 않는 기능이 필요할 때 Markdown 안에 원시 HTML을 포함할 수 있습니다.

어떤 Markdown 방언을 사용해야 하나요?

GitHub Flavored Markdown (GFM)이 가장 널리 지원됩니다. 표준 Markdown에 표, 작업 목록, 취소선을 추가합니다. CommonMark는 표준화된 사양입니다.

Markdown을 문서화에 사용할 수 있나요?

물론입니다. Markdown은 README 파일, 위키, 문서 사이트의 표준입니다. MkDocs, Docusaurus, GitBook 등의 도구가 모두 Markdown을 사용합니다.