Softonic

마크다운 치트시트

단계 1 / 3 33%

Markdown 주제 선택

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

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 전용 기능을 추가하며, 이러한 요소는 이 치트시트에 포함되어 있지 않습니다.

관련 도구

ASCII 표 참조

NUL, LF, DEL 같은 제어 문자를 포함해 모든 문자에 대한 10진수, 16진수, 8진수, 2진수, HTML 숫자 문자 참조를 담은 0부터 127까지의 전체 ASCII 표.

HTML 문자 참조

HTML 엔티티의 검색 가능한 목록, 각 엔티티의 이름 및 숫자 코드, 그리고 특수 문자 및 기호에 대한 1클릭 복사 기능을 제공합니다.

FPS 카운터

requestAnimationFrame으로 브라우저 FPS를 측정하세요. 스무딩, 최소/최대 프레임레이트, 경고 임계값, 선택형 그래프를 제공합니다. 업로드나 API 없이 로컬에서 실행됩니다.

키보드 단축키 참고표

macOS, Windows, Linux에서 VS Code, Chrome, GNU Readline을 쓰는 Bash의 문서화된 기본 단축키를 검색합니다.

색상 혼합기

두 HEX 색상을 2-20개의 균등한 색상 견본으로 섞습니다. 양 끝 색상을 포함해 각 중간 색상을 대문자 HEX 코드로 확인하세요.

색상 틴트 생성기

기준 색의 밝은 틴트를 생성합니다. 디자인 시스템 토큰, 배경, 호버 상태를 위한 3-20단계 스케일.

이 도구는 다른 언어로도 제공됩니다