logo

마크다운 완전 정복: 개발자가 아니어도 쓸 수 있는 문서 작성법

2026-04-05| Jay

GitHub, Notion, Slack, 기술 블로그... 요즘 텍스트를 다루는 곳이면 어디서든 마크다운을 만나게 됩니다. 마크다운은 2004년 John Gruber가 만든 경량 마크업 언어로, 특수 기호 몇 개만으로 서식 있는 문서를 작성할 수 있습니다.

왜 마크다운인가?

  1. 배우기 쉬움: 10가지 문법이면 90%의 문서를 작성할 수 있습니다.
  2. 플랫폼 독립적: .md 파일은 어디서든 열 수 있습니다.
  3. 버전 관리 친화: 텍스트 기반이라 Git으로 변경 이력 추적이 용이합니다.
  4. 변환 용이: 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)

![대체 텍스트](이미지URL)

링크와 동일한 문법에 !를 앞에 붙입니다.

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

결론

마크다운은 한 번 배우면 평생 쓰는 도구입니다. 복잡한 에디터 없이도 깔끔한 문서를 빠르게 작성할 수 있습니다.

지금 바로 마크다운 미리보기 도구에서 직접 연습해 보세요!