הנה סקירה קצרה של Markdown ושל התחביר הבסיסי שלו, למקרה שעוד לא נתקלתם בו. כבר ראינו קבצים כמו CLAUDE.md ו-MEMORY.md. אלה קובצי Markdown, טקסט פשוט עם קצת תחביר לעיצוב. נראה מה אפשר לשים בהם ואיך עורכים ומציגים אותם. Markdown נפוץ בתכנות מבוסס-סוכנים כי אנשים יכולים לקרוא את הטקסט וסוכנים יכולים לערוך אותו עם אותם כלי קבצים שהם משתמשים בהם לקוד.
נתחיל בדוגמה קטנה. משמאל המקור של קובץ בשם notes.md, ומימין איך viewer מציג אותו. סולמית ואחריה רווח יוצרים כותרת. שתי סולמיות יוצרות כותרת קטנה יותר. מקף ורווח פותחים שורה ברשימה, ומספרים עם נקודה נותנים לנו רשימה ממוספרת. משפטים רגילים הופכים לפסקאות, מופרדות בשורות ריקות. הסימנים נשארים קלים לקריאה במקור, ו-viewer הופך אותו למסמך מעוצב לצידו.
זוג כוכביות הופך טקסט למודגש. סימני backtick מסמנים קוד בתוך משפט. בקישור, הטקסט בסוגריים מרובעים והכתובת בסוגריים עגולים. Markdown יכול להכיל גם תמונות ובלוקים של קוד. את התחביר אפשר לחפש לפי הצורך.
ב-VS Code, פתחו את קובץ ה-Markdown. לחצו Control, Shift ו-P כדי לפתוח את ה-Command Palette, או Command, Shift ו-P במק. ואז בחרו Markdown: Open Preview to the Side. עכשיו אפשר לערוך את המקור ולקרוא לצידו את התצוגה המקדימה.
אם נשנה את השורה הזאת כך שתאמר add search by title, התצוגה המקדימה מתעדכנת. זה אותו קובץ בשתי תצוגות. ערכו את הטקסט משמאל, קראו את הגרסה המעוצבת מימין, ושמרו את השינויים כרגיל.
תוכנת המרה יכולה להפוך Markdown ל-HTML לדף אינטרנט, או לפורמטים כמו PDF ו-Word. כלים כמו Pandoc עושים את ההמרות האלה. שומרים את הטקסט שאפשר לערוך, ומייצרים מסמך מעוצב כשצריך.
חלק מה-viewers תומכים גם בהרחבות כמו Mermaid, שהופכת תיאור טקסטואלי לתרשים. הבלוק הזה מתאר שלושה שלבים, request, edit ו-review, וה-viewer מצייר את התיבות והחצים. התמיכה ב-Mermaid תלויה ב-viewer. GitHub מציג את התרשים, ובתצוגה המקדימה של VS Code צריך תוסף.
זה מספיק כדי להתחיל. אפשר לארגן הערות והוראות בקובץ Markdown, לקרוא אותן בנוחות בתצוגה מקדימה, ולעבוד על אותו טקסט קריא עם הסוכן שלכם.