마크다운 문법: 완벽 가이드

2026년 3월 31일 · 12분 읽기

마크다운 문법 이해하기

마크다운은 일반 텍스트 편집기에서 서식이 있는 텍스트를 작성하는 사실상의 표준이 되었습니다. 2004년 존 그루버가 만든 이 경량 마크업 언어는 간단한 철학으로 설계되었습니다: 무엇보다 가독성을 우선시합니다. HTML이나 다른 마크업 언어와 달리, 마크다운 문서는 원본 형태에서도 읽기 쉽습니다.

마크다운의 아름다움은 단순함에 있습니다. 잘 서식된 문서를 만들기 위해 전문 소프트웨어나 복잡한 문법이 필요하지 않습니다. 기본 텍스트 편집기만 있으면 작성을 시작할 수 있습니다. 이러한 접근성 덕분에 마크다운은 전 세계 개발자, 기술 작가, 블로거, 콘텐츠 제작자들이 선호하는 선택이 되었습니다.

마크다운은 현대 플랫폼 전반에 걸쳐 널리 사용됩니다. GitHub는 README 파일과 이슈 토론에 사용합니다. Reddit은 댓글 서식에 마크다운을 사용합니다. Jekyll, Hugo, Gatsby와 같은 정적 사이트 생성기는 콘텐츠 관리를 위해 마크다운에 의존합니다. 문서화 플랫폼, 노트 작성 앱, 콘텐츠 관리 시스템 모두 마크다운을 주요 서식 언어로 채택했습니다.

마크다운의 핵심 원칙은 서식이 직관적이어야 한다는 것입니다. 텍스트를 강조하고 싶을 때는 별표로 둘러싸고, 제목을 원할 때는 해시 기호를 앞에 붙입니다. 이러한 규칙은 사람들이 일반 텍스트 이메일과 문서를 자연스럽게 서식하는 방식을 반영하여 학습 곡선을 매우 완만하게 만듭니다.

기본 서식 기법

기본 마크다운 서식을 마스터하는 것은 전문적인 문서를 만드는 기초입니다. 이러한 기본 기법은 간단한 텍스트 강조부터 제목과 단락 같은 구조적 요소까지 일상적인 서식 요구의 90%를 다룹니다.

텍스트 강조와 인라인 스타일

마크다운의 텍스트 강조는 목적을 시각적으로 암시하는 직관적인 기호를 사용합니다. 굵은 텍스트는 이중 별표 또는 밑줄을 사용합니다: **굵은 텍스트** 또는 __굵은 텍스트__ 모두 굵은 텍스트로 렌더링됩니다. 이중 기호는 원본 텍스트에서도 시각적 무게감을 만듭니다.

기울임 텍스트는 단일 별표 또는 밑줄을 사용합니다: *기울임 텍스트* 또는 _기울임 텍스트_는 기울임 텍스트를 생성합니다. 기울임체는 강조, 책 제목, 외국어 구문 또는 미묘한 강조가 필요한 기술 용어에 완벽하게 작동합니다.

취소선 텍스트는 이중 물결표를 사용합니다: ~~삭제된 텍스트~~는 삭제된 텍스트를 만듭니다. 이 서식은 편집 내용 표시, 더 이상 사용되지 않는 기능 또는 대체되었지만 맥락상 관련성이 있는 콘텐츠를 보여주는 데 매우 유용합니다.

인라인 코드 스니펫은 백틱을 사용합니다: `let x = 5;`는 let x = 5;로 렌더링됩니다. 이 고정폭 서식은 코드를 일반 텍스트와 구분하여 기술 문서를 더 명확하고 스캔하기 쉽게 만듭니다.

문서 구조를 위한 제목

제목은 계층 구조를 만들고 문서 탐색을 개선합니다. 마크다운은 해시 기호(#)를 사용하여 제목 수준을 나타내며, 해시가 많을수록 하위 수준 제목을 나타냅니다:

# 제목 1 (H1)
## 제목 2 (H2)
### 제목 3 (H3)
#### 제목 4 (H4)
##### 제목 5 (H5)
###### 제목 6 (H6)

각 제목 수준은 문서 구조에서 특정 목적을 제공합니다. H1은 일반적으로 문서 제목을 나타내며 한 번만 나타나야 합니다. H2는 주요 섹션을 표시하고, H3부터 H6까지는 중요도가 감소하는 하위 섹션을 만듭니다.

적절한 제목 계층 구조는 스크린 리더의 접근성을 개선하고 검색 엔진이 콘텐츠 구조를 이해하는 데 도움이 됩니다. 항상 논리적 진행을 유지하세요—중간 수준 없이 H2에서 H5로 건너뛰지 마세요.

단락과 줄 바꿈

마크다운의 단락은 빈 줄로 구분됩니다. 텍스트 블록 사이에 빈 줄을 남기기만 하면 별개의 단락이 만들어집니다. 이러한 자연스러운 간격은 원본 마크다운 파일을 매우 읽기 쉽게 만듭니다.

단락 내에서 줄 바꿈(새 단락을 만들지 않고)을 하려면 줄 끝에 공백 두 개를 추가하고 Enter를 누르세요. 또는 명시적인 줄 바꿈을 위해 HTML <br> 태그를 사용하세요. 이 구분은 텍스트 흐름을 정밀하게 제어해야 할 때 중요합니다.

목록으로 콘텐츠 구성하기

목록은 밀집된 정보를 스캔 가능하고 소화하기 쉬운 덩어리로 변환합니다. 마크다운은 순서 없는(글머리 기호) 목록과 순서 있는(번호 매기기) 목록, 그리고 두 유형의 중첩 조합을 모두 지원합니다.

순서 없는 목록

별표(*), 더하기 기호(+) 또는 하이픈(-)을 글머리 기호 표시로 사용하여 순서 없는 목록을 만듭니다. 세 가지 모두 동일한 결과를 생성하므로 개인 선호도나 프로젝트 규칙에 따라 선택하세요:

* 첫 번째 항목
* 두 번째 항목
* 세 번째 항목
  * 중첩된 항목
  * 또 다른 중첩된 항목
* 네 번째 항목

중첩된 목록은 일관된 들여쓰기가 필요합니다—일반적으로 공백 두 개 또는 네 개입니다. 들여쓰기 수준이 중첩 깊이를 결정하여 복잡한 계층 구조를 만들 수 있습니다.

순서 있는 목록

순서 있는 목록은 마침표가 뒤따르는 숫자를 사용합니다. 흥미롭게도 마크다운은 순차적 번호 매기기를 요구하지 않습니다—렌더링된 출력에서 자동으로 항목 번호를 다시 매깁니다:

1. 첫 번째 단계
2. 두 번째 단계
3. 세 번째 단계
   1. 하위 단계 A
   2. 하위 단계 B
4. 네 번째 단계

이 자동 번호 매기기 기능은 초안 작성 중 모든 항목에 1.을 사용할 수 있음을 의미하며, 수동으로 번호를 다시 매기지 않고도 항목을 쉽게 재정렬할 수 있습니다. 렌더링된 출력은 올바른 순차 번호를 표시합니다.

목록 모범 사례

목록 항목을 간결하고 구조적으로 평행하게 유지하세요. 한 항목이 완전한 문장이면 모든 항목을 완전한 문장으로 만드세요. 항목이 단편이면 모두 단편으로 유지하세요. 이러한 일관성은 가독성과 전문성을 향상시킵니다.

긴 단락을 나누기 위해 전략적으로 목록을 사용하세요. 단락 형식으로 "첫째," "둘째," "셋째"를 쓰고 있다면, 그것은 콘텐츠를 목록으로 변환하라는 신호입니다. 독자들은 향상된 스캔 가능성에 감사할 것입니다.

링크와 이미지 삽입하기

링크와 이미지는 콘텐츠를 외부 리소스 및 시각적 요소와 연결합니다. 마크다운은 인라인 및 참조 스타일 링크 모두에 대해 깔끔하고 읽기 쉬운 구문을 제공합니다.

하이퍼링크 만들기

인라인 링크는 링크 텍스트에 대괄호를, URL에 괄호를 사용합니다: [링크 텍스트](https://example.com). 이 형식은 링크와 대상을 함께 유지하여 편집하는 동안 무엇을 링크하는지 쉽게 볼 수 있습니다.

마우스를 올렸을 때 나타나는 선택적 제목 텍스트를 추가하세요: [링크 텍스트](https://example.com "호버 제목"). 제목 텍스트는 추가 컨텍스트를 제공하고 보조 기술에 의존하는 사용자의 접근성을 향상시킵니다.

참조 스타일 링크는 링크 텍스트와 URL을 분리하여 긴 문서의 가독성을 향상시킵니다:

[링크 텍스트][참조-id]

[참조-id]: https://example.com "선택적 제목"

이 접근 방식은 동일한 URL을 여러 번 참조할 때 빛을 발합니다. 문서 하단에 URL을 한 번 정의한 다음 전체에서 참조하세요. 업데이트가 간단해집니다—전체 문서를 검색하는 대신 한 줄만 변경하면 됩니다.

이미지 삽입하기

이미지 구문은 느낌표 접두사가 있는 링크 구문을 반영합니다: ![대체 텍스트](image-url.jpg). 대체 텍스트는 접근성과 SEO에 중요합니다—이미지를 볼 수 없는 사용자를 위해 이미지가 보여주는 것을 설명하세요.

호버 툴팁을 위한 선택적 제목 텍스트를 포함하세요: ![대체 텍스트](image-url.jpg "이미지 제목"). 이 추가 컨텍스트는 사용자가 클릭하기 전이나 이미지 로드에 실패했을 때 이미지의 관련성을 이해하는 데 도움이 됩니다.

참조 스타일 이미지는 참조 스타일 링크와 동일하게 작동합니다:

![대체 텍스트][이미지-참조]

[이미지-참조]: /path/to/image.jpg "선택적 제목"

내부 섹션에 링크하기

제목 ID를 사용하여 문서 내 제목에 대한 앵커 링크를 만드세요. 대부분의 마크다운 프로세서는 제목 텍스트에서 자동으로 ID를 생성합니다: [섹션으로 이동](#section-heading). ID는 일반적으로 제목 텍스트를 소문자로 변환하고 공백을 하이픈으로 바꿉니다.

내부 링크는 긴 문서의 탐색을 개선하여 독자가 관련 섹션으로 직접 이동할 수 있게 합니다. 이 기법은 특히 문서, 튜토리얼 및 종합 가이드에서 잘 작동합니다.

고급 마크다운 서식

기본 서식을 넘어 마크다운은 기술 작성, 코드 문서화 및 복잡한 콘텐츠 구조를 위한 강력한 기능을 제공합니다. 이러한 고급 기법은 문서를 단순한 텍스트에서 전문가급 문서로 끌어올립니다.

코드 블록과 구문 강조

펜스 코드 블록은 삼중 백틱을 사용하여 여러 줄 코드 섹션을 만듭니다. 구문 강조를 위해 여는 백틱 바로 뒤에 프로그래밍 언어를 지정하세요:

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}
```

구문 강조는 키워드, 문자열, 주석 및 기타 언어 요소를 색상화하여 코드 가독성을 극적으로 향상시킵니다. 대부분의 마크다운 프로세서는 Python과 JavaScript부터 SQL과 YAML까지 수십 개의 언어를 지원합니다.

들여쓰기 코드 블록은 대체 구문을 제공합니다—모든 줄을 공백 네 개 또는 탭 하나로 들여쓰세요. 이 방법은 보편적으로 작동하지만 구문 강조 기능이 없습니다:

    function example() {
        console.log("들여쓰기 코드 블록");
    }

수평선

한 줄에 하이픈, 별표 또는 밑줄을 세 개 이상 사용하여 시각적 구분선을 만드세요:

---
***
___

수평선은 콘텐츠를 별개의 섹션으로 나누어 긴 문서에 시각적 여유 공간을 제공합니다. 드물게 사용하세요—너무 많은 구분선은 콘텐츠를 조각내고 응집력을 감소시킵니다.

특수 문자 이스케이프

백슬래시는 마크다운 특수 문자를 이스케이프하여 서식 대신 문자 그대로 표시합니다: \*기울임 아님\*은 기울임 아님 대신 *기울임 아님*으로 렌더링됩니다.

이스케이프가 필요한 일반적인 문자는 다음과 같습니다: \ ` * _ { } [ ] ( ) # + - . !. 이 기법은 마크다운 구문 자체를 논의하거나 기술 콘텐츠에 특수 문자가 나타날 때 필수적입니다.

인용구와 작업 목록 활용하기

인용구와 작업 목록은 콘텐츠에 의미론적 의미를 추가합니다. 인용구는 인용문이나 중요한 콜아웃을 강조하고, 작업 목록은 진행 상황과 작업 항목을 추적합니다.

강조를 위한 인용구

줄 시작 부분에 큰따옴표 기호(>)를 사용하여 인용구를 만드세요:

> 이것은 인용구입니다.
> 여러 줄에 걸쳐 있을 수 있습니다.
>
> 그리고 여러 단락을 포함할 수 있습니다.

중첩된 인용구는 여러 > 기호를 사용합니다:

> 첫 번째 수준 인용
>> 중첩된 인용
>>> 깊게 중첩된 인용

인용구는 발췌 인용, 추천사, 중요한 경고 또는 핵심 요점 강조에 아름답게 작동합니다. 독자의 시선을 중요한 정보로 끌어들이는 시각적 구분을 만듭니다.

프로젝트 관리를 위한 작업 목록

작업 목록은 목록 구문과 체크박스 표기법을 결합합니다. 체크되지 않은 항목에는 - [ ]를, 완료된 항목에는 - [x]를 사용하세요:

- [x] 완료된 작업
- [ ] 대기 중인 작업
- [ ] 또 다른 대기 중인 작업
  - [x] 완료된 하위 작업
  - [ ] 대기 중인 하위 작업

작업 목록은 프로젝트 문서, 회의록 및 이슈 추적에서 빛을 발합니다. GitHub와 같은 많은 플랫폼은 이를 대화형 체크박스로 렌더링하여 사용자가 렌더링된 보기에서 직접 항목을 체크할 수 있습니다.