[Markdown] 문법 총정리 | GitHub에서 가장 많이 사용하는 마크다운 문법

Markdown은 복잡한 편집 도구 없이도 제목, 목록, 링크, 코드 등을 간단하게 작성할 수 있는 문서 작성 문법이다.

GitHub의 README 파일에서 많이 사용하지만, 티스토리와 같은 블로그에서도 글을 구조적으로 작성할 때 활용할 수 있다.

---

1. 제목 작성하기

제목 앞에 #을 붙이면 제목을 만들 수 있다.

#의 개수가 많아질수록 하위 제목이 된다.

 

# 제목 1
## 제목 2
### 제목 3
#### 제목 4

 

보통 블로그에서는 다음과 같이 사용하면 된다.

 

## 대주제

### 소주제

 

티스토리 글 제목은 별도의 제목 입력란에 작성하므로, 본문에서는 ##부터 사용하는 것도 괜찮다.

---

2. 글자 강조하기

별표와 물결표를 사용하면 글자를 강조할 수 있다.

 

**굵은 글씨**

*기울임 글씨*

~~취소선~~

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

 

결과는 다음과 같다.

굵은 글씨

기울임 글씨

취소선

굵은 기울임 글씨

글에서 중요한 개념이나 명령어를 강조할 때는 굵은 글씨를 사용하는 것이 가장 무난하다.

---

3. 인용문 작성하기

문장 앞에 >를 입력하면 인용문을 만들 수 있다.

 

> Markdown은 간단한 기호를 이용해 문서의 구조를 표현하는 문법이다.

 

결과는 다음과 같다.

Markdown은 간단한 기호를 이용해 문서의 구조를 표현하는 문법이다.

인용문은 다른 사람의 글을 인용하거나, 참고 사항과 주의 사항을 별도로 표시할 때 사용할 수 있다.

 

> 참고  
> 티스토리와 GitHub는 지원하는 Markdown 문법이 일부 다를 수 있다.

 

---

4. 문장 안에 코드 넣기

문장 안에서 명령어나 코드 이름을 표시할 때는 백틱 한 개를 사용한다.

 

변경된 파일을 확인하려면 `git status`를 사용한다.

 

결과는 다음과 같다.

변경된 파일을 확인하려면 git status를 사용한다.

파일명, 명령어, 함수명처럼 일반 문장과 구분해야 하는 내용을 표시할 때 유용하다.

---

5. 여러 줄의 코드 작성하기

여러 줄의 코드는 백틱 세 개로 감싼다.

 

```bash
git status
git add .
git commit -m "first commit"
```

 

코드 블록을 시작하는 백틱 뒤에 언어를 입력하면 문법에 맞게 코드가 강조될 수 있다.

자주 사용하는 언어 표시는 다음과 같다.

bash
python
javascript
html
css
sql
markdown

 

Python 코드는 다음과 같이 작성할 수 있다.

 

```python
name = "Markdown"
print(name)
```

 

---

6. 링크 삽입하기

대괄호 안에 링크에 표시할 문구를 입력하고, 소괄호 안에 주소를 입력한다.

 

[GitHub 바로가기](https://github.com)

 

결과는 다음과 같다.

GitHub 바로가기

주소를 그대로 길게 적는 것보다 링크의 내용을 설명하는 문구를 사용하는 것이 읽기 좋다.

 

[GitHub Markdown 공식 문서 확인하기](문서 주소)

 

---

7. 이미지 삽입하기

Markdown으로 이미지를 넣을 때는 링크 문법 앞에 느낌표를 붙인다.

 

![이미지 설명](이미지 주소)

 

예시는 다음과 같다.

 

![GitHub 로고](https://example.com/github-logo.png)

 

대괄호 안에는 이미지가 표시되지 않을 때 대신 나타날 설명을 작성한다.

다만 티스토리에서는 외부 이미지 주소를 직접 연결하기보다, 에디터의 이미지 업로드 기능을 사용하는 것이 관리하기 편하다.

---

8. 순서가 없는 목록 만들기

각 항목 앞에 -, *, + 중 하나를 입력하면 순서가 없는 목록을 만들 수 있다.

 

- Git 설치
- GitHub 가입
- Repository 생성

 

결과는 다음과 같다.

• Git 설치
• GitHub 가입
• Repository 생성

목록 기호는 한 글 안에서 통일하는 것이 좋다. 일반적으로 -를 가장 많이 사용한다.

---

9. 순서가 있는 목록 만들기

항목 앞에 숫자와 마침표를 입력하면 순서가 있는 목록을 만들 수 있다.

 

1. Git 설치하기
2. Repository 생성하기
3. 파일 커밋하기
4. GitHub에 Push하기

 

결과는 다음과 같다.

1. Git 설치하기
2. Repository 생성하기
3. 파일 커밋하기
4. GitHub에 Push하기

설치 방법이나 작업 순서를 설명할 때 사용하기 좋다.

---

10. 중첩 목록 만들기

목록 안에 하위 목록을 넣으려면 앞에 공백을 추가한다.

 

- Git
  - git add
  - git commit
  - git push
- GitHub
  - Repository
  - Issues
  - Pull Request

 

결과는 다음과 같다.

• Git
  • git add
  • git commit
  • git push
• GitHub
  • Repository
  • Issues
  • Pull Request

하위 항목은 보통 공백 두 칸 이상을 사용해 들여쓴다.

---

11. 티스토리에서 체크리스트 작성하기

GitHub에서는 다음 문법으로 체크박스를 만들 수 있다.

 

- [x] Git 설치
- [x] Repository 생성
- [ ] README 작성

 

하지만 티스토리에서는 체크박스로 표시되지 않고 일반 목록으로 변환될 수 있다.

따라서 티스토리에서는 체크박스 문자나 이모지를 직접 사용하는 것이 안정적이다.

✅ Git 설치
✅ Repository 생성
⬜ README 작성

 

결과는 다음과 같다.

✅ Git 설치
✅ Repository 생성
⬜ README 작성

조금 더 단순하게 작성하려면 다음 기호를 사용할 수도 있다.

☑ Git 설치
☑ Repository 생성
☐ README 작성

 

GitHub README를 작성할 때는 - [ ] 문법을 사용하고, 티스토리에서는 ✅, ⬜ 같은 문자를 사용하는 방식으로 구분하면 된다.

---

12. 줄바꿈과 문단 나누기

Markdown에서는 단순히 엔터를 한 번 입력한 것만으로 줄바꿈이 적용되지 않는 경우가 있다.

확실하게 줄바꿈하려면 <br> 태그를 사용할 수 있다.

 

첫 번째 문장<br>
두 번째 문장

 

결과는 다음과 같다.

첫 번째 문장
두 번째 문장

문단 자체를 구분하려면 문장 사이에 빈 줄을 하나 넣는다.

 

첫 번째 문단입니다.

두 번째 문단입니다.

 

블로그에서는 문장을 지나치게 붙여 쓰기보다, 내용이 달라지는 부분마다 빈 줄을 넣는 것이 읽기 좋다.

---

13. 구분선 만들기

내용의 흐름을 나누고 싶을 때는 하이픈을 세 개 이상 입력한다.

 

---

 

결과는 가로 구분선으로 표시된다.

구분선은 대주제가 바뀌거나, 본문과 출처를 구분할 때 사용할 수 있다.

---

14. Markdown 문법을 일반 문자로 표시하기

별표나 샵처럼 Markdown에서 특별한 의미가 있는 문자를 그대로 표시하려면 앞에 역슬래시를 붙인다.

 

\*별표를 그대로 표시하기\*

\# 제목으로 변환하지 않기

 

예를 들어 #을 문장 맨 앞에 쓰면 제목으로 처리될 수 있으므로, 일반 문자로 표시하려면 \#으로 작성한다.

---

15. 자주 사용하는 Markdown 문법 정리

기능문법

제목	## 제목
굵은 글씨	**텍스트**
기울임	*텍스트*
취소선	~~텍스트~~
인용문	> 인용문
한 줄 코드	`코드`
순서 없는 목록	- 항목
순서 있는 목록	1. 항목
링크	[텍스트](주소)
이미지	
줄바꿈	<br>
구분선	---

티스토리에서 체크리스트를 작성할 때는 다음 형태를 사용하면 된다.

✅ 완료한 항목
⬜ 완료하지 않은 항목

 

---

마무리

Markdown은 간단한 기호만으로 글의 구조를 정리할 수 있어 개발 문서, GitHub README, 기술 블로그 작성에 유용하다.

처음부터 모든 문법을 외울 필요는 없다. 제목, 굵은 글씨, 목록, 코드 블록, 링크 정도만 익혀도 대부분의 문서를 작성할 수 있다.

다만 Markdown을 지원하는 서비스마다 표시 방식이 조금씩 다르다. 특히 GitHub의 체크리스트나 경고 문법처럼 특정 서비스에서만 지원하는 기능도 있으므로, 글을 발행하기 전에 미리보기 화면을 확인하는 것이 좋다.

---

출처

GitHub Docs - 기본 쓰기 및 서식 지정 구문