마크다운 문법 모음: 제목·목록·표·코드 예제

작업 순서

1. 1

   필요한 문법 찾기

   목차에서 제목, 목록, 표, 코드처럼 지금 필요한 표현으로 이동하세요. 회색 예제 상자의 텍스트는 결과 화면이 아니라 입력할 마크다운 원문입니다.

2. 2

   소스 보기에 붙여 넣기

   새 문서를 만들고 소스 보기에서 예제를 입력합니다. WYSIWYG 화면에 붙여 넣는 동작과 소스에 입력하는 동작은 같지 않을 수 있으므로, 문법을 확인할 때는 소스 보기를 사용하세요.

3. 3

   결과와 원문 비교하기

   체크리스트는 아래의 변환 제한부터 읽으세요. 다른 예제는 WYSIWYG 모드로 바꾸거나 넓은 화면의 분할 보기에서 결과를 확인하세요. 기호가 그대로 보인다면 기호 뒤 공백, 문단 사이 빈 줄, 코드 블록의 닫는 기호부터 점검합니다.

4. 4

   사용할 곳에서 다시 확인

   완성한 문서는 마크다운 (.md)으로 내보내고 사용할 서비스에서 다시 열어 보세요. 체크리스트·표·줄바꿈 등은 서비스마다 지원 범위가 다릅니다.

제목과 문단

# 문서 제목

## 큰 주제

첫 번째 문단입니다.

### 세부 주제

두 번째 문단입니다.

# 뒤에는 공백을 넣습니다. #부터 ######까지 제목 단계가 있으며, 단계는 글자 크기보다 문서 구조에 맞춰 고르세요. 문단을 나누려면 빈 줄을 넣습니다.

MDView는 소스의 일반 줄바꿈도 줄바꿈으로 표시합니다. 다른 마크다운 도구에서는 같은 문단으로 이어질 수 있으므로, 문단 구분에는 빈 줄을 사용하는 편이 명확합니다.

굵게·기울임·취소선

**중요한 내용**

*기울임 표시*

~~수정 전 내용~~

기호는 강조할 글자의 양쪽에 붙여 씁니다. 굵게는 별표 두 개, 기울임은 한 개를 사용합니다. 취소선은 물결표 두 개를 쓰며, 기본 마크다운만 지원하는 도구에서는 표시되지 않을 수 있습니다.

목록과 체크리스트

- 첫 번째 항목
- 두 번째 항목

1. 초안 작성
2. 검토 요청

- [ ] 아직 할 일
- [x] 끝낸 일

목록 기호와 내용 사이에는 공백을 넣습니다. 체크리스트는 대괄호 안의 공백이 미완료, x가 완료를 뜻합니다. 목록 종류를 바꿀 때는 빈 줄로 구분하세요.

주의: MDView의 현재 소스 → WYSIWYG 변환에서는 체크리스트가 일반 목록으로 해석되어 체크 상태가 빠질 수 있습니다. 체크 상태가 중요한 문서는 소스 보기를 유지하고, WYSIWYG에서 수정하기 전에 원문 .md를 내려받아 보관하세요.

링크

[MDView 사용 가이드](/guides)

대괄호 안에는 읽을 이름을, 소괄호 안에는 주소를 넣습니다. /guides처럼 /로 시작하는 주소는 현재 사이트 안의 링크입니다. 다른 서비스로 옮길 문서라면 그 서비스에 맞는 주소인지 확인하세요.

링크 문구는 “여기”보다 목적지가 드러나는 이름을 쓰면 읽고 찾기 쉽습니다. 공개할 문서에 비공개 주소나 접근 토큰이 들어 있지 않은지도 확인하세요.

인용문과 구분선

> 검토할 핵심 내용을 인용합니다.
> 같은 인용문의 다음 줄입니다.

---

새로운 주제를 시작합니다.

인용할 줄 앞에 >와 공백을 넣습니다. 구분선은 ---를 별도 줄에 쓰고 앞뒤를 빈 줄로 띄우세요. 바로 앞 문장과 붙이면 제목 문법으로 해석될 수 있습니다.

인라인 코드와 코드 블록

명령어는 `npm test`처럼 표시합니다.

```javascript
const message = "안녕하세요";
console.log(message);
```

짧은 코드에는 백틱 한 개를 양쪽에 사용합니다. 여러 줄 코드는 백틱 세 개로 시작하고 끝냅니다. 시작 줄 뒤의 javascript 같은 언어 이름은 코드 종류를 나타내며, 실제 색상 표시는 도구와 보기 모드에 따라 다를 수 있습니다.

문서 전체가 코드처럼 보이면 닫는 백틱 세 개가 빠졌는지 확인하세요. 코드 예제는 보여 주기 위한 텍스트이며 이 가이드가 명령을 실행하지는 않습니다.

표와 세로줄

| 작업 | 담당 |
| --- | --- |
| 초안 | 작성자 |
| 검토 | 검토자 |
| 기호 | A \| B |

첫 줄은 머리글, 둘째 줄은 ---로 이루어진 구분 행입니다. 각 행의 열 개수를 맞추세요. 셀 안에 | 기호를 쓰려면 \|처럼 앞에 백슬래시를 붙입니다.

단순한 행과 열에 적합한 문법입니다. 셀 병합이나 복잡한 배치가 그대로 유지된다고 가정하지 말고, 변환하거나 다른 서비스에 게시한 결과를 확인하세요.

기호를 문자 그대로 쓰기

\# 제목이 아닌 문장

\*별표를 그대로 표시\*

1\. 목록이 아닌 번호

마크다운 기호 앞에 백슬래시를 붙이면 서식 대신 문자로 표시할 수 있습니다. 코드나 명령어처럼 기호가 많은 짧은 문자열은 인라인 코드로 감싸는 편이 편리합니다.

자주 묻는 질문