마크다운 치트 시트: 완벽한 참조 가이드
· 12분 읽기
마크다운은 웹에서 텍스트 서식을 지정하는 보편적인 언어가 되었습니다. GitHub에서 문서를 작성하든, Reddit에 게시하든, Discord에서 채팅하든, Notion에서 노트를 정리하든, 또는 수많은 다른 플랫폼에서 콘텐츠를 만들든, 마크다운은 어디에나 있습니다. 이 간단하면서도 강력한 구문을 배우면 사용하는 모든 디지털 작업 공간에서 생산성이 향상됩니다.
이 포괄적인 가이드는 기본 서식부터 고급 기술까지 실용적인 예제와 실제 사용 사례를 포함하여 모든 것을 다룹니다. 마크다운에 관한 모든 것을 위한 참조 자료로 이 페이지를 북마크하세요.
📑 목차
마크다운이란 무엇이며 왜 사용하나요?
마크다운은 2004년 John Gruber가 만든 경량 마크업 언어입니다. 그 철학은 간단합니다: 일반 텍스트는 그대로 읽을 수 있어야 하지만 HTML 및 기타 형식으로도 변환할 수 있어야 합니다. 버튼과 메뉴 뒤에 서식을 숨기는 리치 텍스트 편집기와 달리 마크다운은 모든 것을 보이고 이식 가능하게 유지합니다.
마크다운의 아름다움은 단순함에 있습니다. 모든 텍스트 편집기에서 작성할 수 있고, Git으로 버전 관리할 수 있으며, HTML, PDF 또는 수십 가지 다른 형식으로 변환할 수 있습니다. 기술 문서, README 파일, 블로그 게시물 및 협업 작성을 위한 사실상의 표준이 되었습니다.
마크다운이 사용되는 곳:
- README 파일과 문서를 위한 GitHub, GitLab, Bitbucket
- 서식이 지정된 메시지를 위한 Reddit, Discord, Slack
- 노트 작성을 위한 Notion, Obsidian, Roam Research
- Jekyll, Hugo, Gatsby와 같은 정적 사이트 생성기
- 콘텐츠 관리 시스템 및 블로깅 플랫폼
- 기술 작성 도구 및 문서 플랫폼
프로 팁: 실시간 미리보기로 구문을 연습하려면 무료 마크다운 편집기를 사용하세요. 실습을 통해 배우는 가장 빠른 방법입니다.
기본 텍스트 서식
마크다운의 기본 서식 구문은 직관적이고 기억하기 쉽습니다. 대부분의 서식은 스타일을 지정하려는 텍스트를 둘러싸는 특수 문자를 사용합니다.
굵은 텍스트
이중 별표 또는 이중 밑줄로 단어를 감싸서 굵은 텍스트를 만듭니다:
**이 텍스트는 굵게 표시됩니다**
__이것도 굵게 표시됩니다__
둘 다 다음과 같이 생성됩니다: 이 텍스트는 굵게 표시됩니다
기울임꼴 텍스트
기울임꼴 텍스트에는 단일 별표 또는 단일 밑줄을 사용합니다:
*이 텍스트는 기울임꼴입니다*
_이것도 기울임꼴입니다_
둘 다 다음과 같이 생성됩니다: 이 텍스트는 기울임꼴입니다
굵게 및 기울임꼴 결합
세 개의 별표를 사용하거나 별표와 밑줄을 혼합하여 둘 다 결합합니다:
***굵고 기울임꼴 텍스트***
**_역시 굵고 기울임꼴_**
결과: 굵고 기울임꼴 텍스트
취소선
대부분의 마크다운 변형은 이중 물결표로 취소선을 지원합니다:
~~이 텍스트는 취소선이 그어집니다~~
결과: 이 텍스트는 취소선이 그어집니다
인라인 코드
텍스트를 단일 백틱으로 감싸서 인라인 코드로 서식을 지정합니다:
디버그하려면 `console.log()` 함수를 사용하세요.
결과: 디버그하려면 console.log() 함수를 사용하세요.
| 구문 | 출력 | 사용 사례 |
|---|---|---|
**text** |
text | 강조, 중요한 용어 |
*text* |
text | 미묘한 강조, 책 제목 |
~~text~~ |
삭제된 콘텐츠, 수정 | |
`text` |
text |
코드, 명령어, 파일 이름 |
제목과 문서 구조
제목은 문서 계층 구조를 만들고 가독성을 향상시킵니다. 마크다운은 HTML의 <h1>부터 <h6> 태그와 일치하는 6단계의 제목을 지원합니다.
# 제목 1 (가장 큼)
## 제목 2
### 제목 3
#### 제목 4
##### 제목 5
###### 제목 6 (가장 작음)
해시 기호의 수가 제목 수준을 결정합니다. 항상 해시 기호와 제목 텍스트 사이에 공백을 포함하세요.
모범 사례: 제목 수준을 계층적으로 사용하세요. H1에서 H4로 건너뛰지 마세요. 이는 스크린 리더의 접근성을 향상시키고 검색 엔진이 콘텐츠 구조를 이해하는 데 도움이 됩니다.
대체 제목 구문
H1과 H2의 경우 밑줄 스타일 구문도 사용할 수 있습니다:
제목 1
=========
제목 2
---------
그러나 해시 기호 구문이 더 일반적이며 6단계 모두를 지원합니다.
제목 모범 사례
- 문서당 하나의 H1만 사용 (일반적으로 제목)
- 제목을 간결하고 설명적으로 유지
- 문장 대소문자 또는 제목 대소문자를 일관되게 사용
- 제목을 구두점으로 끝내지 마세요
- 가독성을 위해 제목 앞뒤에 빈 줄 추가
목록: 순서 있는 목록, 순서 없는 목록, 중첩 목록
목록은 정보를 구성하는 데 기본적입니다. 마크다운은 순서 없는(글머리 기호) 목록, 순서 있는(번호 매기기) 목록 및 둘의 중첩 조합을 지원합니다.
순서 없는 목록
별표, 하이픈 또는 더하기 기호를 사용하여 글머리 기호 목록을 만듭니다. 세 가지 모두 동일한 출력을 생성합니다:
* 첫 번째 항목
* 두 번째 항목
* 세 번째 항목
- 첫 번째 항목
- 두 번째 항목
- 세 번째 항목
+ 첫 번째 항목
+ 두 번째 항목
+ 세 번째 항목
일관성을 위해 문서 전체에서 하나의 스타일을 선택하고 고수하세요.
순서 있는 목록
마침표로 목록 항목에 번호를 매깁니다. 실제 숫자는 중요하지 않습니다—마크다운이 자동으로 번호를 다시 매깁니다:
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목
1. 첫 번째 항목
1. 두 번째 항목
1. 세 번째 항목
둘 다 동일한 번호 매기기 목록을 생성합니다. 모두 1을 사용하면 번호를 다시 매기지 않고 항목을 재정렬하기가 더 쉽습니다.
중첩 목록
중첩된 항목을 2개 또는 4개의 공백으로 들여쓰기합니다(일관성 유지):
1. 첫 번째 항목
- 중첩된 글머리 기호
- 또 다른 중첩된 글머리 기호
2. 두 번째 항목
1. 중첩된 번호
2. 또 다른 중첩된 번호
작업 목록
많은 마크다운 변형은 체크박스가 있는 작업 목록을 지원합니다:
- [x] 완료된 작업
- [ ] 미완료 작업
- [ ] 또 다른 미완료 작업
이는 GitHub 이슈 및 프로젝트 관리 도구에서 특히 유용합니다.
빠른 팁: 여러 단락으로 된 목록 항목을 작성할 때 후속 단락을 글머리 기호가 아닌 텍스트의 첫 번째 줄에 맞춰 들여쓰기하세요.
링크와 이미지
마크다운을 사용하면 HTML 태그로 텍스트를 어지럽히지 않고 하이퍼링크와 이미지를 쉽게 추가할 수 있습니다.
기본 링크
링크 구문은 간단합니다: 링크 텍스트에는 대괄호, URL에는 괄호를 사용합니다:
[마크다운 편집기 방문](/tools/markdown-editor/)
결과: 마크다운 편집기 방문
제목이 있는 링크
URL 뒤에 따옴표로 제목 속성(마우스 오버 시 표시)을 추가합니다:
[GitHub](https://github.com "GitHub 방문")
참조 스타일 링크
반복되는 링크가 많은 문서의 경우 참조 스타일 구문을 사용하여 텍스트를 깔끔하게 유지합니다:
자세한 정보는 [Google][1]과 [GitHub][2]를 확인하세요.
[1]: https://google.com "Google"
[2]: https://github.com "GitHub"
참조 정의는 문서의 어디에나 나타날 수 있으며 출력에 표시되지 않습니다.
자동 링크
URL 또는 이메일 주소를 꺾쇠 괄호로 감싸서 클릭 가능하게 만듭니다:
<https://example.com>
<email@example.com>
많은 마크다운 프로세서는 꺾쇠 괄호 없이 일반 URL도 자동으로 링크합니다.
이미지
이미지 구문은 링크와 동일하지만 느낌표 접두사가 있습니다:


대체 텍스트는 접근성과 SEO에 중요합니다. 항상 이미지가 무엇을 보여주는지 설명하는 설명적인 대체 텍스트를 제공하세요.
이미지 모범 사례
- 접근성을 위해 설명적인 대체 텍스트 작성
- 동일한 저장소의 이미지에는 상대 경로 사용
- 더 빠른 로딩을 위해 이미지 파일 크기 최적화
- 반복되는 이미지에는 참조 스타일 구문 사용 고려
- 대상 플랫폼에서 이미지가 올바르게 표시되는지 테스트
코드 블록과 구문 강조
코드 블록은 기술 문서에 필수적입니다. 마크다운은 인라인 스니펫부터 구문 강조가 있는 여러 줄 블록까지 코드를 서식 지정하는 여러 방법을 제공합니다.
인라인 코드
앞서 언급했듯이 인라인 코드를 단일 백틱으로 감쌉니다:
변경 사항을 저장하려면 `git commit` 명령을 사용하세요.
펜스 코드 블록
여러 줄 코드의 경우 코드 앞뒤에 삼중 백틱(또는 삼중 물결표)을 사용합니다:
```
function greet(name) {
return `Hello, ${name}!`;
}
```
구문 강조
구문 강조를 위해 여는 백틱 뒤에 프로그래밍 언어를 지정합니다:
```javascript
function greet(name) {
return `Hello, ${name}!`;
}
```
```python
def greet(name):
return f"Hello, {name}!"
```
```css
.button {
background-color: #06b6d4;
border-radius: 8px;
}
```
대부분의 마크다운 프로세서는 JavaScript, Python, Java, C++, Ruby, Go, Rust, SQL, HTML, CSS 등을 포함한 수십 가지 언어를 지원합니다.
들여쓰기 코드 블록
이전 구문은 4칸 들여쓰기를 사용하여 코드 블록을 만듭니다:
function example() {
return true;
}
그러나 펜스 코드 블록은 구문 강조를 지원하고 일반 텍스트에서 읽기 쉽기 때문에 선호됩니다.
프로 팁: 마크다운 문서에 붙여넣기 전에 코드를 서식 지정하려면 HTML Beautifier를 사용하세요. 깔끔하고 잘 서식 지정된 코드는 읽고 유지 관리하기가 더 쉽습니다.
표 만들기
표는 데이터를 행과 열로 구성합니다. 마크다운 표는 HTML 표만큼 유연하지 않지만 간단한 데이터 표현에 완벽합니다.
기본 표 구문
파이프와 하이픈을 사용하여 표를 만듭니다:
| 헤더 1 | 헤더 2 | 헤더 3 |
|----------|----------|----------|
| 셀 1 | 셀 2 | 셀 3 |
| 셀 4 | 셀 5 | 셀 6 |
파이프가 완벽하게 정렬될 필요는 없습니다—마크다운 프로세서가 올바르게 서식을 지정합니다. 그러나 정렬된 파이프는 일반 텍스트에서 표를 읽기 쉽게 만듭니다.
열 정렬
구분선 행에서 콜론을 사용하여 텍스트 정렬을 제어합니다:
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
|:-------------|:--------------:|--------------:|
| 텍스트 | 텍스트 | 텍스트 |
| 더 많은 텍스트 | 더 많은 텍스트 | 더 많은 텍스트 |
:---왼쪽 정렬 (기본값):---:가운데 정렬---:오른쪽 정렬
실용적인 표 예제
| 마크다운 변형 | 표 | 작업 목록 | 각주 |
|---|---|---|---|
| CommonMark | ❌ 아니오 | ❌ 아니오 |