마크다운 미리보기

기본 문법

마크다운은 읽기 쉬운 평문으로 서식을 표현하는 방식입니다. 깃허브 README, 노션, 디스코드, 각종 정적 사이트 생성기가 씁니다.

# 제목 1
## 제목 2

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

- 목록
- 항목
  - 중첩 (공백 2칸 들여쓰기)

1. 번호 목록
2. 두 번째

> 인용문

[링크](https://so-yi.com)
![이미지](경로.png)

---  (수평선)

줄바꿈이 반영되지 않는 이유

표준 마크다운에서는 한 번의 줄바꿈이 무시됩니다. 그냥 공백으로 취급되어 앞 줄에 이어 붙습니다.

문단을 나누려면 빈 줄을 하나 넣어야 합니다.

같은 문단 안에서 줄만 바꾸고 싶다면 방법이 셋입니다.

1. 줄 끝에 공백 두 개를 넣습니다 (전통적이지만 눈에 보이지 않아 실수하기 쉽습니다)
2. 줄 끝에 역슬래시를 붙입니다
3. <br> 태그를 씁니다

깃허브는 코멘트와 이슈에서 줄바꿈을 그대로 반영합니다. 이 도구도 같은 동작(GFM breaks)을 씁니다. 다만 순수 마크다운 파서를 쓰는 환경에서는 다르게 보일 수 있습니다.

GitHub Flavored Markdown

깃허브가 확장한 문법으로, 사실상 표준이 되었습니다.

표

| 항목 | 값 |
|---|---|
| 이름 | 소이툴즈 |

|:---|처럼 콜론을 넣어 정렬을 지정할 수 있습니다. 왼쪽에 콜론이면 왼쪽 정렬, 양쪽이면 가운데, 오른쪽이면 오른쪽입니다.

체크리스트

- [x] 끝난 일
- [ ] 남은 일

코드 블록

백틱 세 개로 감싸고 언어를 지정하면 문법 강조가 적용됩니다.

```js
const sum = (a, b) => a + b;
```

목록이 깨질 때

가장 흔한 원인은 들여쓰기 칸 수입니다. 중첩 목록은 보통 공백 2칸 또는 4칸으로 들여쓰는데, 파서마다 요구가 조금씩 다릅니다. 한 문서 안에서 일관되게 쓰는 것이 중요합니다.

번호 목록에서 번호가 1부터 다시 시작하는 경우도 있습니다. 마크다운은 실제 숫자를 무시하고 순서대로 다시 매기기 때문입니다. 그래서 1. 1. 1.이라고 써도 1, 2, 3으로 렌더링됩니다.

목록과 코드 블록을 섞을 때는 코드 블록도 목록 수준에 맞춰 들여써야 합니다.

특수문자를 그대로 쓰려면

*, _, #, `, [, ] 같은 문자를 서식이 아니라 글자 그대로 쓰려면 앞에 역슬래시를 붙입니다.

\*별표 그대로\*

_는 특히 주의해야 합니다. snake_case_이름 같은 문자열에서 언더스코어가 기울임으로 해석될 수 있습니다. 이럴 때는 인라인 코드로 감싸는 것이 간편합니다.

HTML은 어디까지 되나요

마크다운은 HTML을 그대로 쓸 수 있게 허용합니다. 표의 셀 병합처럼 마크다운 문법으로 표현할 수 없는 것을 넣을 때 유용합니다.

다만 게시 환경에 따라 제한됩니다. 깃허브는 보안상 script, style, iframe 등을 제거합니다.

이 도구도 렌더링 전에 위험한 태그와 이벤트 속성(onclick 등)을 제거합니다. 남이 보낸 문서를 확인할 때도 안전하게 쓸 수 있습니다.

어디에 쓰면 좋은가

README와 기술 문서 — 깃허브에서 그대로 렌더링됩니다.

블로그 원고 — 대부분의 정적 사이트 생성기가 마크다운을 입력으로 받습니다. 이 사이트의 해설 문서도 마크다운으로 작성되어 있습니다.

회의록과 메모 — 평문이라 어디서든 열리고, 나중에 다른 형식으로 변환하기 쉽습니다.

AI 도구와의 대화 — 대부분의 챗봇이 마크다운으로 응답합니다. 문법을 알면 결과를 다른 곳에 옮기기 편합니다.

함께 확인하면 좋은 것

글자수를 세려면 글자수 세기를, 두 원고를 비교하려면 텍스트 비교를 이용하세요.