GitHub, Notion, Slack, 기술 블로그... 요즘 텍스트를 다루는 곳이면 어디서든 마크다운을 만나게 됩니다. 마크다운은 2004년 John Gruber가 만든 경량 마크업 언어로, 특수 기호 몇 개만으로 서식 있는 문서를 작성할 수 있습니다.
왜 마크다운인가?
- 배우기 쉬움: 10가지 문법이면 90%의 문서를 작성할 수 있습니다.
- 플랫폼 독립적:
.md파일은 어디서든 열 수 있습니다. - 버전 관리 친화: 텍스트 기반이라 Git으로 변경 이력 추적이 용이합니다.
- 변환 용이: HTML, PDF, Word 등 다양한 형식으로 변환 가능합니다.
핵심 문법 10가지
1. 제목 (Headings)
# 제목 1 (H1)
## 제목 2 (H2)
### 제목 3 (H3)
#### 제목 4 (H4)
# 개수로 제목 레벨을 지정합니다. H1은 문서당 1개만 사용하는 것이 관례입니다.
2. 강조 (Emphasis)
**굵은 글씨**
*기울임*
~~취소선~~
***굵은 기울임***
3. 목록 (Lists)
- 순서 없는 목록
- 두 번째 항목
- 중첩 항목
1. 순서 있는 목록
2. 두 번째 항목
4. 링크 (Links)
[표시할 텍스트](https://example.com)
5. 이미지 (Images)

링크와 동일한 문법에 !를 앞에 붙입니다.
6. 인용문 (Blockquote)
> 인용문은 이렇게 작성합니다.
> 여러 줄도 가능합니다.
7. 코드 (Code)
인라인 코드: `console.log('hello')`
코드 블록:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
8. 표 (Table)
| 이름 | 나이 | 직업 |
|:---|:---:|---:|
| 홍길동 | 30 | 개발자 |
| 김영희 | 28 | 디자이너 |
:--- 왼쪽 정렬, :---: 가운데 정렬, ---: 오른쪽 정렬
9. 수평선 (Horizontal Rule)
---
10. 체크리스트 (Task List)
- [x] 완료된 항목
- [ ] 미완료 항목
마크다운 작성 팁
줄바꿈 주의사항
마크다운에서 단순 엔터 1번은 줄바꿈이 되지 않습니다. 빈 줄 1개를 넣어야 새 단락이 됩니다. 같은 단락 내 줄바꿈은 줄 끝에 공백 2개를 넣으세요.
이스케이프
마크다운 기호를 그대로 표시하려면 앞에 \를 붙입니다:
\*별표\* → *별표*
\# 샵 → # 샵
마크다운이 지원되는 곳
- GitHub: README, 이슈, PR, Wiki
- Notion:
/markdown블록 - Slack: 메시지 서식
- 블로그: Jekyll, Hugo, Gatsby 등
- 노트: Obsidian, Typora, Bear
결론
마크다운은 한 번 배우면 평생 쓰는 도구입니다. 복잡한 에디터 없이도 깔끔한 문서를 빠르게 작성할 수 있습니다.
지금 바로 마크다운 미리보기 도구에서 직접 연습해 보세요!
