프로그래밍/Etc.

초보자도 쉽게 배우는 마크다운(Markdown) 기본 문법 가이드

Joo-Topia 2025. 3. 18.

마크다운(Markdown) 기본 문법 가이드

1. 마크다운이란?

마크다운(Markdown)은 가볍고 사용하기 쉬운 마크업 언어로, 텍스트를 간단한 기호를 사용하여 서식 있는 문서로 변환할 수 있습니다. 일반적으로 README 파일, 블로그 게시글, 문서 작성 등에 많이 사용됩니다.

2. 기본 문법

2.1 제목(Header)

제목을 만들려면 # 기호를 사용합니다. #의 개수에 따라 제목의 크기가 결정됩니다.

# 제목 1
## 제목 2
### 제목 3
#### 제목 4
##### 제목 5
###### 제목 6

2.2 문단(Paragraph)

문장을 작성하면 자동으로 하나의 문단이 생성됩니다. 문단을 구분하려면 한 줄을 띄우면 됩니다.

이것은 첫 번째 문단입니다.

이것은 두 번째 문단입니다.

이것은 첫 번째 문단입니다.

이것은 두 번째 문단입니다.

2.3 강조(Emphasis)

텍스트를 굵게 또는 기울임으로 만들 수 있습니다.

**굵은 글씨**
*기울임 글씨*
***굵은 기울임 글씨***

굵은 글씨
기울임 글씨
굵은 기울임 글씨

2.4 목록(List)

- 순서 없는 목록

-, *, + 기호를 사용하여 순서 없는 목록을 만들 수 있습니다.

- 항목 1
- 항목 2
  - 하위 항목 1
  - 하위 항목 2
  • 항목 1
  • 항목 2
    • 하위 항목 1
    • 하위 항목 2

- 순서 있는 목록

숫자 뒤에 점(.)을 붙여 순서 있는 목록을 만들 수 있습니다.

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

2.5 코드(Code)

- 인라인 코드

백틱(`)을 사용하여 인라인 코드를 작성할 수 있습니다.

이것은 `코드`입니다.

이것은 코드입니다.

- 블록 코드

코드 블록을 만들려면 백틱 세 개( ```) 또는 들여쓰기(공백 4개 또는 탭 1개)를 사용합니다.

```
print("Hello, Markdown!")
```
print("Hello, Markdown!")

2.6 링크(Links)

링크를 추가하는 방법은 다음과 같습니다.

[Google](https://www.google.com)

Google

2.7 이미지(Images)

이미지를 삽입하려면 ![]() 형식을 사용합니다.

![대체 텍스트](https://example.com/image.jpg)

대체 텍스트

2.8 인용문(Blockquote)

> 기호를 사용하여 인용문을 작성할 수 있습니다.

> 이것은 인용문입니다.

이것은 인용문입니다.

2.9 수평선(Horizontal Rule)

---, ***, ___을 사용하여 수평선을 삽입할 수 있습니다.

---

2.10 표(Table)

파이프(|)와 하이픈(-)을 사용하여 표를 만들 수 있습니다.

| 제목 1 | 제목 2 | 제목 3 |
|--------|--------|--------|
| 내용 1 | 내용 2 | 내용 3 |
| 내용 4 | 내용 5 | 내용 6 |
제목 1 제목 2 제목 3
내용 1 내용 2 내용 3
내용 4 내용 5 내용 6

- 정렬 추가

콜론(:)을 사용하여 표의 정렬을 지정할 수 있습니다.

| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
|:---------|:----------:|-----------:|
| 내용 1   | 내용 2     | 내용 3     |
| 내용 4   | 내용 5     | 내용 6     |
왼쪽 정렬 가운데 정렬 오른쪽 정렬
내용 1 내용 2 내용 3
내용 4 내용 5 내용 6

3. 마무리

마크다운은 간결하고 직관적인 문법을 제공하여 누구나 쉽게 문서를 작성할 수 있습니다. 위에서 소개한 기본 문법을 익히고 활용하면 효율적으로 문서를 정리할 수 있습니다!

더 자세한 내용을 알고 싶다면 Markdown Guide를 참고하세요.

댓글