📘 [Markdown] 마크다운 문법 정리 - 1

2025년 02월 26일 in Study / ETC on #Markdown

[Markdown] 마크다운 문법 정리

---

• 📝 마크다운이란?
• 1. 제목 (Headings)
• 제목 1
  • 제목 2
    • 제목 3
  • 2. 텍스트 스타일
  • 3. 목록 (Lists)
    • ● 순서 없는 목록
    • ● 순서 있는 목록
  • 4. 링크 (Links)
  • 5. 이미지 (Images)
  • 6. 코드 블록 (Code Block)
    • ● 인라인 코드
    • ● 여러 줄 코드 블록
  • 7. 인용문 (Blockquote)
  • 8. 수평선 (Horizontal Rule)
  • 9. 표 (Tables)
  • 10. 체크리스트 (Task List)
  • 11. 이스케이프 문자 (Escape Characters)
  • 12. HTML 병행 사용
  • 📑 Reference

📝 마크다운이란?

---

Markdown은 텍스트 기반의 마크업언어로 2004년 존그루버에 의해 만들어졌으며 쉽게 쓰고 읽을 수 있으며 HTML로 변환이 가능하다. 특수기호와 문자를 이용한 매우 간단한 구조의 문법을 사용하여 웹에서도 보다 빠르게 컨텐츠를 작성하고 보다 직관적으로 인식할 수 있다. 마크다운이 최근 각광받기 시작한 이유는 깃헙(https://github.com) 덕분이다. 깃헙의 저장소Repository에 관한 정보를 기록하는 README.md는 깃헙을 사용하는 사람이라면 누구나 가장 먼저 접하게 되는 마크다운 문서였다. 마크다운을 통해서 설치방법, 소스코드 설명, 이슈 등을 간단하게 기록하고 가독성을 높일 수 있다는 강점이 부각되면서 점점 여러 곳으로 퍼져가게 된다.

---

1. 제목 (Headings)

---

문법	결과
# 제목 1	<h1>
## 제목 2	<h2>
### 제목 3	<h3>
…	…
###### 제목 6	<h6>

예시:

제목 1

제목 2

제목 3

---

2. 텍스트 스타일

---

예시:

굵게 → 굵게

기울임 → 기울임

취소선 → 취소선

인라인 코드 → 인라인 코드

---

3. 목록 (Lists)

---

● 순서 없는 목록

예시:

• 아이템 1

• 아이템 2

• 아이템 3

● 순서 있는 목록

예시:

1. 첫 번째

2. 두 번째

3. 세 번째

---

4. 링크 (Links)

---

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

---

5. 이미지 (Images)

---

이미지 크기 조절은 <img width="" height=""></img> 또는 {: width="" height=""}

`~~~
![대체 텍스트](image path)
![그림1](/assets/img/etc/testimage.jpg)
![그림2](/assets/img/etc/testimage.jpg|400x400){: width="400" height="400"}
~~~`

---

6. 코드 블록 (Code Block)

---

● 인라인 코드

`console.log("Hello")`

● 여러 줄 코드 블록

예시:

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

결과:

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

---

7. 인용문 (Blockquote)

---

예시: > 이것은 인용문입니다. >> 중첩 인용문입니다.

결과:

이것은 인용문입니다.

중첩 인용문입니다.

---

8. 수평선 (Horizontal Rule)

---

예시: --- *** ___

결과: —

---

9. 표 (Tables)

---

| 이름 | 나이 | 직업 |
|--------|------|--------|
| 홍길동 | 30 | 개발자 |
| 김영희 | 25 | 디자이너 |

이름	나이	직업
홍길동	30	개발자
김영희	25	디자이너

---

10. 체크리스트 (Task List)

---

- [x] 완료한 항목 - [ ] 할 일`

결과:

• 완료한 항목
• 할 일

---

11. 이스케이프 문자 (Escape Characters)

---

\*별표\* → *별표*

\#제목 → #제목

*별표* → 별표

#제목 → #제목

---

12. HTML 병행 사용

---

<b>굵게</b> → 굵게

<i>기울임</i> → 기울임

<br>

<hr>

<kbd>hello</kbd> → hello

<code>hello</code> → hello

<mark>hello</mark> → hello

<under>hello</under> → hello

※ GitHub 등 일부 플랫폼에서 HTML 태그 사용 가능

---

📑 Reference

---

• ihoneymon 님의 마크다운

---