GitHub에서 글 작성 시 사용하는 마크다운 정리

GitHub에서는 문서 작성, README 작성, 이슈 정리 등을 위해 마크다운(Markdown) 문법을 사용합니다.
마크다운은 간단한 기호만으로 제목, 목록, 코드, 표, 링크 등 다양한 문서 구조를 만들 수 있는 문법입니다.

특히 GitHub에서는 GitHub Flavored Markdown (GFM) 이라는 확장된 마크다운을 사용합니다.

 

이번 글에서는 GitHub에서 자주 사용하는 마크다운 문법을 정리해 보겠습니다.

---

1. 제목 (Heading)

# 기호를 사용하면 제목을 만들 수 있습니다.
# 개수에 따라 제목 크기가 달라집니다.

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

 

예시

제목1

제목2

제목3

---

2. 줄바꿈

마크다운에서는 엔터만으로는 줄바꿈이 되지 않습니다.

방법 1
문장 끝에 공백 두 칸

첫 번째 줄
두 번째 줄

 

방법 2
<br> 태그 사용

첫 번째 줄<br>
두 번째 줄

 

---

3. 강조 (Bold / Italic)

굵게

**굵은 글씨**
__굵은 글씨__

 

결과
굵은 글씨

---

기울임

*기울임*
_기울임_

 

결과
기울임

---

굵게 + 기울임

***강조***

 

결과
강조

---

4. 목록 (List)

순서 없는 목록

- 항목1
- 항목2
- 항목3

 

또는

* 항목1
* 항목2

 

결과

• 항목1
• 항목2
• 항목3

---

순서 있는 목록

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

 

결과

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

---

5. 체크박스 (Task List)

GitHub에서 자주 사용하는 체크리스트입니다.

- [ ] 해야 할 일
- [x] 완료된 일

 

---

6. 링크 (Link)

[구글](https://google.com)

 

결과

구글

---

7. 이미지 삽입


 

예시


 

---

8. 인용문 (Blockquote)

> 기호를 사용합니다.

> 인용문입니다.
>> 중첩 인용문

 

결과

인용문입니다.

중첩 인용문

---

9. 코드 (Code)

한 줄 코드

`console.log("hello");`

 

결과

console.log("hello");

---

여러 줄 코드

 

 

코드내용

 

 

예시

 

```javascript
function hello(){
console.log("hello");
}
```

 

결과

 

function hello(){
console.log("hello");
}

---

10. 구분선 (Horizontal Line)

---

 

또는

***

 

결과

---

11. 표 (Table)

| 이름 | 나이 | 직업 |
|-----|-----|-----|
| 홍길동 | 30 | 개발자 |
| 김철수 | 28 | 디자이너 |

 

결과

이름	나이	직업
홍길동	30	개발자
김철수	28	디자이너

---

12. 취소선

~~취소된 내용~~

 

결과

취소된 내용

---