본문 바로가기
카테고리 없음

📑 마크다운(Markdown) 사용법 총정리

by 에스비비 2025. 3. 5.

마크다운(Markdown)은 간단한 문법을 사용하여 서식 있는 문서를 쉽게 작성할 수 있는 경량 마크업 언어입니다. 🖋️

HTML처럼 복잡한 태그 없이도 문서의 구조와 의미를 쉽게 표현할 수 있어, 개발자뿐만 아니라 일반 사용자들에게도 폭넓게 활용되고 있습니다.

이번 글에서는 마크다운의 기본 문법과 활용법을 상세히 정리해 보겠습니다. 📝

마크다운(Markdown) 사용법 섬네일

 

✅ 아래 목차를 통해 원하는 내용을 쉽게 찾을 수 있습니다.


📌 목차


📌 마크다운이란?

마크다운(Markdown) 은 2004년 존 그루버(John Gruber)애런 스워츠(Aaron Swartz) 개발한 문법입니다.

 

✔️ 마크다운 공식 가이드 보러 가기

 

🔹 주요 특징

  • 간결한 문법 – 특수 기호(#, *, > 등)를 사용하여 간단하게 서식을 지정할 수 있습니다.
  • 높은 가독성 – HTML보다 직관적인 문법으로, 원본 텍스트 그대로 읽어도 의미를 쉽게 파악할 수 있습니다.
  • 다양한 활용 – 블로그, README 파일, 기술 문서, 노트 정리 등에 널리 사용됩니다.
  • 플랫폼 지원 – GitHub, Notion, Obsidian, VS Code, Jupyter Notebook 등 다양한 도구에서 지원됩니다.


🔹 마크다운 기본 문법

🏷️ 1. 제목(Header)

마크다운에서는 # 기호를 사용하여 제목을 작성합니다.

# 제목 1 (H1)
## 제목 2 (H2)
### 제목 3 (H3)
#### 제목 4 (H4)
##### 제목 5 (H5)
###### 제목 6 (H6)

📌 출력 결과

제목 1

제목 2

제목 3

제목 4

제목 5
제목 6


✍️ 2. 강조(Emphasis)

기울임체, 굵은 글씨, 취소선을 적용할 수 있습니다.

*기울임* 또는 _기울임_
**굵게** 또는 __굵게__
~~취소선~~

📌 출력 결과

기울임 또는 기울임

굵게 또는 굵게

취소선


📋 3. 목록(List)

✅ 순서 없는 목록

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

- 리스트 항목 1
- 리스트 항목 2
  - 하위 항목 1
  - 하위 항목 2
* 다른 기호도 사용 가능

📌 출력 결과

  • 리스트 항목 1
  • 리스트 항목 2
    • 하위 항목 1
    • 하위 항목 2
  • 다른 기호도 사용 가능

🔢 순서 있는 목록

숫자를 붙이면 자동으로 번호가 매겨집니다.

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

📌 출력 결과

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


웹사이트 링크를 삽입할 때 사용합니다.

[네이버](https://www.naver.com)

📌 출력 결과

네이버


🖼️ 5. 이미지(Images)

이미지를 삽입할 때는 ![]() 형식을 사용합니다.

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

💬 6. 인용문(Blockquote)

인용문을 작성할 때는 > 기호를 사용합니다.

> 이것은 인용문입니다.
>> 중첩된 인용문입니다.

📌 출력 결과

이것은 인용문입니다.

중첩된 인용문입니다.


📜 7. 코드 블록(Code Blocks)

⌨️ 인라인 코드

백틱(`) 기호로 감싸면 인라인 코드가 됩니다.

`인라인 코드 예제`

📌 출력 결과

인라인 코드 예제

🖥️ 여러 줄 코드 블록

백틱 3개(```)를 사용하면 여러 줄의 코드 블록을 만들 수 있습니다.

```javascript
function helloWorld() {
    console.log("Hello, World!");
}
```

📌 출력 결과

function helloWorld() {
    console.log("Hello, World!");
}

📏 8. 수평선(Horizontal Rule)

문서에서 구분선을 만들고 싶다면 ---, ***, ___를 사용합니다.

---
***
___

📊 9. 표(Table)

데이터를 정리할 때는 표를 활용할 수 있습니다.

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

📌 출력 결과

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

✅ 10. 체크박스(Task List)

할 일 목록을 만들 때 사용합니다.

- [x] 완료된 작업
- [ ] 해야 할 일 1
- [ ] 해야 할 일 2

📌 출력 결과

  • 완료된 작업
  • 해야 할 일 1
  • 해야 할 일 2

❓ 자주 묻는 질문 (FAQ)

1️⃣ 마크다운을 사용할 수 있는 곳은 어디인가요?

  • GitHub, GitLab, Bitbucket 등의 개발 협업 도구
  • Notion, Obsidian, Typora 등의 노트 작성 도구
  • 블로그 플랫폼(티스토리, 워드프레스)
  • Jupyter Notebook, VS Code

2️⃣ 마크다운과 HTML의 차이점은?

  • 마크다운 – 직관적인 문법, 가독성 우수, 간단한 문서 작성에 적합
  • HTML – 구조적 마크업 가능, 웹페이지 제작에 필수

3️⃣ 마크다운 파일 확장자는 무엇인가요?

  • 일반적으로 .md 또는 .markdown 확장자를 사용합니다.

📝 요약 정보: 마크다운(Markdown) 사용법

✔ 마크다운(Markdown) 개요

  • 간단한 문법으로 서식 있는 문서를 작성할 수 있는 경량 마크업 언어
  • 가독성 우수, 배우기 쉬움, 다양한 플랫폼에서 활용 가능

✔ 마크다운 기본 문법

  • 1️⃣ 제목(Header) – # 제목 1 형식 사용
  • 2️⃣ 강조(Emphasis) – *기울임*, **굵게**, ~~취소선~~
  • 3️⃣ 목록(List) – -, * (순서 없는 목록), 1., 2. (순서 있는 목록)
  • 4️⃣ 링크(Links) – [네이버](https://www.naver.com)
  • 5️⃣ 이미지(Images) ![대체 텍스트](이미지 URL)
  • 6️⃣ 인용문(Blockquote) – > 인용문
  • 7️⃣ 코드 블록(Code) – 백틱(`) 1개 (인라인 코드), 백틱 3개(```) (여러 줄 코드)
  • 8️⃣ 수평선(Horizontal Rule) – ---, ***, ___
  • 9️⃣ 표(Table) – | 헤더 | 내용 | 형식 |
  • 🔟 체크박스(Task List) – - [x] 완료, - [ ] 할 일

✔ 마크다운 활용 분야

  • GitHub, Notion, Obsidian, 블로그, 문서 작성 등 다양한 플랫폼에서 사용

🎯 결론: 마크다운으로 쉽고 빠르게 문서 작성!

마크다운은 배우기 쉽고 활용도가 높은 최고의 문서 작성 도구입니다.

  • ✔ 가볍고 직관적인 문법
  • ✔ 높은 가독성과 편리한 편집
  • ✔ 개발부터 문서 작성까지 폭넓은 활용

💡 마크다운을 익혀 더 효율적으로 문서를 작성해보세요! 🚀

📌 더 자세한 정보는 공식 문서에서 확인하세요. 🎯


함께 보면 유용한 글

🎬 넷플릭스 언어 설정 변경 방법: 자막 & 음성 설정 가이드

 

📢 네이버 카페 방문수 확인하는 법 & 늘리는 방법

 

📱 갤럭시 전화 차단, 수신 차단 해제 설정 방법