Markdown 문법 가이드: 예제가 포함된 전체 참조

Markdown 문법 가이드

Markdown은 일반 텍스트를 서식 있는 HTML로 변환하는 가벼운 마크업 언어입니다. 2004년 John Gruber가 만든 이후, 웹 전반에서 문서, README 파일, 기술 콘텐츠의 표준 작성 형식이 되었습니다.

제목

# 기호를 사용합니다. 최상위에는 # 하나, 최대 여섯 개까지 사용할 수 있습니다:

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

단계는 하나씩 증가해야 합니다 — ##에서 ####로 건너뛰면 스크린 리더에 혼란을 줄 수 있습니다.

텍스트 서식

**Bold text** or __Bold text__
*Italic text* or _Italic text_
**_Bold and italic_**
~~Strikethrough text~~

링크

[Link text](https://example.com)
[Link with title](https://example.com "Title")
[Reference-style][ref-id]
[ref-id]: https://example.com
<contact@example.com>

이미지

![Alt text](/path/to/image.jpg)
[![Alt text](/path/to/image.jpg)](https://example.com)

대체 텍스트는 접근성과 SEO에 매우 중요합니다 — 이미지 로드에 실패했을 때 표시됩니다.

목록

순서 없는 목록은 -, *, +를 사용합니다. 순서 있는 목록은 숫자를 사용합니다:

- Item one         1. First item
- Item two         2. Second item
  - Nested item       1. Nested item

코드

인라인 코드는 단일 백틱을 사용합니다: `printf()`.

코드 블록은 선택적 언어 식별자와 함께 삼중 백틱을 사용합니다:

```python
def greet(name):
    return f"Hello, {name}!"

지원되는 언어: `javascript`, `python`, `html`, `css`, `json`, `bash`, `sql`, `yaml`.

## 인용문

```markdown
> This is a blockquote.
> > Nested blockquotes are supported.

콜아웃, 노트, 외부 출처 인용에 주로 사용됩니다.

수평선

한 줄에 대시, 별표, 또는 밑줄 세 개 이상:

---
***
___

테이블

파이프와 대시로 열을 정의합니다. 콜론으로 정렬을 제어합니다:

| Left | Center | Right |
| :--- | :----: | ----: |
| A1   | B1     | C1    |

GitHub Flavored Markdown 확장

GitHub Flavored Markdown(GFM)은 유용한 기능을 추가합니다:

- [x] Completed task     # Task lists
- [ ] Incomplete task

:smile: :rocket: :warning:    # Emoji shortcodes

~~Strikethrough text~~        # Strikethrough

GFM은 또한 URL을 자동 링크합니다 — www.example.com을 < >로 감싸지 않아도 클릭 가능해집니다.

특수 문자 이스케이프

리터럴 Markdown 문자를 표시하려면 \를 접두사로 붙입니다:

\*This is not italic\*
\# This is not a heading

이스케이프가 필요한 문자: \ ` * _ { } [ ] ( ) # + - . ! | ~.

Markdown 온라인 미리보기

Markdown 미리보기 도구를 사용하여 실시간으로 Markdown을 작성하고 미리보기하세요. 입력하는 대로 실시간 미리보기가 업데이트되어 제목, 링크, 이미지, 코드 블록, 테이블이 어떻게 렌더링되는지 정확히 보여줍니다.