Markdown, 가장 간단한 글쓰기 양식
Markdown은 간단한 문법으로 읽기 쉬운 구조화된 문서를 만드는 마크업 언어입니다. GitHub, Notion, Medium, Reddit 등 거의 모든 플랫폼에서 지원합니다.
HTML은 복잡하고, Microsoft Word는 무겁지만, Markdown은 메모장만으로도 충분합니다. 이 가이드를 읽으면 Markdown 마스터가 될 수 있습니다.
1부: Markdown 기초
제목 (Headings)
# 제목 1 (H1)
## 제목 2 (H2)
### 제목 3 (H3)
#### 제목 4 (H4)
##### 제목 5 (H5)
###### 제목 6 (H6)주의: # 다음에 반드시 공백 필요
본문 (Paragraph)
일반 문본은 그냥 입력합니다.
줄바꿈은 공백 2개 또는 Enter 2번으로 합니다.
예:
이것은 첫 번째 문단입니다.
이것은 두 번째 문단입니다.강조 (Emphasis)
*이탤릭* 또는 _이탤릭_
**볼드** 또는 __볼드__
***볼드 이탤릭*** 또는 ___볼드 이탤릭___
~~취소선~~렌더링 결과
- 이탤릭 또는 이탤릭
- 볼드 또는 볼드
- 볼드 이탤릭 또는 볼드 이탤릭
취소선
목록 (Lists)
순서 있는 목록
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목
또는
1) 첫 번째
2) 두 번째
3) 세 번째순서 없는 목록
- 항목 1
- 항목 2
- 항목 3
또는
* 항목 1
* 항목 2
* 항목 3
또는
+ 항목 1
+ 항목 2
+ 항목 3중첩 목록
1. 첫 번째
- 하위 1
- 하위 2
2. 두 번째
- 하위 1
- 더 하위 1링크 (Links)
인라인 링크
[링크 텍스트](https://example.com)자동 링크
참조 링크
[이것은 링크][1]
[또 다른 링크][2]
[1]: https://example.com
[2]: https://example.org이미지 (Images)
2부: 고급 문법
코드 (Code)
인라인 코드
이것은 인라인 코드입니다.
형식: 텍스트 사이에 백틱 기호 사용코드 블록
함수(function) {
console.log('Hello World');
}
같은 효과:function test() {
console.log('Hello World');
}인용 (Blockquote)
> 이것은 인용문입니다.
> 인용문은 > 기호로 시작합니다.
> 여러 단락을 인용할 수 있습니다.
>
> 이것은 두 번째 문단입니다.수평선 (Horizontal Line)
---
또는
***
또는
___표 (Tables)
| 헤더 1 | 헤더 2 | 헤더 3 |
|--------|--------|--------|
| 셀 1-1 | 셀 1-2 | 셀 1-3 |
| 셀 2-1 | 셀 2-2 | 셀 2-3 |
정렬:
| 왼쪽 | 중앙 | 오른쪽 |
|:------|:------:|-------:|
| L | C | R |체크리스트
- [x] 완료된 항목
- [ ] 미완료 항목
- [x] 또 다른 완료 항목
GitHub, Notion, Markdown Pro에서 지원각주 (Footnotes)
이것은 각주입니다[^1].
[^1]: 각주의 내용은 여기에 쓰입니다.
(모든 플랫폼에서 지원하지는 않음)3부: 플랫폼별 활용
GitHub (README.md)
# 프로젝트 이름
프로젝트 설명
## 설치
npm install my-project
## 사용 예시
const lib = require('my-project');
lib.doSomething();
## 라이선스
MIT License블로그 (GitHub Pages, Notion)
---
title: 블로그 제목
date: 2026-03-02
author: 작성자
---
# 블로그 제목
본문 내용...기술 문서
# API 문서
## 엔드포인트
### GET /users
사용자 목록 조회
**파라미터:**
- page: 페이지 번호
- limit: 조회 수
**응답:**
```json
{
"data": [...],
"total": 100
}
```4부: Markdown 팁과 트릭
1. 줄바꿈 제어
// 스페이스 2개로 줄바꿈 (모든 Markdown)
줄 1
줄 2
// HTML 태그로 줄바꿈
줄 1
줄 2
// 백슬래시로 줄바꿈
줄 1\
줄 22. 특수문자 이스케이프
특수문자 앞에 백슬래시 추가:
*별표*
[대괄호]
(괄호)
#해시#3. HTML 삽입
Markdown에서 직접 HTML 사용 가능:
HTML 내용
4. 목차 (Table of Contents)
# 목차
- [소개](#소개)
- [설치](#설치)
- [사용법](#사용법)
## 소개
## 설치
## 사용법5. 이모지 추가
👍 좋음
⚠️ 주의
✅ 완료
❌ 실패
🚀 배포5부: 자주 하는 실수
1. 제목과 텍스트 구분 안 함
❌ 제목을 굵은 텍스트로 표시
✅ # 제목 문법 사용
2. 코드 블록의 언어 지정 안 함
❌
```
function test() {}
```✅
```javascript
function test() {}
```3. 줄바꿈 혼동
❌ Enter 1번은 줄바꿈으로 처리 안 함
✅ Enter 2번 또는 스페이스 2개 사용
4. 링크 형식 오류
❌ [텍스트] (URL) - 스페이스 있음
✅ [텍스트](URL) - 스페이스 없음
5. 이미지 링크와 일반 링크 혼동
❌ [이미지](URL) - 일반 링크
✅  - 이미지
마크다운 변형
CommonMark (표준)
기본 Markdown 표준
GitHub Flavored Markdown (GFM)
GitHub의 확장 문법: - 표 (Tables) - 취소선 (Strikethrough) - 자동 링크
MultiMarkdown
더 많은 기능: - 각주 - 메타데이터 - 수식
도구 추천
온라인 에디터
- Markdown Editor: 실시간 미리보기
- Notion: 협업 및 저장
- Dillinger.io: 웹 기반 에디터
데스크톱 앱
- VS Code: 개발자 친화적
- Obsidian: 노트 관리
- Bear: macOS 전용
마무리
Markdown은 쉽지만 강력합니다. 블로그 글부터 기술 문서까지, 어디서나 사용할 수 있습니다. 간단한 문법으로 전문적인 문서를 만들어보세요!
Markdown 에디터로 지금 바로 시작하세요!