## Tham khảo

Callout Markdown kiểu GitHub

Đăng tháng 3/2026

GitHub thêm cú pháp callout (alert) vào GitHub Flavored Markdown. Những hộp thông tin này rất hữu ích cho tài liệu: note, tip, warning và nhiều hơn nữa. ShowMeMyMD là một trong số ít trình xem desktop render chúng.

## Cú pháp

Năm loại callout

Callout dùng blockquote với thẻ đặc biệt ở dòng đầu. Mẫu luôn là > [!TYPE] rồi đến nội dung ở các dòng dưới, cũng bắt đầu bằng >.

> [!NOTE]
> Thông tin hữu ích cho người đọc.

NOTE hiển thị như hộp thông tin màu xanh.

> [!TIP]
> Mẹo nhỏ giúp làm việc tốt hơn.

TIP hiển thị như lời khuyên màu xanh lá.

> [!IMPORTANT]
> Thông tin cốt lõi cần biết trước khi tiếp tục.

IMPORTANT nhấn mạnh nội dung quan trọng.

> [!WARNING]
> Cảnh báo về vấn đề có thể xảy ra.

WARNING dùng cho rủi ro hoặc gotcha.

> [!CAUTION]
> Cảnh báo rủi ro hoặc hậu quả không mong muốn.

CAUTION dành cho tình huống có thể gây mất dữ liệu hoặc phá vỡ luồng.

## Cách dùng

Viết callout hiệu quả

Dùng vừa phải

Nếu hộp màu xuất hiện quá nhiều, người đọc sẽ bỏ qua chúng.

Khớp mức độ với loại

Đừng dùng WARNING cho một mẹo nhỏ, và đừng dùng NOTE cho thứ có thể xóa dữ liệu.

Giữ ngắn gọn

1-3 câu là hợp lý nhất. Nếu dài hơn, có lẽ nên đưa vào thân bài.

Muốn xem callout render đúng như GitHub?

ShowMeMyMD render callout đầy đủ ngay trên Mac.