마크다운 문법 총정리: 이 표 하나면 됩니다
깃허브 README, 노션, 개발 문서, 요즘 블로그까지. 어디를 가나 마크다운을 만나는데 문법은 늘 절반쯤만 기억나지 않으신가요? 이 글 하나로 끝내도록 정리했습니다. 각 문법마다 쓰는 법과 보이는 결과를 나란히 놓았고, 마지막에 한 장짜리 치트시트를 붙였습니다. 읽으면서 바로 실험해 보고 싶다면 마크다운 미리보기를 옆에 열어 두세요.
최종 업데이트: 2026년 7월
1. 마크다운, 30초 소개
마크다운은 기호 몇 개로 서식을 표현하는 글쓰기 규칙입니다. 별표 두 개로 감싸면 굵게, 우물 정 자를 붙이면 제목이 되는 식입니다. 파일로 저장하면 확장자가 .md인 평범한 텍스트 파일이라서 어디서든 열리고, 깃허브나 노션 같은 서비스가 이를 예쁜 문서로 바꿔 보여줍니다.
문법 전체래야 열 가지 남짓입니다. 아래 순서대로 한 번만 훑으면 오늘부터 쓸 수 있습니다.
2. 제목
줄 맨 앞에 #을 붙입니다. 개수가 늘수록 작은 제목이 되고, 여섯 단계까지 있습니다.
# 뒤에 공백 하나를 꼭 넣어야 합니다.
# 가장 큰 제목 (h1)
## 큰 제목 (h2)
### 중간 제목 (h3)
#### 작은 제목 (h4)문서 하나에 h1은 보통 맨 위 제목 하나만 쓰고, 본문의 큰 단락은 h2, 그 아래 소단락은 h3으로 내려가는 것이 관례입니다. 목차가 저절로 잡히는 구조가 됩니다.
3. 글자 꾸미기
감싸는 기호에 따라 꾸밈이 달라집니다.
이렇게 씁니다**굵게** *기울임* ~~취소선~~ `코드`
***굵은 기울임***도 됩니다각각 굵게, 기울임, 취소선, 코드로 보입니다.
백틱(`)으로 감싸는 인라인 코드는 명령어나 파일 이름, 버튼 이름처럼
"글자 그대로"임을 드러낼 때 씁니다. 별표를 꾸밈이 아니라 글자로 쓰고 싶다면 앞에
백슬래시를 붙여 \*처럼 씁니다.
4. 목록과 체크박스
순서 없는 목록은 -, 순서 있는 목록은 1.처럼 숫자와 점입니다.
항목 앞을 공백 두 칸(또는 네 칸)으로 들여 쓰면 하위 항목이 됩니다.
- 사과
- 배
- 신고배
- 원황배
1. 첫째
2. 둘째숫자는 순서를 틀리게 적어도 결과에서는 1, 2, 3으로 자동 정렬되므로, 나중에 항목을 중간에 끼워 넣어도 번호를 일일이 고칠 필요가 없습니다.
할 일 목록(체크박스)은 깃허브에서 시작된 확장 문법입니다. 대괄호 안에
x가 있으면 완료 표시입니다.
- [x] 초안 쓰기
- [ ] 검토 받기5. 링크와 이미지
링크는 대괄호에 보일 글자, 소괄호에 주소입니다. 이미지는 그 앞에 느낌표 하나만 더 붙입니다.
이렇게 씁니다[네이버](https://naver.com)
이미지의 대괄호 속 글자는 그림이 안 뜰 때 대신 보여줄 설명(대체 텍스트)입니다. 주소를 그냥 본문에 적어도 대부분의 서비스가 알아서 링크로 만들어 줍니다.
6. 인용
줄 앞에 >를 붙입니다. 남의 말이나 참고 문구, 강조하고 싶은 안내를
본문과 구분해 담을 때 씁니다.
> 완벽함이란 더할 것이 없을 때가 아니라
> 뺄 것이 없을 때 이루어진다.> >처럼 겹치면 인용 속 인용이 됩니다.
7. 코드
여러 줄 코드는 백틱 세 개로 감쌉니다. 여는 쪽에 언어 이름을 적으면 서비스에 따라 문법 색칠까지 해 줍니다.
이렇게 씁니다```js
function greet(name) {
return name + "님, 안녕하세요";
}
```코드가 아니어도 좋습니다. 들여쓰기와 줄바꿈을 그대로 보존하고 싶은 텍스트(로그, 설정, ASCII 그림)라면 무엇이든 코드 블록에 넣으면 망가지지 않습니다.
8. 표
세로줄 |로 칸을 나누고, 머리글 아래에 --- 구분줄을 한 줄
넣으면 표가 됩니다. 구분줄에 콜론을 붙이면 정렬 방향이 정해집니다.
| 이름 | 가격 | 재고 |
|:-----|-----:|:----:|
| 사과 | 3,000원 | 있음 |
| 배 | 5,000원 | 없음 |:---는 왼쪽 정렬, ---:는 오른쪽 정렬,
:---:는 가운데 정렬입니다. 숫자 열은 오른쪽 정렬로 맞추면 자릿수가
나란해져 읽기 좋습니다. 세로줄 개수를 칼같이 맞출 필요는 없습니다. 칸 수만 맞으면 됩니다.
셀 안 줄바꿈이나 병합처럼 표에서 자주 막히는 문제는
마크다운 표 만들기에 따로 정리했습니다.
9. 줄바꿈과 구분선
마크다운에서 가장 많이 헷갈리는 부분입니다. 엔터 한 번으로는 줄이 바뀌지
않습니다. 문단을 나누려면 빈 줄 하나를 사이에 두고, 같은 문단 안에서 줄만
바꾸려면 줄 끝에 공백 두 개를 남기거나 백슬래시(\)를 붙입니다.
첫째 문단입니다.
둘째 문단입니다. (빈 줄로 문단 나눔)
같은 문단, 다음 줄입니다. (윗줄 끝에 공백 두 개)가로 구분선은 빈 줄 사이에 ---를 한 줄로 적습니다. 장이 바뀌는 느낌을
줄 때 씁니다.
확인하며 쓰는 게 가장 빠릅니다. 문법이 맞는지 갸웃할 때마다 검색하는 것보다, 마크다운 미리보기에 붙여넣고 결과를 눈으로 확인하는 쪽이 빠릅니다. 표와 체크박스까지 이 글의 문법 그대로 렌더링됩니다.
10. 한 장 치트시트
즐겨찾기 해 두고 필요할 때 이 표만 보세요.
| 원하는 것 | 쓰는 법 | 비고 |
|---|---|---|
| 제목 | # 제목 | #의 개수 1~6개, 뒤에 공백 필수 |
| 굵게 | **글자** | |
| 기울임 | *글자* | |
| 취소선 | ~~글자~~ | 확장 문법(GFM) |
| 인라인 코드 | `글자` | 백틱(키보드 물결표 자리) |
| 목록 | - 항목 | 하위 항목은 공백 2칸 들여쓰기 |
| 번호 목록 | 1. 항목 | 번호는 자동 정렬 |
| 체크박스 | - [ ] 할 일 | 완료는 - [x] |
| 링크 | [글자](주소) | |
| 이미지 |  | 링크 앞에 느낌표 |
| 인용 | > 글자 | 겹치면 > > |
| 코드 블록 | ```언어 … ``` | 언어 이름은 생략 가능 |
| 표 | | a | b | | 둘째 줄에 |---|---| |
| 문단 나눔 | 빈 줄 | 엔터 한 번으로는 안 바뀜 |
| 줄바꿈 | 줄 끝 공백 2개 | 또는 줄 끝 \ |
| 구분선 | --- | 앞뒤로 빈 줄 |
| 기호 그대로 | \* \# | 백슬래시로 이스케이프 |
배운 문법, 바로 손에 익혀 보세요. 쓰는 즉시 완성된 문서로 보여주고, 글꼴을 바꿔 가며 확인할 수 있습니다.
마크다운 미리보기 열기11. 자주 묻는 질문
노션이나 깃허브나 문법이 똑같나요?
기본 문법(제목, 강조, 목록, 링크, 인용, 코드)은 어디서나 같습니다. 표·체크박스·취소선은 깃허브가 확장한 문법(GFM)인데, 워낙 널리 퍼져서 노션·디스코드 등 대부분의 서비스가 지원합니다. 다만 세부 동작(줄바꿈 처리 등)은 서비스마다 조금씩 다를 수 있습니다.
md 파일은 무엇으로 여나요?
평범한 텍스트 파일이라 메모장으로도 열립니다. 다만 기호가 날것으로 보이므로, 완성된 문서 모양으로 보려면 마크다운 미리보기에 파일을 끌어다 놓는 것이 가장 간단합니다.
표 안에서 세로줄(|)을 글자로 쓰려면요?
백슬래시를 붙여 \|로 씁니다. 그러면 칸 구분이 아니라 글자 |로 들어갑니다.
워드나 한글(HWP)로 옮기려면 어떻게 하나요?
마크다운 미리보기에서 렌더링된 결과를 마우스로 긁어 복사한 뒤 워드에 붙여넣으면 제목·굵기·표가 대체로 유지됩니다. 더 깔끔하게는 인쇄 기능으로 PDF를 만들어 공유하는 방법도 있습니다.