Markdown 문법

By | 9월 13, 2025
Markdown 문법

Markdown 마크업 언어 완벽 가이드

Markdown은 텍스트를 기반으로 하는 가벼운 마크업 언어로, 복잡한 서식 없이도 내용을 쉽게 구성하고 꾸밀 수 있습니다. 간결하고 배우기 쉬워 README 파일, 블로그, 문서 작성 등 다양한 분야에서 널리 사용됩니다.


제목(Headings)

제목은 문서의 계층 구조를 명확하게 보여줍니다. # 기호를 사용하며, #의 개수에 따라 제목의 크기가 결정됩니다. #을 하나만 사용하면 가장 큰 제목인 h1이 되고, 여섯 개를 사용하면 가장 작은 h6이 됩니다.

# 가장 큰 제목 (h1)
## 두 번째 큰 제목 (h2)
### 세 번째 큰 제목 (h3)
#### 네 번째 큰 제목 (h4)
##### 다섯 번째 큰 제목 (h5)
###### 가장 작은 제목 (h6)

또 다른 방법으로 h1과 h2를 표현할 수도 있습니다. 제목 아래에 = (h1) 또는 - (h2) 기호를 연속해서 입력하는 방식입니다.

가장 큰 제목
========

두 번째 큰 제목
--------

문단과 줄 바꿈

문단을 구분할 때는 한 줄을 비워야 합니다. 엔터 키만으로는 줄 바꿈이 되지 않으며, 같은 문단으로 인식됩니다.

줄을 강제로 바꾸려면 줄 끝에 두 칸 이상의 공백을 넣거나, HTML <br> 태그를 사용하면 됩니다.

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

이것은 두 번째 문단입니다.
새로운 줄이지만 같은 문단에 속합니다.

여기서 줄을 바꿉니다.  
이것은 다음 줄입니다.

텍스트 서식 지정

Markdown을 사용하면 텍스트에 다양한 강조 효과를 줄 수 있습니다.

  • 기울임꼴(Italic): 텍스트 양쪽에 * 또는 _를 한 개씩 붙여줍니다.
  • 굵게(Bold): 텍스트 양쪽에 ** 또는 __를 두 개씩 붙여줍니다.
  • 굵고 기울임꼴(Bold & Italic): 텍스트 양쪽에 *** 또는 ___를 세 개씩 붙여줍니다.
  • 취소선(Strikethrough): 텍스트 양쪽에 ~~를 두 개씩 붙여서 취소선을 만듭니다.
*이것은 기울임꼴 텍스트입니다.*
_이것도 기울임꼴 텍스트입니다._

**이것은 굵은 텍스트입니다.**
__이것도 굵은 텍스트입니다.__

***이것은 굵고 기울임꼴 텍스트입니다.***
___이것도 굵고 기울임꼴 텍스트입니다.___

~~이 텍스트는 취소됩니다.~~

목록(Lists)

순서가 없는 목록과 순서가 있는 목록을 만들 수 있습니다.

순서 없는 목록(Unordered Lists): *, -, 또는 + 기호를 사용합니다.

* 사과
- 바나나
  - 바나나의 하위 항목
+ 포도

순서 있는 목록(Ordered Lists): 숫자와 마침표를 사용합니다. 들여쓰기를 통해 하위 목록을 만들 수 있습니다.

1. 첫 번째 항목
2. 두 번째 항목
   1. 두 번째 항목의 하위 항목
   2. 다음 하위 항목

코드와 인용구

코드 블록(Code Blocks):

  • 인라인 코드: 문장 중간에 짧은 코드를 넣을 때는 텍스트를 백틱(`)으로 감쌉니다.
  • 코드 블록: 여러 줄의 코드를 표시할 때는 세 개 이상의 백틱(“`)으로 코드를 감싸줍니다. 첫 번째 백틱 뒤에 프로그래밍 언어 이름을 명시하면 문법 강조(Syntax Highlighting) 기능이 적용됩니다.
`print("Hello")` 함수는 "Hello"를 출력합니다.
```python
def greet(name):
    return f"Hello, {name}!"

print(greet("Markdown"))
```

```
function hello() {
  console.log("Hello, Markdown!");
}
hello();
```

인용구 (Blockquotes)

인용구는 > 기호를 사용하여 만듭니다. 중첩하여 사용할 수도 있습니다.

> 이것은 인용구입니다.
>
> > 이것은 중첩된 인용구입니다.
>
> 인용구의 마지막 줄입니다.

링크 (Links)

링크는 [링크 텍스트](링크 주소) 또는 [링크 텍스트](링크 주소 "링크 제목") 형식으로 만듭니다.
[Google로 이동](https://www.google.com)

[네이버로 이동](https://www.naver.com "네이버 메인 페이지")
참조 링크도 사용할 수 있습니다.
자세한 내용은 [여기][참조_링크]를 참조하세요.

[참조_링크]: [https://www.example.com](https://www.example.com) "예제 웹사이트"

이미지 (Images)

이미지는 ![대체 텍스트](이미지 주소) 또는 ![대체 텍스트](이미지 주소 "이미지 제목") 형식으로 삽입합니다.

![Markdown 로고](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg "마크다운 로고")

수평선 (Horizontal Rules)

수평선은 ---***, 또는 ___ (세 개 이상) 기호를 사용하여 만듭니다.

---

***

___

테이블 (Tables)

테이블은 파이프(|)와 하이픈(-)을 사용하여 만듭니다. 정렬은 하이픈 라인에 콜론(:)을 추가하여 지정합니다.

  • : 없음: 왼쪽 정렬 (기본)
  • :--: 왼쪽 정렬
  • --:: 오른쪽 정렬
  • :-:: 가운데 정렬
| 헤더 1 | 헤더 2 | 헤더 3 |
| :----- | :----: | -----: |
| 내용 A | 내용 B | 내용 C |
| 내용 D | 내용 E | 내용 F |

체크박스/할 일 목록 (Task Lists)

순서 없는 목록과 유사하지만 [ ] 또는 [x]를 사용하여 체크박스를 만듭니다.

- [x] 완료된 작업
- [ ] 미완료된 작업
    - [ ] 하위 작업 1
    - [x] 하위 작업 2

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다