מדריך מאמרים
Markdownמה המשמעות?
כיצד להשתמש בתחביר/עיצוב של Markdown?
סקירה כללית
Markdown היא שפת סימון קלת משקל שנוצרה על ידי ג'ון גרובר.
זה מאפשר לאנשים "לכתוב מסמכים בפורמט טקסט רגיל שקל לקרוא ולכתוב, ולאחר מכן להמיר אותם למסמכי XHTML (או HTML) חוקיים".
השפה משלבת רבות מהתכונות של סימון טקסט רגיל שכבר נמצאות בדואר אלקטרוני.
ג'ון גרובר יצר את שפת ה-Markdown בשנת 2004, בשיתוף פעולה עם אהרון שוורץ, במידה רבה על התחביר.מטרת השפה היא להשתמש ב"פורמט טקסט פשוט קל לקריאה, קל לכתיבה, ובאופן אופציונלי ממיר ל-XHTML חוקי (או HTML)".
מַטָרָה
המטרה של Markdown היא להיות "קל לקריאה וקל לכתיבה".
קריאות, עשה זאת בכל מקרהשיווק באינטרנט, חווית משתמש חשובה מאוד.
מסמך שנכתב ב-Markdown צריך להיות מסוגל להתפרסם ישירות בטקסט רגיל, ולא אמור להיראות כמורכב מתגיות רבות או הנחיות עיצוב.
תחביר Markdown מושפע מכמה פורמטים קיימים של טקסט ל-HTML, כולל Setext, atx, Textile, reStructuredText, Grutatext ו-EtText, אבל מקור ההשראה הגדול ביותר הוא פורמט הדוא"ל הפשוט של טקסט.
בקיצור, התחביר של Markdown מורכב כולו מסמלים, שנבחרו בקפידה ותפקידיהם ברורים במבט חטוף.לדוגמה: שימו כוכביות מסביב לטקסט כדי שייראה כמו *הדגשה*.
רשימות ב-Markdown נראות כמו, ובכן, רשימות. ציטוטים בלוק ב-Markdown באמת נראים כמו ציטוט של קטע טקסט, כמו שראית במיילים.
תואם עם HTML
מטרת הדקדוק של Markdown היא להיות שפת כתיבה לאינטרנט.
Markdown לא נועד להחליף HTML, או אפילו להתקרב אליו, יש לו מעט מאוד סוגים של תחביר והוא מתאים רק לקבוצת משנה קטנה של סימון HTML. Markdown לא תוכנן כדי להקל על כתיבה של מסמכי HTML.
לדעתי, HTML כבר קל לכתוב. הרעיון של Markdown הוא להפוך מסמכים לקלים יותר לקריאה, כתיבה ושינוי כרצונם. HTML הוא פורמט פרסום, Markdown הוא אקופירייטינגפורמט כתוב.ככזה, תחביר העיצוב של Markdown מכסה רק את מה שטקסט רגיל יכול.
ניתן לכתוב תגים שאינם מכוסים ב-Markdown ב-HTML ישירות במסמךקידום אתריםעותק.אין צורך לסמן את זה כ-HTML או Markdown; פשוט הוסף את הסימון ישירות.
יש להגביל רק חלק ממרכיבי בלוק HTML - כגון <div>,<table>,<pre>,<p> ותגים אחרים, יש להפריד אותם מאזורי תוכן אחרים עם שורות ריקות לפני ואחרי, ואסור להכניס את תגי הפתיחה והסגירה שלהם עם טאבים או רווחים. מחולל ה-Markdown חכם מספיק כדי לא להוסיף תגיות HTML מיותרות <p> תווית.
הדוגמה היא כדלקמן, הוספת טבלת HTML לקובץ Markdown:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
שים לב שתחביר עיצוב Markdown בין תגי בלוק HTML לא יעובד.לדוגמה, אם אתה משתמש בסגנון Markdown בתוך בלוק HTML*强调*לא תהיה השפעה.
תגי HTML (מוטבעים) כגון <span>,<cite>,<del> ניתן להשתמש בחופשיות בפסקאות, רשימות או כותרות Markdown.על פי הרגלים אישיים, אתה יכול אפילו להשתמש בתגי HTML לעיצוב מבלי להשתמש בפורמט Markdown.דוגמה: אם אתה מעדיף HTML <a> או <img> תגיות, שניתן להשתמש בהן ישירות ללא תחביר הקישור או תג התמונה שסופק על ידי Markdown.
שלא כמו בין תגי בלוק HTML, תחביר Markdown תקף בין תגי HTML.
המרה אוטומטית של תווים מיוחדים
בקובצי HTML, ישנם שני תווים הדורשים טיפול מיוחד: < ו - & . < סמלים משמשים לתגי התחלה,& סמלים משמשים לסימון ישויות HTML, אם אתה רק רוצה להציג את אב הטיפוס של התווים האלה, אתה צריך להשתמש בטופס הישות, כמו < ו - &.
& דמויות מייסרות במיוחד עבור כותבי מסמכי אינטרנט, אם אתה מתכוון להקליד "AT&T", אתה חייב לכתוב"AT&T".בעוד בכתובת האתר & גם דמויות מומרות.לדוגמה אתה רוצה לקשר ל:
http://images.google.com/images?num=30&q=larry+bird
עליך לכתוב את המרת כתובת האתר כ:
http://images.google.com/images?num=30&q=larry+bird
להציב בתג הקישור href בנכסים.מיותר לציין שקל להתעלם מכך, וכנראה המספר הגדול ביותר של שגיאות שזוהה על ידי אימות תקני HTML.
Markdown מאפשר לכתוב תווים באופן טבעי, והוא דואג למה שצריך להמיר.אם אתה משתמש & תו הוא חלק מיישות תו HTML, הוא נשאר כפי שהוא, אחרת הוא מומר ל &;.
אז אם אתה רוצה להכניס סמל של זכויות יוצרים במסמך ©, אתה יכול לכתוב:
©
Markdown ישאיר אותו ללא פגע.ואם אתה כותב:
AT&T
Markdown ימיר אותו ל:
AT&T
מצב דומה מתרחש גם ב < סימון, שכן Markdown מאפשר תאימות HTML, אם אתה שם < סמלים משמשים כמפרידים עבור תגי HTML, ו-Markdown לא יבצע עליהם המרות, אבל אם תכתוב:
4 < 5
Markdown ימיר אותו ל:
4 < 5
עם זאת, יש לציין שבמסגרת הקוד, בין אם הוא מוטבע או חסום, < ו - & שני הסמליםבטוחמומרים לישויות HTML, תכונה המאפשרת לך לכתוב בקלות קוד HTML ב-Markdown (בניגוד ל-HTML, שבו אתה שם את כל < ו - & כולם מומרים לישויות HTML, על מנת לכתוב קוד HTML בקובץ HTML. )
אלמנט בלוק
פסקאות ומעברי שורות
פסקת Markdown מורכבת משורה אחת או יותר רצופות של טקסט, שלפניהן ואחריה יותר משורה ריקה אחת (ההגדרה של שורה ריקה היא שהיא נראית ריקה בתצוגה ונחשבת כשורה ריקה. לדוגמה, , אם שורה מכילה רק רווחים וטאבים, השורה תטופל גם כשורה ריקה).אין להכניס פסקאות רגילות עם רווחים או טאבים.
הביטוי "מורכב משורה אחת או יותר של טקסט רצוף" מרמז למעשה ש-Markdown מאפשר שורות חדשות (הכנסת שורות חדשות) כפויות בתוך פסקאות, תכונה השונה מרוב הפורמטים האחרים של טקסט ל-HTML (כולל Movable Type "המר מעברי שורות" " אפשרות), פורמטים אחרים ימירו כל מעבר שורה ל <br /> תווית.
אם אתהאכןרוצה להסתמך על Markdown כדי להכניס <br /> עבור תוויות, הקש על שני רווחים או יותר במקום ההכנסה ולאחר מכן הקש Enter.
אכן, נדרשת קצת יותר עבודה (חללים נוספים) כדי ליצור <br /> , אלא פשוט "כל שורה חדשה מומרת ל <br />"השיטה לא מתאימה ב-Markdown, אבל ב-Markdownaiציטוטים בסגנון L ורשימות מרובות פסקאות הם לא רק שימושיים יותר אלא גם קלים יותר לקריאה בעת קביעת הקלדה עם מעברי שורה.
כותרת
Markdown תומך בשני תחבירים עבור כותרות, דמוי Setext ו-Atx.
הטופס דמוי Settext הוא הטופס עם השורה התחתונה, באמצעות = (הכותרת הגבוהה ביותר) ו - (כותרות מסדר שני), למשל:
This is an H1
=============
This is an H2
-------------
כל סכום = ו - - יכול להיות יעיל.
הצורה דמוית Atx מכניסה 1 עד 6 בתחילת השורה # , התואם לכותרות 1 עד 6, לדוגמה:
# 这是 H1
## 这是 H2
###### 这是 H6
אתה יכול אופציונלי "לסגור" כותרות דמויות atx, זה רק בשביל אסתטיקה, אם אתה מרגיש בנוח ככה, אתה יכול להוסיף את זה בסוף השורה #, בעוד השורה מסתיימת # המספר לא חייב להיות זהה להתחלה (מספר תווי הפאונד בתחילת השורה קובע את סדר הכותרת):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Blockquotes Blockquotes
נעשה שימוש בציטוטים של סימון סימון בדומה לאלו המשמשים בדוא"ל > של ציטוטים.אם אתה מכיר ציטוטים במכתבי אימייל, אתה יודע איך ליצור ציטוט חסום בקובץ Markdown, שייראה כאילו אתה שובר את השורות בעצמך, ואז הוסף > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
Markdown מאפשר גם להתעצל ולהוסיף רק את השורה הראשונה של הפסקה כולה > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
ניתן לקנן הפניות בלוק (למשל: הפניות בתוך הפניות) על ידי הוספת מספר שונה של > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
ניתן להשתמש בתחבירי Markdown אחרים גם בתוך בלוקים במרכאות, כולל כותרות, רשימות, בלוקי קוד וכו':
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
כל עורך טקסט הגון יכול ליצור בקלות ציטוטים בסגנון אימייל.לדוגמה ב-BBEdit ניתן לבחור טקסט ולאחר מכן לבחור מהתפריטלהגדיל את היררכיית הציטוטים.
רשימה
Markdown תומך ברשימות מסודרות ולא מסודרות.
רשימות לא מסודרות משתמשות בכוכביות, סימני פלוס או סימני מינוס כסמני רשימה:
* Red
* Green
* Blue
שווה ערך ל:
+ Red
+ Green
+ Blue
שווה גם ל:
- Red
- Green
- Blue
רשימות מסודרות משתמשות במספרים ואחריהם נקודה:
1. Bird
2. McHale
3. Parish
חשוב לציין שהמספרים שבהם אתה משתמש בתג הרשימה אינם משפיעים על הפלט HTML. סימון ה-HTML שיתקבל עבור הרשימה לעיל יהיה:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
אם סימון הרשימה שלך כתוב כך:
1. Bird
1. McHale
1. Parish
או אפילו:
3. Bird
1. McHale
8. Parish
שניכם תקבלו בדיוק אותו פלט HTML.הנקודה היא שאתה יכול להפוך את מספרי הרשימה בקובץ Markdown זהים לתוצאות הפלט, או אם אתה עצלן, לא צריך לדאוג לנכונות המספרים בכלל.
אם אתה משתמש בכתיבה עצלה, מומלץ להתחיל ב-1. עבור הפריט הראשון, כי Markdown עשוי לתמוך בתכונת ההתחלה של רשימות מסודרות בעתיד.
תג פריט הרשימה ממוקם בדרך כלל בקצה השמאלי ביותר, אך ניתן להכניס אותו להזחה, עד 3 רווחים, ואחריו תג הפריט חייב להיות לפחות רווח אחד או טאב אחד.
כדי שהרשימה תיראה יפה יותר, אתה יכול לארגן את התוכן עם הזחה קבועה:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
אבל אם אתה עצלן, גם זה בסדר:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
אם פריטי הרשימה מופרדים בשורות ריקות, Markdown ישתמש בתוכן הפריט בעת הפלט של HTML. <p> תוויות עטופות, למשל:
* Bird
* Magic
יומר ל:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
אבל זה:
* Bird
* Magic
יומר ל:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
פריטי רשימה יכולים להכיל מספר פסקאות, והפסקאות מתחת לכל פריט חייבות להיות מוזחות ב-4 רווחים או בטאב אחד:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
זה נראה הרבה יותר טוב אם תכניסי כל שורה, כמובן, שוב, אם אתה עצלן, Markdown מאפשר גם:
* This is a list item with two paragraphs.
This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
* Another item in the same list.
אם אתה רוצה לשים הפניה בתוך פריט רשימה, אז > צריך להכניס את זה להזחה:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
אם אתה רוצה לשים בלוק קוד, יש להכניס את הבלוק להזחהפעמיים, שהם 8 רווחים או 2 טאבים:
* 一列表项包含一个列表区块：
<代码写在这>
כמובן, רשימה של פריטים עלולה להיווצר בטעות, משהו כמו זה:
1986. What a great season.
במילים אחרות, הוא מופיע בתחילת השורהמספר-נקודה-ריק, כדי להימנע מכך, אתה יכול להוסיף קו נטוי לפני המחזור.
1986\. What a great season.
בלוק קוד
קוד מקור לכתיבה או שפת תגיות הקשורות לתוכנית יש בדרך כלל כבר קובצי קוד. בדרך כלל, אנחנו לא רוצים שהבלוקים האלה יוגדרו בדרך של קובצי פסקה כלליים, אלא מציגים אותם כפי שהם. Markdown ישתמש <pre> ו - <code> תגים לעטוף בלוקי קוד.
יצירת בלוקי קוד ב-Markdown היא פשוטה כמו הזחה של 4 רווחים או טאב אחד. לדוגמה, הזן את הפרטים הבאים:
这是一个普通段落：
这是一个代码区块。
Markdown ימיר ל:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
הזחה זו מסדר ראשון לכל שורה (4 רווחים או טאבה אחת) מוסרת, לדוגמה:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
יומר ל:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
גוש קוד נמשך עד לשורה הבלתי מונחת (או לסוף הקובץ).
בתוך בלוק הקוד, & , < ו - > זה יומר אוטומטית לישויות HTML. שיטה זו מקלה עליך מאוד להשתמש ב-Markdown כדי להכניס את קוד ה-HTML של הדוגמה, פשוט העתק והדבק אותו, הוסף הזחה, והשאר Markdown יטפל בזה עבורך, עבור דוגמא:
<div class="footer">
© 2004 Foo Corporation
</div>
יומר ל:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
בבלוק הקוד, התחביר הכללי של Markdown לא יומר, כגון כוכביות הן רק כוכביות, מה שאומר שאתה יכול בקלות לכתוב קבצים הקשורים לתחביר Markdown בתחביר Markdown.
מחיצה
אתה יכול להשתמש ביותר משלוש כוכביות, סימני מינוס, קו תחתון כדי ליצור מפריד בשורה, שום דבר אחר בשורה.ניתן גם להוסיף רווחים בין כוכביות או סימני מינוס.ניתן ליצור קווי הפרדה בכל אחת מדרכי הכתיבה הבאות:
* * *
***
*****
- - -
---------------------------------------
אלמנט מקטע
链接
Markdown תומך בשתי צורות של תחביר קישור: בשורהו -התייחסותשתי צורות.
כך או כך, טקסט קישור מסומן ב[סוגריים מרובעים].
ליצורבשורהאם אתה רוצה להוסיף את טקסט הכותרת של הקישור, פשוט עטוף את טקסט הכותרת במרכאות כפולות אחרי כתובת האתר, לדוגמה:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
יפיק:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
אם אתה מקשר למשאבים באותו מארח, אתה יכול להשתמש בנתיבים יחסיים:
See my [About](/about/) page for details.
התייחסותאחרי הקישור מופיעה סוגר מרובע נוסף אחרי סוגריים של טקסט הקישור, ויש למלא את הסימן המשמש לזיהוי הקישור בסוגריים המרובע השני:
This is [an example][id] reference-style link.
ניתן גם להוסיף רווח בין שתי הסוגריים המרובעים:
This is [an example] [id] reference-style link.
לאחר מכן, בכל מקום בקובץ, תוכל להגדיר את תוכן הקישור של תג זה:
[id]: http://example.com/ "Optional Title Here"
תוכן הקישור מוגדר בטופס:
- סוגריים מרובעים (אופציונלי לפנים עד שלושה רווחים להזחה) שלתוכם מוזן טקסט הקישור
- ואחריו נקודתיים
- ואחריו רווח או טאבים אחד או יותר
- כתובת האתר של הקישור הבא
- אפשר לעקוב אחר תוכן הכותרת, שיכול להיות מוקף במרכאות בודדות, במירכאות כפולות או בסוגריים
ההגדרות של שלושת הקישורים הבאים זהים:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
זְהִירוּת:קיימת בעיה ידועה שבה Markdown.pl 1.0.1 מתעלם מכותרות קישורים המוקפות במרכאות בודדות.
כתובות אתרים של קישורים יכולות להיות מוקפות גם בסוגריים זווית:
[id]: <http://example.com/> "Optional Title Here"
אתה יכול גם לשים את תכונת הכותרת בשורה הבאה, או להוסיף הזחה כלשהי, שתראה טוב יותר אם כתובת האתר ארוכה מדי:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
הגדרת כתובת האתר משמשת רק בעת יצירת הקישור, ואינה מופיעה ישירות בקובץ.
תגי זיהוי קישורים עשויים להכיל אותיות, מספרים, רווחים וסימני פיסוק, אך לאלאזה תלוי רישיות, אז שני הקישורים הבאים זהים:
[link text][a]
[link text][A]
תג קישור מרומזתכונה מאפשרת לך להשמיט ציון תג קישור. במקרה זה, תג הקישור יטופל כשווה ערך לטקסט הקישור. כדי להשתמש בתגית קישור מרומזת, פשוט הוסף סוגר מרובע ריק אחרי טקסט הקישור. אם אתה רוצה "גוגל " קישור אל google.com, אתה יכול לפשט ל:
[Google][]
לאחר מכן הגדר את תוכן הקישור:
[Google]: http://google.com/
מכיוון שטקסט קישור עשוי להכיל רווח לבן, סימון מפושט זה עשוי להכיל מספר מילים:
Visit [Daring Fireball][] for more information.
לאחר מכן המשך להגדיר את הקישור:
[Daring Fireball]: http://daringfireball.net/
את ההגדרה של הקישור אפשר למקם בכל מקום בקובץ, אני מעדיף לשים אותו ישירות אחרי הפסקה שבה מופיע הקישור, אפשר גם לשים אותו בסוף הקובץ, ממש כמו תגובה.
הנה דוגמה לקישור עזר:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
אם תשנה אותו כדי להשתמש בשם הקישור כדי לכתוב:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
שתי דרכי הכתיבה הנ"ל יפיקו את ה-HTML הבא.
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
להלן קובץ Markdown של אותו תוכן שנכתב בשורה, מסופק לשם השוואה:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
למעשה, הנקודה של קישורים בסגנון הפניה היא לא שקל יותר לכתוב, אלא שקל יותר לקריאה. השווה את הדוגמה שלעיל. המאמר בסגנון הפניה עצמו הוא רק 81 תווים, אבל הצורה המוטבעת תגדל ל- 176 תווים. , אם הוא כתוב בפורמט HTML טהור, יהיו 234 תווים. בפורמט HTML, יש יותר תגים מטקסט.
באמצעות קישורים בסגנון הפניה של Markdown, אתה יכול להפוך את המסמך לדומה יותר לתוצאה הסופית של הדפדפן, ולאפשר לך להעביר כמה מטא נתונים הקשורים לסימון מחוץ לטקסט הפסקה, ותוכל להוסיף קישורים מבלי לגרום לתחושת הקריאה של המאמר. interrupt .
强调
Markdown משתמש בכוכביות (*) והשורה התחתונה (_) כסמל לסימון מילה עם קו תחתון, הוא * או _ מילים מוקפות מומרות ל <em> מוקף בתוויות, עם שתיים * או _אם הוא עטוף, הוא יומר ל <strong>,לְמָשָׁל:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
יהפוך ל:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
אתה יכול להשתמש באיזה סגנון שאתה אוהב, המגבלה היחידה היא שאתה יכול לפתוח את התג עם איזה סמל אתה רוצה לסיים אותו.
ניתן להוסיף דגש ישירות באמצע הטקסט:
un*frigging*believable
אבלאם שלך * ו - _ אם יש רווחים לבנים בשני הצדדים, הם רק מטופלים כסמלים רגילים.
כדי להוסיף כוכביות רגילות או קווים תחתונים ישירות לפני ואחרי טקסט, אתה יכול להשתמש בקו נטוי אחורי:
\*this text is surrounded by literal asterisks\*
קוד
אם אתה רוצה לסמן חתיכה קטנה של קוד מוטבע, אתה יכול לעטוף אותו ב-backticks (`),לְמָשָׁל:
Use the `printf()` function.
יפיק:
<p>Use the <code>printf()</code> function.</p>
אם ברצונך להכניס סימנים לאחור בתוך קטע קוד, אתה יכול להתחיל ולסיים את קטע הקוד עם מספר סימנים לאחור:
``There is a literal backtick (`) here.``
תחביר זה מייצר:
<p><code>There is a literal backtick (`) here.</code></p>
אתה יכול לשים ריק בהתחלה ובסוף של קטע קוד, אחד אחרי ההתחלה ואחד לפני הסוף, כך שאתה יכול להכניס סימנים לאחור בתחילת הקטע:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
יפיק:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
בתוך קטע הקוד,& וסוגרי זווית都יומר אוטומטית לישויות HTML, מה שמקל על הוספת קוד מקור HTML, Markdown ישים את הפסקה הבאה:
Please don't use any `<blink>` tags.
ל:
<p>Please don't use any <code><blink></code> tags.</p>
אתה יכול גם לכתוב את זה:
`—` is the decimal-encoded equivalent of `—`.
כדי לייצר:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
ברור שקשה לעצב תחביר "טבעי" להכנסת תמונות ביישום טקסט בלבד.
Markdown משתמש בתחביר הדומה לקישורים לסימון תמונות, ומאפשר גם שני סגנונות: בשורהו -התייחסות.
תחביר התמונה המוטבע נראה כך:
הפרטים הם כדלקמן:
- סימן קריאה
! - ואחריו סוגר מרובע עם טקסט חלופי לתמונה
- לאחר מכן מופיעים סוגריים רגילים עם כתובת האתר של התמונה, ולבסוף טקסט 'כותרת' אופציונלי מוקף במירכאות.
תחביר תמונת ההפניה נראה כך:
![Alt text][id]
"id" הוא השם של הפניה לתמונה, המוגדרת באותו אופן כמו הפניה לקישור:
[id]: url/to/image "Optional title attribute"
עד כה, ל-Markdown אין דרך לציין את הרוחב והגובה של התמונה, אם אתה צריך, אתה יכול להשתמש ברגיל <img> תווית.
其它
קישור אוטומטי
Markdown תומך בעיבוד כתובות URL ותיבות דואר אלקטרוני בצורה של קישורים אוטומטיים קצרים יחסית. כל עוד הם מוקפים בסוגריים זווית, Markdown ימיר אותו אוטומטית לקישור.טקסט הקישור של כתובת האתר הכללית זהה לכתובת הקישור, לדוגמה:
<http://example.com/>
Markdown יומר ל:
<a href="http://example.com/">http://example.com/</a>
הקישור האוטומטי של כתובות דוא"ל דומה גם הוא, פרט לכך ש-Markdown יבצע תחילה תהליך המרת קידוד, תוך המרת תווי טקסט לישויות HTML הקסדצימליות. פורמט זה יכול לרמות כמה רובוטים גרועים לאיסוף כתובות דוא"ל, כגון:
<[email protected]>
Markdown יהפוך ל:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
בדפדפן, המחרוזת הזו (למעשה <a href="mailto:[email protected]">[email protected]</a>) הופך לקישור "[email protected]" שניתן ללחוץ עליו.
(למרות שגישה זו יכולה לשטות בהרבה רובוטים, היא לא יכולה לעצור את כולם, אבל זה עדיף מכלום. בכל מקרה, פתיחת תיבת הדואר שלך תמשוך בסופו של דבר מכתבי פרסום).
מַהֲלָך סְרָק
Markdown יכול להשתמש באלכסונים אחוריים כדי להוסיף סמלים שיש להם משמעויות אחרות בדקדוק, לדוגמה: אם ברצונך להוסיף כוכבית לצד הטקסט לצורך הדגשה (אבל לא <em> תג), אתה יכול להקדים את הכוכבית עם קו נטוי אחורי:
\*literal asterisks\*
Markdown תומך בסמלים הבאים שלפניהם נטוי אחורי כדי לעזור בהוספת סמלים נפוצים:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号עורך Markdown בחינם
פלטפורמת Windows
פלטפורמת Mac
עורך מקוון
תוסף לדפדפן
*** אם יש עורך Markdown חינמי טוב יותר להמליץ עליו, אנא שימו לב למשובצ'ן וייליאנג,תודה!
Hope Chen Weiliang בלוג ( https://www.chenweiliang.com/ ) shared "מה המשמעות של Markdown? כיצד להשתמש בתחביר/עיצוב של Markdown? , לעזור לך.
מוזמנים לשתף את הקישור של מאמר זה:https://www.chenweiliang.com/cwl-482.html