מדריך תחביר Markdown
תחביר חיוני לעיצוב המסמכים שלך
סקירה
Markdown היא שפת סימון קלה שאפשר להשתמש בה כדי להוסיף אלמנטי עיצוב למסמכי טקסט גולמי. נוצר על ידי John Gruber ב-2004, Markdown הוא כעת אחת משפות הסימון הפופולריות בעולם.
שימוש ב-Markdown שונה משימוש בעורך WYSIWYG. ביישום כמו Microsoft Word לוחצים על כפתורים לעצב מילים ומשפטים, והשינויים נראים מיד. Markdown לא ככה. כשאתה יוצר קובץ בפורמט Markdown, אתה מוסיף תחביר Markdown לטקסט כדי לציין אילו מילים ומשפטים צריכים להיראות אחרת.
כותרות
כדי ליצור כותרת, הוסף סימני מספר (#) לפני מילה או משפט. מספר סימני המספר צריך להתאים לרמת הכותרת. למשל, לרמת כותרת שלוש השתמש בשלושה סימני מספר (### הכותרת שלי).
Heading level 1
Heading level 2
Heading level 3
Heading level 4
Heading level 5
Heading level 6
פסקאות
כדי ליצור פסקאות, השתמש בשורה ריקה להפרדת שורת טקסט אחת או יותר.
It lets me write easily.
<p>It lets me write easily.</p>
I really like using Markdown.
It lets me write easily.
שבירת שורות
כדי ליצור שבירת שורה או שורה חדשה, סיים שורה עם שני רווחים או יותר ואז לחץ Enter.
And this is the second line.
And this is the second line.</p>
This is the first line.
And this is the second line.
הדגשה
אפשר להוסיף הדגשה על ידי הפיכת טקסט למודגש או נטוי.
מודגש
לטקסט מודגש, הוסף שני כוכביות (**) או קו תחתון (__) לפני ואחרי מילה או משפט.
I just love bold text.
I just love bold text.
נטוי
לטקסט נטוי, הוסף כוכבית אחת (*) או קו תחתון (_) לפני ואחרי מילה או משפט.
The cat meows.
The cat meows.
מודגש ונטוי
להדגשת טקסט במודגש ונטוי יחד, הוסף שלוש כוכביות (***) או קו תחתון (___) לפני ואחרי מילה או משפט.
This text is really important.
This text is really important.
בלוקי ציטוט
כדי ליצור בלוק ציטוט, הוסף > לפני פסקה.
Dorothy followed her through many of the beautiful rooms in her castle.
בלוקי ציטוט מקוננים
בלוקי ציטוט אפשר לקנן. הוסף >> לפני הפסקה שברצונך לקנן.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
Dorothy followed her through many of the beautiful rooms in her castle.
The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
רשימות
אפשר לארגן פריטים לרשימות ממוספרות ולא ממוספרות.
רשימות ממוספרות
לרשימה ממוספרת, הוסף שורות עם מספרים ואחריהם נקודה. המספרים לא חייבים להיות בסדר מספרי, אבל הרשימה צריכה להתחיל באחד.
2. Second item
3. Third item
4. Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>
- First item
- Second item
- Third item
- Fourth item
רשימות לא ממוספרות
לרשימה לא ממוספרת, הוסף מקפים (-), כוכביות (*) או סימני פלוס (+) לפני שורות.
- Second item
- Third item
- Fourth item
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>
- First item
- Second item
- Third item
- Fourth item
קוד
כדי לסמן מילה או משפט כקוד, סגור ב-backticks (`).
At the command prompt, type nano.
בלוקי קוד
לבלוק קוד, הזח כל שורה בבלוק בלפחות ארבע רווחים או טאב אחד, או השתמש בשלושה backticks (```) לפני ואחרי בלוק הקוד.
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
```
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}קווים אופקיים
לקו אופקי, השתמש בשלוש כוכביות (***), מקפים (---) או קו תחתון (___) בשורה לבד.
קישורים
לקישור, סגור את טקסט הקישור בסוגריים מרובעים (למשל [Duck Duck Go]) ואחריו מיד ה-URL בסוגריים (למשל (https://duckduckgo.com)).
My favorite search engine is Duck Duck Go.
הוספת כותרות
אפשר אופציונלית להוסיף כותרת לקישור. היא תופיע כ-tooltip כשהמשתמש מרחף מעל הקישור. להוספת כותרת, סגור במרכאות אחרי ה-URL.
My favorite search engine is Duck Duck Go.
תמונות
להוספת תמונה, הוסף סימן קריאה (!), אחריו טקסט חלופי בסוגריים מרובעים והנתיב או ה-URL לתמונה בסוגריים. אפשר אופציונלית להוסיף כותרת במרכאות אחרי הנתיב או ה-URL.
בריחת תווים
כדי להציג תו מילולי שמשמש אחרת לעיצוב טקסט במסמך Markdown, הוסף backslash (\) לפני התו.
* Without the backslash, this would be a bullet in an unordered list.
תווים שאפשר לברוח
אפשר להשתמש ב-backslash לברוח מהתווים הבאים:
| \ | backslash |
| ` | backtick |
| * | asterisk |
| _ | underscore |
| { } | curly braces |
| [ ] | brackets |
| ( ) | parentheses |
| # | pound sign |
| + | plus sign |
| - | minus sign (hyphen) |
| . | dot |
| ! | exclamation mark |
| | | pipe |
טבלאות
לטבלה, השתמש בשלושה מקפים (---) או יותר ליצירת כותרת כל עמודה, וצינורות (|) להפרדת עמודות. אפשר אופציונלית להוסיף צינורות בשני קצות הטבלה.
| --------- | ----------- |
| Header | Title |
| Paragraph | Text |
| Syntax | Description |
|---|---|
| Header | Title |
| Paragraph | Text |
יישור
אפשר ליישר טקסט בעמודות לשמאל, ימין או מרכז על ידי הוספת נקודתיים (:) לשמאל, ימין או משני צדי המקפים בשורת הכותרת.
| :--- | :---: | ---: |
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |
| יישר לשמאל | מרכז | יישר לימין |
|---|---|---|
| This | This | This |
| column | column | column |
| will | will | will |
| align | align | align |
| left | center | right |