Skip to content
FreeConvertter

마크다운 기본 문법 정리

작성일:

마크다운(Markdown)은 일반 문자 몇 개로 서식을 표현하는 글쓰기 방식입니다. 메모장으로 써도 되고, 원문 그대로 읽어도 자연스럽습니다. GitHub, 옵시디언, 노션, 블로그 플랫폼, 기술 문서 사이트 등 많은 곳에서 쓰입니다.

제목

줄 맨 앞에 #을 붙이고 한 칸 띄웁니다. #이 많을수록 작은 제목입니다.

# 가장 큰 제목
## 두 번째 단계 제목
### 세 번째 단계 제목

문단과 줄바꿈

문단 사이에는 빈 줄을 넣습니다. 빈 줄 없이 다음 줄에 이어 쓰면 같은 문단으로 이어 붙습니다. 문단 안에서 줄만 바꾸고 싶다면 줄 끝에 공백 두 칸을 넣습니다.

강조

**굵게**   *기울임*   ~~취소선~~   `코드`

결과: 굵게, 기울임, 취소선, 코드

목록

- 사과
- 바나나
  - 하위 항목은 두 칸 이상 들여쓰기

1. 첫째
2. 둘째

링크와 이미지

[FreeConvertter](https://freeconvertter.com)
![그림 설명](images/logo.png)

이미지는 링크 앞에 !를 붙이고, 괄호 안에 이미지 파일의 경로나 주소를 적습니다.

인용

> 인용할 문장을 적습니다.

코드 블록

백틱(`) 세 개로 감쌉니다. 그 안의 글은 서식 없이 그대로 보입니다.

```
npm install
npm run dev
```

표

| 항목 | 가격 |
| --- | ---: |
| 사과 | 1,200 |
| 바나나 | 800 |

두 번째 줄의 ---가 머리글과 본문을 나눕니다. ---:처럼 오른쪽에 콜론을 붙이면 오른쪽 정렬이 됩니다.

가로줄

빈 줄 다음에 ---만 적으면 구분선이 됩니다.

마크다운을 다른 형식으로 바꾸기

마크다운으로 쓴 문서는 필요에 따라 다양한 형식으로 바꿀 수 있습니다.

하고 싶은 일 변환기
웹 페이지로 보기·공유 마크다운 → HTML
워드 문서로 제출 마크다운 → DOCX
전자책으로 읽기·배포 마크다운 → EPUB
기호 없이 글만 남기기 마크다운 → TXT

예를 들어 강의 노트를 마크다운으로 정리한 뒤 EPUB으로 바꾸면, # 제목을 기준으로 장이 나뉜 전자책이 됩니다.

자주 하는 실수

  • #제목처럼 # 뒤에 띄어쓰기를 빼먹으면 제목이 되지 않습니다.
  • 목록 앞에 빈 줄이 없으면 앞 문단에 붙어 버리는 경우가 있습니다.
  • 표의 각 줄은 칸 수가 같아야 제대로 보입니다.

정리

# 제목, ** 굵게, - 목록, []() 링크, 이 네 가지만 알아도 대부분의 문서를 쓸 수 있습니다. 워드 문서를 마크다운으로 옮기고 싶다면 워드 문서를 마크다운으로 바꾸기를 참고하세요.

이 가이드에서 쓰는 도구

관련 가이드