마크다운 치트시트

단계 1 / 3 33%

Markdown 주제 선택

예제 한 그룹부터 살펴본 뒤 전체 참고표를 여세요.

핵심 Markdown 구문을 주제별로 정리하고, 복사 가능한 원본과 실제 파서의 결과를 나란히 보여줍니다. CommonMark 기본 기능(제목, 목록, 강조, 링크, 이미지, 펜스 코드)과 GitHub Flavored Markdown 확장 기능(표, 작업 목록, 취소선, 일반 URL 자동 링크)을 다룹니다. GitHub, GitLab, Obsidian, 정적 사이트 생성기를 사용할 때 가까이 두고 참고하세요.

치트시트 사용 방법

  1. 1

    범주별로 살펴보기

    제목, 목록, 코드, 링크, 표 또는 GFM 확장 기능으로 이동합니다.

  2. 2

    원본과 결과 비교하기

    각 예제는 원본 Markdown과 실제 GFM 파서의 출력을 나란히 표시합니다.

  3. 3

    스니펫 복사하기

    복사를 탭하면 어떤 예제든 원본을 가져올 수 있습니다.

  4. 4

    구문 라벨 확인

    각 예제에는 CommonMark 또는 GitHub Flavored Markdown(GFM) 라벨이 표시됩니다.

제목

# H1 제목
## H2 섹션
### H3 하위 섹션

텍스트 아래에 ===를 넣는 Setext 대신 ATX 스타일(#)을 사용하세요. 모든 파서가 두 방식을 지원하지만, ATX 형식이 diff에서 더 읽기 쉽습니다.

강조

*기울임* 또는 _기울임_, **굵게** 또는 __굵게__, ***굵은 기울임***. GFM은 ~~취소선~~을 추가합니다.

목록

순서 없는 목록에는 -, *, + 중 하나를 사용합니다(하나를 골라 일관되게 사용하세요):

- 첫째
- 둘째
  - 중첩 (공백 두 칸)

순서 있는 목록은 자동으로 번호가 다시 매겨집니다:

1. 항목
1. 항목
1. 항목

코드

인라인: `code`. 언어 태그를 선택적으로 붙일 수 있는 펜스 블록:

```python
def hello(name):
    return f"안녕하세요, {name}"
```

예전 문법을 선호한다면 코드 블록을 공백 네 칸으로 들여쓰기 하세요.

링크와 이미지

[링크 텍스트](https://example.com)
[제목이 있는 링크](https://example.com "툴팁")
![대체 텍스트](/path/to/image.png)

참조 스타일을 쓰면 긴 URL을 본문 밖으로 뺄 수 있습니다:

[문서][1]를 참고하세요.

[1]: https://example.com/docs

표 (GFM)

| Col A | Col B |
|-------|------:|
| a     |     1 |
| b     |    22 |

정렬은 구분 행의 콜론으로 지정합니다: :---는 왼쪽, :---:는 가운데, ---:는 오른쪽 정렬입니다.

작업 목록 (GFM)

- [x] 완료
- [ ] 할 일

흔한 함정

  • 줄 끝 공백 두 칸은 단락 안에 줄바꿈을 넣습니다. 공백 한 칸은 두 줄을 이어 붙일 뿐입니다.
  • 대부분의 블록 요소(제목, 목록, 코드 블록) 앞에는 빈 줄이 필요합니다.
  • 렌더러가 공백을 기대한다면 목록 마커를 탭으로 들여쓰기 하지 마세요. 공백 두 칸 또는 네 칸으로 들여쓰기 하세요.
  • 문자 그대로의 문장 부호를 표시하려면 백슬래시로 이스케이프하세요: \*기울임 아님\*.
  • 스마트 따옴표는 렌더러마다 다릅니다. GitHub은 그대로 두고, Pandoc은 변환합니다.

자주 묻는 질문

CommonMark는 제목, 목록, 링크, 선택적 정보 문자열을 사용할 수 있는 펜스 코드 등 이식성 높은 핵심 구문을 정의합니다. GFM은 표, 작업 목록, 취소선, 일반 URL 자동 링크를 추가합니다. 다른 편집기는 일부만 지원하거나 자체 확장 기능을 더할 수 있습니다.

마크다운은 단일 줄바꿈을 공백으로 취급합니다. <br>를 넣으려면 줄 끝에 공백 두 칸을 붙이거나, GFM에서는 줄 끝에 \를 사용하세요.

대부분의 파서에서 가능하며, 블록 수준 HTML 태그는 그대로 통과됩니다. 일부 렌더러는 이를 정화합니다(GitHub은 인라인 스크립트와 이벤트 속성을 제거합니다).

CommonMark에는 내장 목차 문법이 없습니다. GitHub은 제목 앵커를 만들고 제목이 여러 개인 파일에 개요를 표시합니다. 다른 플랫폼은 자체 규칙을 사용합니다. MkDocs는 관련 확장을 켜면 [TOC]를 사용할 수 있고, Docusaurus는 제목으로 페이지 목차를 만듭니다.

CommonMark와 GFM 규칙은 사용할 수 있습니다. 다만 Obsidian은 위키링크([[페이지 이름]]), 콜아웃, 임베드 블록 등 Obsidian 전용 기능을 추가하며, 이러한 요소는 이 치트시트에 포함되어 있지 않습니다.

관련 도구