## 레퍼런스

GitHub Markdown 콜아웃

2026년 3월 게시

GitHub가 GitHub Flavored Markdown에 콜아웃(알림) 구문을 추가했습니다. 이 스타일 박스는 문서에서 중요한 정보를 강조합니다 — 노트, 팁, 경고 등. ShowMeMyMD는 이를 렌더링하는 몇 안 되는 데스크톱 뷰어 중 하나입니다.

## 구문

다섯 가지 콜아웃 유형

콜아웃은 첫 줄에 특별한 태그가 있는 인용문 구문을 사용합니다. 형식은 항상 동일합니다: > [!TYPE] 다음 줄에 내용을 작성하며 > 접두사를 붙입니다.

> [!NOTE]
> 사용자가 알아야 할 유용한 정보,
> 내용을 훑어볼 때에도.

NOTE — 파란색 정보 박스로 렌더링됩니다. 도움이 되지만 중요하지 않은 추가 맥락에 사용하세요. '참고로' 수준의 정보입니다.

> [!TIP]
> 더 쉽거나 더 나은 방법에 대한
> 유용한 조언.

TIP — 녹색 제안 박스로 렌더링됩니다. 모범 사례, 단축키, 읽는 사람의 삶을 더 쉽게 만드는 추천에 사용하세요.

> [!IMPORTANT]
> 목표 달성을 위해 사용자가
> 알아야 할 핵심 정보.

IMPORTANT — 보라색 강조 박스로 렌더링됩니다. 진행하기 전에 반드시 이해해야 할 정보에 사용하세요. 경고는 아니지만 건너뛸 수 없는 내용입니다.

> [!WARNING]
> 문제를 피하기 위해 즉각적인
> 주의가 필요한 긴급 정보.

WARNING — 노란색 경고 박스로 렌더링됩니다. 잠재적 문제, 함정, 주의하지 않으면 잘못될 수 있는 것에 사용하세요.

> [!CAUTION]
> 특정 작업의 위험이나
> 부정적 결과에 대한 조언.

CAUTION — 빨간색 위험 박스로 렌더링됩니다. 되돌릴 수 없는 작업, 데이터 손실 시나리오, 문제를 일으킬 수 있는 작업에 사용하세요.

## 사용 팁

콜아웃이 너무 많으면 시각적 잡음이 됩니다. 모든 것이 중요하면 아무것도 중요하지 않습니다. 섹션당 하나 또는 두 개가 적당합니다.

사소한 팁에 CAUTION을 사용하지 마세요. 데이터베이스를 삭제할 수 있는 내용에 NOTE를 사용하지 마세요. 색상 코딩은 독자에게 심각도에 대한 즉각적 신호를 줍니다 — 존중하세요.

콜아웃은 1~3문장이 가장 효과적입니다. 여러 단락이 필요하다면 본문에 넣어야 할 정보일 가능성이 높습니다.

코드 스팬, 링크, 굵은 글씨, 기울임꼴 모두 콜아웃 안에서 작동합니다. 모든 줄에 > 접두사를 붙여 콜아웃 블록 안에 유지하세요.

## 호환성

대부분의 Markdown 뷰어는 인용문만 보여줍니다.

ShowMeMyMD는 전체 스타일된 콜아웃을 렌더링합니다 — 컬러 사이드바, 아이콘, 적절한 포맷팅 — GitHub에서 보이는 것과 동일하게. 콜아웃이 포함된 README나 문서를 작성한다면, Mac에서 로컬로 미리볼 수 있는 몇 안 되는 방법 중 하나입니다.

## 계속 읽기

Mac용 Markdown 뷰어로서의 ShowMeMyMD에 대해 더 알아보세요. 개발자들이 개발자용 Markdown 뷰어로 선택하는 이유를 확인하세요. 또는 Markdown 치트 시트를 북마크하세요.

콜아웃이 어떻게 보이는지 확인하려고 GitHub에 푸시하지 마세요. ShowMeMyMD는 NOTE, TIP, IMPORTANT, WARNING, CAUTION을 Mac에서 바로 렌더링합니다. Mac App Store에서 $2.99.