Markdown 확장 문법

기본 Markdown 문법은 문서 작성에 필요한 핵심 요소를 제공하지만, 때로는 특정 요구사항에 충분하지 않습니다. 바로 이때 확장 문법이 필요합니다.

확장 문법은 기본 문법 위에 추가 기능을 제공하여 더 풍부하고 복잡한 문서를 작성할 수 있게 해줍니다.

확장 문법이란?

확장 문법은 원래 Markdown 명세를 넘어서는 문법 요소를 의미합니다. 이러한 확장 기능은 다양한 Markdown 프로세서에서 추가 기능을 지원하기 위해 추가됩니다.

일반적인 확장 문법

• 표 – 데이터 테이블 생성
• 펜스 코드 블록 – 구문 강조가 있는 코드 블록
• 각주 – 각주 참조 추가
• 제목 ID – 제목에 사용자 정의 ID 추가
• 정의 목록 – 용어와 정의 목록
• 취소선 – 텍스트에 취소선 표시
• 작업 목록 – 체크박스가 있는 체크리스트
• 이모지 – 이모지 기호
• 강조 – 텍스트 강조
• 위첨자와 아래첨자 – 수학 공식에서 일반적

지원

모든 Markdown 애플리케이션이 확장 문법을 지원하지는 않습니다. 사용하기 전에 사용하려는 Markdown 프로세서가 원하는 확장 기능을 지원하는지 확인하세요.

주류 지원

다음 플랫폼과 도구들이 확장 문법을 잘 지원합니다:

• GitHub Flavored Markdown (GFM) – GitHub의 Markdown 확장
• GitLab Flavored Markdown – GitLab의 확장
• Typora – 리치 텍스트 Markdown 에디터
• Obsidian – 지식 관리 도구
• VitePress – 정적 사이트 생성기
• Hugo – 정적 사이트 생성기

표

표 생성은 가장 일반적인 확장 기능 중 하나입니다:

| 이름  | 나이 | 직업 |
|-------|-----|-----------|
| 장    | 25  | 엔지니어  |
| 이    | 30  | 디자이너  |

이름	나이	직업
장	25	엔지니어
이	30	디자이너

펜스 코드 블록

구문 강조가 있는 코드 블록:

```javascript
function hello() {
    console.log("Hello, World!");
}
```

function hello() {
    console.log("Hello, World!");
}

작업 목록

할 일 목록 생성:

- [x] 프로젝트 계획 완료
- [ ] 코드 작성
- [ ] 기능 테스트
- [ ] 온라인 배포

• [x] 프로젝트 계획 완료
• [ ] 코드 작성
• [ ] 기능 테스트
• [ ] 온라인 배포

취소선

삭제되거나 잘못된 내용 표시:

~~이 텍스트에는 취소선이 있습니다~~

이 텍스트에는 취소선이 있습니다

자동 링크

URL과 이메일 주소를 자동으로 인식:

더 많은 정보를 위해 https://markdown.com.cn을 방문하세요.
연락처: example@domain.com

더 많은 정보를 위해 https://markdown.com.cn을 방문하세요. 연락처: example@domain.com

각주

문서에 메모와 참조 추가:

여기에 각주 예시가 있습니다[^1].

[^1]: 이것은 각주의 내용입니다.

여기에 각주 예시가 있습니다[^1].

[^1]: 이것은 각주의 내용입니다.

정의 목록

용어와 정의 목록 생성:

Markdown
:   경량 마크업 언어

HTML
:   HyperText Markup Language
:   웹 페이지를 만들기 위한 표준 마크업 언어

수학 공식

LaTeX 스타일 수학 공식 지원:

인라인 공식: $E = mc^2$

블록 공식:
$$
\sum_{i=1}^n a_i = 0
$$

차트와 다이어그램

일부 고급 에디터는 Mermaid 다이어그램을 지원합니다:

```mermaid
graph TD
    A[시작] --> B{이해했나요?}
    B -->|예| C[학습 계속]
    B -->|아니오| D[다시 읽기]
    D --> B
    C --> E[끝]
```

확장 문법 학습 경로

다음 순서로 확장 문법을 학습하는 것을 권장합니다:

1. 표 – 가장 일반적이고 실용적
2. 펜스 코드 블록 – 프로그래머에게 필수
3. 작업 목록 – 프로젝트 관리에 유용
4. 취소선 – 간단하고 사용하기 쉬움
5. 각주 – 학술 작성에 필요
6. 정의 목록 – 용어 설명용
7. 제목 ID – 고급 링킹
8. 강조 – 핵심 포인트 강조

호환성 참고사항

확장 문법을 사용할 때:

• 호환성 테스트 – 대상 플랫폼에서 Markdown 테스트
• 대안 제공 – 확장 기능을 지원하지 않는 플랫폼에서의 표시 방법 고려
• 사용법 문서화 – 문서에서 사용된 확장 기능 명시
• 선택 표준화 – 팀 내에서 통일된 확장 기능 세트 사용

다음 단계

관심 있는 확장 문법을 선택하여 학습을 시작하세요:

• 상세한 표 문법
• 코드 블록 문법
• 확장 문법 전체 목록 보기