나무모에 미러 (일반/어두운 화면)
최근 수정 시각 : 2026-11-18 16:58:05

마크다운

markdown에서 넘어옴

1. 개요2. 문법
2.1. 문단 제목2.2. 문단2.3. 목록2.4. 글자 모양2.5. 코드2.6. 인용문2.7. 링크2.8. 그림 넣기2.9. 가로줄2.10. 표
3. 마크다운 변형판
3.1. CommonMark3.2. GitHub Flavored Markdown3.3. MultiMarkdown3.4. Obsidian Flavored Markdown3.5. Haroopad Flavored Markdown
4. 마크다운을 사용하는 곳5. 기타6. 관련 문서

1. 개요


마크다운 (Markdown)은 마크업 언어의 일종으로, 존 그루버(John Gruber)[1]와 애런 슈워츠가 2004년 공개한 일반 텍스트 기반의 경량 마크업 언어이다. 온갖 태그로 범벅된 HTML 문서 등과 달리, 읽기도 쓰기도 쉬운 문서 양식을 지향한다. 그루버는 마크다운으로 작성한 문서를 HTML로 변환하는 Perl 스크립트도 만들었다.[2] 흔히 볼 수 있는 문서(파일명)은 'README.md', 파일의 확장자는 .md 또는 .markdown을 쓴다.[3]

2. 문법

또한 마크다운은 표준이 없기 때문에 가장 보편적으로 허용되는 기본적인 문법만 소개한다. CommonMark의 경우 후술하듯이 표 등 기본적인 기능조차 없기 때문에 GitHub Flavored Markdown 등 여러 확장 문법들 또한 설명할 수 있으며, 보편성의 기준은 GitHub, GitLab, Reddit, Qt, Stack Overflow 등등에서 차용하는 것으로 본다.

2.1. 문단 제목

6단계까지 할 수 있다.
#!syntax markdown
# 1단계 제목
## 2단계 제목
[ 결과물 펼치기 · 접기 ]
1단계 제목
2단계 제목

2.2. 문단

줄 바꿈을 두 번 하면 된다.
#!syntax markdown
첫째 문단입니다. 문장이 두 개죠.

둘째 문단입니다. 저도
문장이 두 개입니다.
[ 결과물 펼치기 · 접기 ]
첫째 문단입니다. 문장이 두 개죠.

둘째 문단입니다. 저도
문장이 두 개입니다.

마크다운은 기본적으로 강제개행을 인식하지 않기 때문에, 두 번째 예시를 HTML 등으로 변환할 경우 줄 바꿈이 없는 '둘째 문단입니다. 저도 문장이 두 개입니다.'로 변환된다. 강제 개행을 인식하게 하려면 줄 끝에 공백을 두 칸 넣거나(가독성 문제로 권장되지 않음), 아니면 줄 끝에 역슬래시(\\)를 넣어도 된다.

2.3. 목록

첫 번째 칸을 띄어 쓰지 않아도 된다.
#!syntax markdown
* 목록 하나
    * 목록 하나에 하나
* 목록 둘
* 목록 셋
- 이렇게 써도
- 된답니다.
[ 결과물 펼치기 · 접기 ]
* 목록 하나
  • 목록 하나에 하나
  • 목록 둘
  • 목록 셋
  • 이렇게 써도
  • 된답니다.


순서가 있는 목록은 다음과 같이 쓴다. 숫자는 반드시 맞춰 쓸 필요는 없다. 모든 항목을 1.로 맞추어도 상관 없고, 스타일 가이드에 따라서는 (추후 항목을 추가하거나 삭제할 때 용이하다는 이유로) 그렇게 할 것이 권장되기도 한다. 어차피 마크다운 기본 문법에서는 각 행이 HTML의 <li> 태그로 변환되는 것일 뿐이라 번호 정보가 사라지기 때문.
#!syntax markdown
1. 첫째입니다.
2. 둘째입니다.
3. 셋째입니다.
5. 넷째입니다. 
    5. 다섯째 아닙니다.
        6. 여섯째도 아니고요.
6. 이게 다섯째입니다.
4. 이건 여섯째.
[ 결과물 펼치기 · 접기 ]
1. 첫째입니다.
  1. 둘째입니다.
  2. 셋째입니다.
  3. 넷째입니다.
    1. 다섯째 아닙니다.
      1. 여섯째도 아니고요.
  4. 이게 다섯째입니다.
  5. 이건 여섯째.

2.4. 글자 모양

굵은 글자는 다음과 같이 쓴다.
#!syntax markdown
**굵게** 쓰거나 __두껍게__ 쓰거나
굵게 쓰거나 두껍게 쓰거나


기울임 꼴 글자는 다음과 같이 쓴다.
#!syntax markdown
*기울게* 쓰면서 _기울게_ 쓴다

기울게 쓰면서 기울게 쓴다

2.5. 코드

(특히 프로그래밍 관련 문서에서) 코드를 입력할 필요가 있을 땐 다음과 같이 쓴다. 고정 폭 글꼴로 출력된다.

문장 중간에 표시할 땐 다음과 같이 쓴다.[4]
#!syntax markdown
예를 들어 `import antigravity` 이렇게요.
예를 들어
import antigravity
이렇게요.


여러 줄의 코드는 백틱(`) 3개로 감싸서 다음과 같이 쓴다. 이와 같이 여러 줄을 묶어놓은 것을 흔히 '코드블록'이라고 부른다.
#!syntax markdown
```javascript
const test = '위에 javascript는 실제로 보이지 않고, ';
const other = '대부분 어떤 언어인지 알려주는 용도입니다.';
console.log(test, other);
console.log("가끔씩은 파일 이름을 쓰기도 합니다.")
```
[ 결과물 펼치기 · 접기 ]
#!syntax javascript
const test = '위에 javascript는 실제로 보이지 않고, ';
const other = '대부분 어떤 언어인지 알려주는 용도입니다.';
console.log(test, other);
console.log("가끔씩은 파일 이름을 쓰기도 합니다.")

2.6. 인용문

줄 첫 번째마다 >를 쓰면 된다.
#!syntax markdown
> > 안녕하세요.
>
> 예시입니다.
[ 결과물 펼치기 · 접기 ]
>> 안녕하세요.
예시입니다.

2.7. 링크

링크는 다음과 같이 쓴다.
#!syntax markdown
[나무위키](https://namu.wiki/w/나무위키:대문)
나무위키


또는 다음과 같이 써서 주석 형태로 링크를 쓸 수 있다.
#!syntax markdown
출처는 [위키백과][wiki]입니다.

[wiki]: http://en.wikipedia.org/wiki/Markdown#Syntax_examples "위키백과 Markdown 항목"
출처는 위키백과입니다.

2.8. 그림 넣기

그림을 넣을 땐 다음과 같이 쓴다.
#!syntax markdown
![세피로트](https://upload.wikimedia.org/wikipedia/ko/4/43/나무위키.svg?utm_source=ko.wikipedia.org&utm_campaign=imageinfo&utm_content=original "툴팁 메시지. 이 부분은 생략해도 됩니다.")
[ 결과물 펼치기 · 접기 ]
파일:나무위키 로고.svg


또는 다음과 같이 써서 주석 형태로 그림을 넣을 수 있다.
#!syntax markdown
![세피로트][SD]

[SD]: https://upload.wikimedia.org/wikipedia/ko/4/43/나무위키.svg "툴팁 메시지. 이 부분은 생략해도 됩니다."
[ 결과물 펼치기 · 접기 ]
파일:나무위키 로고.svg

"세피로트" 부분은 HTML img 태그의 alt 속성에, "툴팁 메시지" 부분은 title 속성에 해당한다.

2.9. 가로줄

가로줄을 넣는 문법은 여러 가지가 있다.
#!syntax markdown
* * *
***
*****
---
- - -
------------
[ 결과물 펼치기 · 접기 ]
----






2.10. 표

표를 만드는 문법은 이렇게 사용한다.
#!syntax markdown
| 1 | 2 |
|---|---|
| 1 | 2 |
[ 결과물 펼치기 · 접기 ]
|| 1 || 2 ||
1 2

1번째 줄은 제목,
3번째 줄부터는 내용이다.

3. 마크다운 변형판

3.1. CommonMark

상술한 역사적인 markdown의 최초 구현과 비교하여 추가된 차이만 나열한다. 마크다운과 CommonMark는 1:1로 완전히 동일하게 교환 가능한 개념이 아니다.

3.2. GitHub Flavored Markdown

Github-Flavored Markdown

대표적으로 GitHub에서 쓰이며 CommonMark와 비교하여 다음과 같은 차이점이 있다.
GitHub의 마크다운 구현체와 GFM은 1:1로 동일한 개념이 아니다. 일반적으로 GitHub에서 보는 기능들 중 상당수는 GFM 스펙에서 다루지 않는 것들이다. 자세한 차이는 문서 참고.
파일:상세 내용 아이콘.svg   자세한 내용은 GitHub Flavored Markdown 문서
#!if (문단 == null) == (앵커 == null)
를
#!if 문단 != null & 앵커 == null
의 [[GitHub Flavored Markdown#s-|]]번 문단을
#!if 문단 == null & 앵커 != null
{{{#!if 문서명 = 문서명 != null ? 문서명 : calleeTitle
의 [[GitHub Flavored Markdown#|]] 부분을}}}
참고하십시오.

3.3. MultiMarkdown

MultiMarkdown
기존 마크다운에 없는 기능(주석, 표 등)이 추가되어 있다.

3.4. Obsidian Flavored Markdown

파일:상세 내용 아이콘.svg   자세한 내용은 Obsidian 문서
#!if (문단 == null) == (앵커 == null)
를
#!if 문단 != null & 앵커 == null
의 [[Obsidian#s-|]]번 문단을
#!if 문단 == null & 앵커 != null
{{{#!if 문서명 = 문서명 != null ? 문서명 : calleeTitle
의 [[Obsidian#OFM|OFM]] 부분을}}}
참고하십시오.

3.5. Haroopad Flavored Markdown

하루패드에서 쓰이며 다음과 같은 차이점이 있다.

4. 마크다운을 사용하는 곳

5. 기타

사실상 개발자 내지 개발 관련 직군만이 주로 사용하는 문법이었지만 LLM의 보급과 함께 LLM이 플레인텍스트 출력을 렌더하는 용도로 사용하기 시작했다. 그런데 LLM 출력에서 오류로 인해 문법이 제대로 렌더링되지 않고 마크다운 형식 그대로 출력되는 경우가 종종 발생해서 일반인도 접할 기회가 소폭 늘어나게 되었다. 와... 너 정말, **핵심을 찔렀어.** 같은 것이 대표적이다. 특히 마크다운 렌더가 지원되지 않는 플랫폼에 뜬금없이 마크다운 문법이 그대로 보이면 LLM 사용을 의심해도 좋을 정도.

6. 관련 문서


[1] 유명한 애플 관련 블로거로 Daring Fireball의 운영자다.[2] 다만 요즘에는 범용성이 높은 pandoc을 더 많이 쓰는 듯.[3] 대표 사례로 깃허브의 README.md가 있다. 확장자로서는 .md가 .markdown보다 압도적으로 많이 쓰인다.[4] 파이썬의 이스터 에그 중 하나. 웹 브라우저로 xkcd의 만화 PYTHON을 띄운다.[5] 윈도우 11 한정으로 공식 지원한다.[6] 설치형 블로그에서 지원하는 경향이 있다.[7] 다만 인용이 중앙에 대문짝만하게 박히는 등 스타일이 일반적인 마크다운 문서와 차이가 크거나 문법이 제대로 작동하지 않는 부분도 있기 때문에 사용을 권장하진 않는다.[8] 협업 스타일의 노트, 일정 앱에서 활용된다.[9] 맨 앞에 -# 를 쓰면 작은 회색이 된다.