## עזר

Callouts של GitHub Markdown

פורסם במרץ 2026

GitHub הוסיף תחביר callout (התרעה) ל-GitHub Flavored Markdown. התיבות המעוצבות האלה מדגישות מידע חשוב בתיעוד - הערות, טיפים, אזהרות ועוד. ShowMeMyMD הוא אחד ממציגי desktop הבודדים שמציגים אותם.

## התחביר

חמישה סוגי callout

Callouts משתמשים בתחביר ציטוט עם תג מיוחד בשורה הראשונה. המבנה תמיד זהה: > [!TYPE]ואחריו התוכן בשורה הבאה, גם הוא עם >.

> [!NOTE]
> מידע מועיל שכדאי לדעת,
> גם כשמדפדפים מהר.

NOTE - מוצג כתיבת מידע כחולה. השתמשו בו עבור הקשר נוסף שהוא מועיל אבל לא קריטי. מידע של 'אגב'.

> [!TIP]
> עצה מועילה לעשות דברים טוב יותר
> או בקלות רבה יותר.

TIP - מוצג כתיבת הצעה ירוקה. מתאים לשיטות עבודה מומלצות, קיצורי דרך או המלצות שמקלות על הקורא.

> [!IMPORTANT]
> מידע מרכזי שהמשתמשים צריכים לדעת כדי
> להשיג את המטרה שלהם.

IMPORTANT - מוצג כתיבת הדגשה סגולה. השתמשו בו למידע קריטי שצריך להבין לפני שממשיכים.

> [!WARNING]
> מידע דחוף שדורש תשומת לב מיידית
> כדי להימנע מבעיות.

WARNING - מוצג כתיבת אזהרה צהובה. מתאים לבעיות אפשריות, מלכודות או דברים שעלולים להשתבש.

> [!CAUTION]
> מייעץ לגבי סיכונים או תוצאות שליליות
> של פעולות מסוימות.

CAUTION - מוצג כתיבת סכנה אדומה. שמרו אותו לפעולות בלתי הפיכות, אובדן נתונים או פעולות שעלולות לשבור דברים.

## טיפים לשימוש

איך לכתוב callouts טובים

להשתמש במתינות

יותר מדי callouts יוצרים רעש חזותי. אם הכול חשוב, שום דבר לא חשוב. דף מלא בתיבות צבעוניות מלמד את הקוראים להתעלם מהן. בדרך כלל אחת או שתיים בכל מקטע זה מספיק.

להתאים את הסוג לחומרה

אל תשתמשו ב-CAUTION עבור טיפ קטן. אל תשתמשו ב-NOTE עבור משהו שעלול למחוק מסד נתונים. קידוד הצבעים נועד לתת לקוראים אות מיידי על רמת החומרה.

לשמור על תוכן קצר

Callouts עובדים הכי טוב עם משפט עד שלושה. אם אתם צריכים כמה פסקאות, כנראה שהמידע שייך לגוף הטקסט ולא לקופסת callout.

אפשר לשלב אלמנטים אחרים

קוד inline, קישורים, bold ו-italic עובדים בתוך callouts. הוסיפו > לפני כל שורה כדי להשאיר את התוכן בתוך הבלוק.

## תאימות

איפה callouts מוצגים

כלי	תמיכה ב-callouts
GitHub (אינטרנט)	מלאה - תיבות צבעוניות עם אייקונים
ShowMeMyMD	מלאה - callouts מעוצבים על desktop
חלק מתוספי VS Code	משתנה לפי התוסף
רוב מציגי Markdown	לא - מוצג ציטוט רגיל
CommonMark רגיל	לא - ציטוט רגיל
Parser ישנים של GFM	לא - ציטוט רגיל

רוב מציגי Markdown מציגים רק ציטוט רגיל.

ShowMeMyMD מציג את ה-callout המעוצב במלואו - סרגל צד צבעוני, אייקון ועיצוב נכון - בדיוק כמו ב-GitHub. אם אתם כותבים README או תיעוד עם callouts, זה אחד הכלים הבודדים שמאפשרים להציג אותם מקומית ב-Mac.

## להמשך קריאה

למדו עוד על ShowMeMyMD כמציג Markdown ל-Mac. ראו למה מפתחים בוחרים בו כ מציג Markdown למפתחים. או שמרו את דף העזר ל-Markdown.

תצוגה מקומית של callouts ב-Mac

תפסיקו לדחוף ל-GitHub רק כדי לבדוק איך ה-callouts נראים. ShowMeMyMD מציג NOTE, TIP, IMPORTANT, WARNING ו-CAUTION - ישירות על ה-Mac שלכם. 2.99$ ב-Mac App Store.