וואָס טוט מאַרקדאַון מיינען? ווי צו נוצן מאַרקדאַון סינטאַקס / פאָרמאַטטינג מאַרקאַפּ?

מאַרקדאָווןוואס מיינט?

ווי צו נוצן מאַרקדאַון סינטאַקס / פאָרמאַטטינג מאַרקאַפּ?

איבערבליק

מאַרקדאַון איז אַ לייטווייט מאַרקאַפּ שפּראַך באשאפן דורך John Gruber.

עס אַלאַוז מענטשן צו "שרייַבן דאָקומענטן אין אַ קלאָר טעקסט פֿאָרמאַט וואָס איז גרינג צו לייענען און שרייַבן, און דאַן גער זיי אין גילטיק XHTML (אָדער HTML) דאָקומענטן".

די שפּראַך ינקאָרפּערייץ פילע פון ​​די פֿעיִקייטן פון קלאָר טעקסט מאַרקאַפּ שוין געפֿונען אין E- פּאָסט.

יוחנן גרובער האָט באשאפן די מאַרקדאַון שפּראַך אין 2004, אין מיטאַרבעט מיט אהרן סוואַרץ אין גרויס טייל אויף דער סינטאַקס.דער ציל פון דער שפּראַך איז צו נוצן "אַ קלאָר טעקסט פֿאָרמאַט וואָס איז גרינג צו לייענען, גרינג צו שרייַבן, און אַפּשאַנאַל קאַנווערץ צו גילטיק XHTML (אָדער HTML)".

ציל

דער ציל פון מאַרקדאַון איז צו זיין "גרינג צו לייענען און גרינג צו שרייַבן".

רידאַביליטי, טאָן עס סייַ ווי סייַאינטערנעט מאַרקעטינג, באַניצער דערפאַרונג איז זייער וויכטיק.

א דאָקומענט געשריבן אין מאַרקדאַון זאָל קענען זיין ארויס גלייך אין קלאָר טעקסט, און זאָל נישט דערשייַנען צו זיין קאַמפּאָוזד פון פילע טאַגס אָדער פאָרמאַטטינג דיירעקטיווז.

מאַרקדאַון סינטאַקס איז ינפלואַנסט דורך עטלעכע יגזיסטינג טעקסט-צו-HTML פֿאָרמאַטירונגען, אַרייַנגערעכנט סעטעקסט, אַטקס, טעקסטילע, רעסטרוקטורעדטעקסט, Grutatext און EtText, אָבער די ביגאַסט מקור פון ינספּיראַציע איז די קלאָר טעקסט E- בריוו פֿאָרמאַט.

אין קורץ, די סינטאַקס פון מאַרקדאָוון איז אַלע קאַמפּאָוזד פון סימבאָלס, וואָס זענען קערפאַלי אויסגעקליבן און זייער פאַנגקשאַנז זענען קלאָר אין אַ בליק.פֿאַר בייַשפּיל: שטעלן אַסטעריסקס אַרום טעקסט צו מאַכן עס קוקן ווי * טראָפּ *.

רשימות אין מאַרקדאָוון קוק ווי, נו, רשימות. בלאַקקוואָטעס אין מאַרקדאָוון טאַקע קוק ווי ציטירן אַ שטיק פון טעקסט, ווי איר האָט געזען אין ימיילז.

קאַמפּאַטאַבאַל מיט HTML

דער ציל פון די מאַרקדאַון גראַמאַטיק איז צו זיין אַ שרייבן שפּראַך פֿאַר די וועב.

מאַרקדאַון איז נישט מענט צו פאַרבייַטן HTML, אָדער אפילו קומען נאָענט צו עס, עס האט זייער ווייניק טייפּס פון סינטאַקס און קאָראַספּאַנדז צו בלויז אַ קליין סאַבסעט פון HTML מאַרקאַפּ. מאַרקדאַון איז נישט קאַנסיווד צו מאַכן HTML דאָקומענטן גרינגער צו שרייַבן.

אין מיין מיינונג, HTML איז שוין גרינג צו שרייַבן. דער געדאַנק פון מאַרקדאַון איז צו מאַכן דאָקומענטן גרינגער צו לייענען, שרייַבן און טוישן ווי איר ווילט. HTML איז אַ ארויסגעבן פֿאָרמאַט, מאַרקדאַון איז אַקאַפּירייטינגגעשריבן פֿאָרמאַט.ווי אַזאַ, מאַרקדאָוון ס פאָרמאַטטינג סינטאַקס קאָווערס בלויז וואָס קלאָר טעקסט קענען.

טאַגס וואָס זענען נישט באדעקט דורך מאַרקדאַון קענען זיין געשריבן אין HTML גלייַך אין דעם דאָקומענטוועב פּראַמאָושאַןקאָפּיע.עס איז ניט דאַרפֿן צו צייכן דעם ווי HTML אָדער מאַרקדאָוון; נאָר לייגן די מאַרקאַפּ גלייַך.

בלויז עטלעכע HTML בלאָק עלעמענטן צו זיין קאַנסטריינד - אַזאַ ווי <div>,<table>,<pre>,<p> און אנדערע טאַגס, זיי מוזן זיין אפגעשיידט פון אנדערע אינהאַלט געביטן מיט ליידיק שורות איידער און נאָך, און זייער עפן און קלאָוזינג טאַגס מוזן נישט זיין ינדענטיד מיט טאַבס אָדער ספּייסאַז. די מאַרקדאָוון גענעראַטאָר איז קלוג גענוג צו לייגן ומנייטיק HTML בלאָק טאַגס <p> לאַבעל.

דער ביישפּיל איז ווי גייט, אַדינג אַ HTML טיש צו די מאַרקדאָוון טעקע:

这是一个普通段落。

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

这是另一个普通段落。

באַמערקונג אַז מאַרקדאָוון פאָרמאַטטינג סינטאַקס צווישן HTML בלאָק טאַגס וועט נישט זיין פּראַסעסט.פֿאַר בייַשפּיל, אויב איר נוצן מאַרקדאָוון נוסח אין HTML בלאַקס*强调*וועט נישט האָבן קיין ווירקונג.

HTML אָפּטיילונג (ינלינע) טאַגס אַזאַ ווי <span>,<cite>,<del> קענען זיין פריי אין מאַרקדאָוון פּאַראַגראַפס, רשימות אָדער כעדינגז.לויט צו פּערזענלעך געוווינהייטן, איר קענען אפילו נוצן HTML טאַגס צו פֿאָרמאַט אָן ניצן מאַרקדאָוון פֿאָרמאַט.בייַשפּיל: אויב איר בעסער HTML <a> אָדער <img> טאַגס, וואָס קענען זיין געוויינט גלייך אָן די לינק אָדער בילד קוויטל סינטאַקס צוגעשטעלט דורך Markdown.

ניט ענלעך צווישן HTML בלאָק טאַגס, מאַרקדאָוון סינטאַקס איז גילטיק צווישן HTML אָפּטיילונג טאַגס.

אָטאַמאַטיק קאַנווערזשאַן פון ספּעציעל אותיות

אין HTML טעקעס, עס זענען צוויי אותיות וואָס דאַרפן ספּעציעל האַנדלינג: < 和 & . < סימבאָלס זענען געניצט פֿאַר אָנהייב טאַגס,& סימבאָלס זענען געניצט צו צייכן HTML ענטיטיז, אויב איר נאָר ווילן צו ווייַזן די פּראָוטאַטייפּ פון די אותיות, איר מוזן נוצן די ענטיטי פאָרעם, ווי < 和 &.

& אותיות זענען ספּעציעל מאַטערן פֿאַר וועב דאָקומענט שרייבערס, אויב איר 'רע געגאנגען צו דרוקן "AT&T", איר מוזן שרייַבן "AT&T".אין די URL & אותיות זענען אויך קאָנווערטעד.פֿאַר בייַשפּיל איר ווילן צו לינק צו:

http://images.google.com/images?num=30&q=larry+bird

איר מוזן שרייַבן די URL קאַנווערזשאַן ווי:

http://images.google.com/images?num=30&q=larry+bird

צו זיין געשטעלט אין די לינק קוויטל href אין פאַרמאָג.יבעריק צו זאָגן, דאָס איז גרינג צו איגנאָרירן, און מיסטאָמע די גרעסטע נומער פון ערראָרס דיטעקטאַד דורך וואַלאַדיישאַן פון HTML סטאַנדאַרדס.

מאַרקדאַון אַלאַוז איר צו שרייַבן אותיות געוויינטלעך, און עס נעמט זאָרג פון וואָס דאַרף זיין קאָנווערטעד.אויב איר נוצן & א כאַראַקטער איז טייל פון אַ HTML כאַראַקטער ענטיטי, עס איז לינקס ווי איז, אַנדערש עס איז קאָנווערטעד צו &;.

אַזוי אויב איר ווילן צו אַרייַנלייגן אַ קאַפּירייט סימבאָל אין דעם דאָקומענט ©, איר קענען שרייַבן:

©

מאַרקדאַון וועט לאָזן עס אַנטאַטשט.און אויב איר שרייבט:

AT&T

מאַרקדאַון וועט גער עס צו:

AT&T

א ענלעך סיטואַציע אַקערז אויך אין < נאָוטיישאַן, זינט מאַרקדאָוון אַלאַוז HTML קאַמפּאַטאַבילאַטי, אויב איר שטעלן < סימבאָלס זענען געניצט ווי דעלימאַטערז פֿאַר HTML טאַגס, און מאַרקדאָוון וועט נישט טאָן קיין קאַנווערזשאַנז אויף זיי, אָבער אויב איר שרייַבן:

4 < 5

מאַרקדאַון וועט גער עס צו:

4 < 5

אָבער, עס זאָל זיין אנגעוויזן אַז אין די פאַרנעם פון קאָד, צי עס איז ינלינע אָדער בלאָק, < 和 & ביידע סימבאָלסמוזזענען קאָנווערטעד צו HTML ענטיטיז, אַ שטריך וואָס אַלאַוז איר צו לייכט שרייַבן HTML קאָד אין מאַרקדאַון (ווי קעגן צו HTML, ווו איר שטעלן אַלע די < 和 & אַלע זענען קאָנווערטעד אין HTML ענטיטיז, אין סדר צו שרייַבן HTML קאָד אין די HTML טעקע. )

בלאָק עלעמענט

פּאַראַגראַפס און שורה ברייקס

א מאַרקדאַון פּאַראַגראַף באשטייט פון איין אָדער מער קאָנסעקוטיווע שורות פון טעקסט, פּריסידאַד און נאכגעגאנגען דורך מער ווי איין ליידיק שורה (די דעפֿיניציע פון ​​אַ ליידיק שורה איז אַז עס איז ליידיק אויף די אַרויסווייַזן און איז געהאלטן אַ ליידיק שורה. פֿאַר בייַשפּיל, , אויב אַ שורה כּולל בלויז ספּייסאַז און טאַבס, די שורה וועט אויך זיין באהאנדלט ווי אַ ליידיק שורה).נאָרמאַל פּאַראַגראַפס זאָל ניט זיין ינדענטיד מיט ספּייסאַז אָדער טאַבס.

די פראַזע "באשטייט פון איין אָדער מער קאָנסעקוטיווע שורות פון טעקסט" אַקשלי ימפּלייז אַז מאַרקדאַון אַלאַוז געצווונגען נעוולינעס (ינסערשאַן פון נולינעס) אין פּאַראַגראַפס, אַ שטריך וואָס איז אַנדערש פון רובֿ אנדערע טעקסט-צו-HTML פֿאָרמאַטירונגען (אַרייַנגערעכנט מאָוואַבלע טיפּ "קאָנווערט ליניע ברייקס). " אָפּציע), אנדערע פֿאָרמאַטירונגען גער יעדער שורה ברעכן צו <br /> לאַבעל.

אויב דוטאקעווילן צו פאַרלאָזנ אויף Markdown צו אַרייַנלייגן <br /> פֿאַר לאַבעלס, דריקן צוויי אָדער מער ספּייסאַז בייַ די ינסערשאַן אָרט און דריקן אַרייַן.

טאַקע, עס נעמט אַ ביסל מער אַרבעט (נאָך ספּייסאַז) צו דזשענערייט <br /> , אָבער פשוט "יעדער ניילינע איז קאָנווערטעד צו <br />"דער אופֿן איז נישט פּאַסיק אין מאַרקדאַון, אין מאַרקדאַוןaiל-נוסח בלאַקקוואָטעס און מאַלטי-פּאַראַגראַף רשימות זענען נישט בלויז מער נוציק, אָבער אויך גרינגער צו לייענען ווען טיפּינג מיט שורה ברייקס.

טיטל

מאַרקדאַון שטיצט צוויי סינטאַקסיז פֿאַר כעדינגז, סעטעקסט-ווי און אַטקס-ווי.

די סעטטעקסט-ווי פאָרעם איז די פאָרעם מיט די דנאָ שורה, ניצן = (העכסטן טיטל) און - (צווייטע סדר כעדינגז), פֿאַר בייַשפּיל:

This is an H1
=============

This is an H2
-------------

קיין סומע = 和 - קענען זיין עפעקטיוו.

די אַטקס-ווי פאָרעם ינסערץ 1 צו 6 אין די אָנהייב פון די שורה # , קאָראַספּאַנדינג צו כעדינגז 1 צו 6, פֿאַר בייַשפּיל:

# 这是 H1

## 这是 H2

###### 这是 H6

איר קענען אָפּטיאָנאַללי "נאָענט" אַטקס-ווי כעדינגז, דאָס איז ריין פֿאַר עסטעטיק, אויב איר פילן באַקוועם אויף דעם וועג, איר קענען לייגן עס אין די סוף פון די שורה #, בשעת די שורה ענדס # די נומער טוט נישט האָבן צו זיין די זעלבע ווי די אָנהייב (די נומער פון פונט אותיות אין די אָנהייב פון די שורה דיטערמאַנז די סדר פון דעם טיטל):

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

בלאַקקוואָטעס בלאָקקוואָטעס

מאַרקדאָוון מאַרקאַפּ בלאַקקוואָטעס זענען געניצט ענלעך צו די געניצט אין E- בריוו > פון סייטיישאַנז.אויב איר זענט באַקאַנט מיט ציטירט אין E- בריוו אותיות, איר וויסן ווי צו שאַפֿן אַ בלאָק ציטירן אין אַ מאַרקדאָוון טעקע, וואָס וואָלט קוקן ווי איר ברעכן די שורות זיך, און לייגן > :

> 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 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.

אנדערע מאַרקדאָוון סינטאַקסיז קענען אויך זיין געוויינט אין ציטירטן בלאַקס, אַרייַנגערעכנט כעדינגז, רשימות, קאָד בלאַקס, אאז"ו ו:

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

קיין לייַטיש טעקסט רעדאַקטאָר קענען לייכט שאַפֿן E- בריוו-נוסח סייטיישאַנז.פֿאַר בייַשפּיל אין BBEdit איר קענען אויסקלייַבן טעקסט און דעמאָלט קלייַבן פון די מעניופאַרגרעסערן ציטירן כייעראַרקי.

רשימה

מאַרקדאַון שטיצט אָרדערד און אַנאָרדערד רשימות.

ונאָרדערעד רשימות נוצן אַסטעריסקס, פּלוס וואונדער, אָדער מינוס וואונדער ווי רשימה מאַרקערס:

*   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 רעזולטאַט.די פונט איז אַז איר קענען מאַכן די רשימה נומערן אין די מאַרקדאָוון טעקע די זעלבע ווי די רעזולטאַט רעזולטאַטן, אָדער אויב איר זענט פויל, איר טאָן ניט דאַרפֿן צו זאָרגן וועגן די ריכטיק פון די נומערן.

אויב איר נוצן פויל שרייבן, עס איז רעקאַמענדיד צו אָנהייבן מיט 1. פֿאַר דער ערשטער נומער, ווייַל מאַרקדאָוון קען שטיצן די אָנהייב אַטריביוט פון אָרדערד רשימות אין דער צוקונפֿט.

דער רשימה נומער קוויטל איז יוזשאַוואַלי געשטעלט אויף די ווייַט לינקס, אָבער עס קענען זיין ינדענטיד, אַרויף צו 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.

אויב די רשימה ייטאַמז זענען אפגעשיידט דורך ליידיק שורות, מאַרקדאָוון וועט נוצן די אינהאַלט פון די נומער ווען אַוטפּוץ 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 קוויטל:

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> טאַגס צו ייַנוויקלען קאָד בלאַקס.

שאפן קאָד בלאַקס אין מאַרקדאַון איז ווי פּשוט ווי ינדענטינג 4 ספּייסאַז אָדער 1 קוויטל. למשל, אַרייַן די פאלגענדע:

这是一个普通段落：

    这是一个代码区块。

מאַרקדאַון וועט קאָנווערט צו:

<p>这是一个普通段落：</p>

<pre><code>这是一个代码区块。
</code></pre>

דער ערשטער-סדר ינדענטיישאַן פּער שורה (4 ספּייסאַז אָדער 1 קוויטל) איז אַוועקגענומען, פֿאַר בייַשפּיל:

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 ענטיטיז, דער מעטאָד מאכט עס זייער גרינג פֿאַר איר צו נוצן מאַרקדאַון צו אַרייַנלייגן די HTML מקור קאָד פֿאַר דעם בייַשפּיל, נאָר נאָכמאַכן און פּאַפּ עס, לייגן ינדענטיישאַן, און די מנוחה מאַרקדאָוון וועט שעפּן עס פֿאַר איר, פֿאַר בייַשפּיל:

    <div class="footer">
        © 2004 Foo Corporation
    </div>

וועט זיין קאָנווערטעד צו:

<pre><code><div class="footer">
    &copy; 2004 Foo Corporation
</div>
</code></pre>

אין די קאָד בלאָק, דער גענעראַל מאַרקדאָוון סינטאַקס וועט נישט זיין קאָנווערטעד, אַזאַ ווי אַסטעריסקס זענען נאָר אַסטעריסקס, וואָס מיטל אַז איר קענען לייכט שרייַבן מאַרקדאָוון סינטאַקס פֿאַרבונדענע טעקעס אין מאַרקדאָוון סינטאַקס.

צעטיילונג

איר קענען מאַכן אַ דיווידער מיט מער ווי דרייַ אַסטעריסקס, מינוס וואונדער, אַנדערקאָרז אין אַ שורה, גאָרנישט אַנדערש אין די שורה.איר קענען אויך אַרייַנלייגן ספּייסאַז צווישן אַסטעריסקס אָדער מינוס וואונדער.סעפּאַראַטיאָן שורות קענען זיין באשאפן אין יעדער פון די פאלגענדע וועגן פון שרייבן:

* * *

***

*****

- - -

---------------------------------------

אָפּטיילונג עלעמענט

לינק

מאַרקדאַון שטיצט צוויי פארמען פון לינק סינטאַקס: אין ליניע和רעפערענץצוויי פארמען.

אָדער וועג, לינק טעקסט איז אנגעצייכנט מיט [קוואַדראַט בראַקאַץ].

צו שאַפֿן אַאין ליניעאויב איר ווילן צו לייגן דעם טיטל טעקסט פון די לינק, נאָר ייַנוויקלען דעם טיטל טעקסט מיט טאָפּל ציטאַט מאַרקס נאָך די URL, פֿאַר בייַשפּיל:

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"

לינק אינהאַלט איז דיפיינד אין די פאָרעם:

• קוואַדראַט בראַקאַץ (אַפּשאַנאַל פּריסידאַד דורך אַרויף צו דריי ספּייסאַז פֿאַר ינדענטיישאַן) אין וואָס לינק טעקסט איז אריין
• נאכגעגאנגען דורך אַ צווייפּינטל
• נאכגעגאנגען דורך איינער אָדער מער ספּייסאַז אָדער טאַבס
• די URL פון די ווייַטער לינק
• אָפּטיאָנאַללי נאָכגיין דעם טיטל אינהאַלט, וואָס קענען זיין ענקלאָוזד אין איין קוואָטעס, טאָפּל קוואָטעס אָדער קלאַמערן

די דעפֿיניציע פון ​​די פאלגענדע דריי לינקס זענען די זעלבע:

[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 יגנאָרז לינק טיטלען ענקלאָוזד אין איין קוואָטעס.

לינק URL ס קענען אויך זיין ענקלאָוזד אין ווינקל בראַקאַץ:

[id]: <http://example.com/>  "Optional Title Here"

איר קענט אויך שטעלן דעם טיטל אַטריביוט אויף דער ווייַטער שורה, אָדער לייגן עטלעכע ינדענטיישאַן, וואָס וועט קוקן בעסער אויב די URL איז צו לאַנג:

[id]: http://example.com/longish/path/to/resource/here
    "Optional Title Here"

URL דעפֿיניציע זענען בלויז געניצט ווען דזשענערייטינג לינקס, און טאָן ניט דערשייַנען גלייַך אין דער טעקע.

לינק לעגיטימאַציע טאַגס קען אַנטהאַלטן אותיות, נומערן, ווייַס ספּייס און פּונקטואַציע, אָבער טאָן ניטנייןעס איז פאַל-שפּירעוודיק, אַזוי די פאלגענדע צוויי לינקס זענען די זעלבע:

[link text][a]
[link text][A]

ימפּליסאַט לינק קוויטלשטריך אַלאַוז איר צו פאַרלאָזן ספּעציפיצירן אַ לינק קוויטל. אין דעם פאַל, די לינק קוויטל וועט זיין באהאנדלט ווי עקוויוואַלענט צו די לינק טעקסט. צו נוצן אַ ימפּליסאַט לינק קוויטל, נאָר לייגן אַ ליידיק קוואַדראַט קלאַמער נאָך די לינק טעקסט. אויב איר ווילן "Google " פֿאַרבינדונג צו 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>

ונטער איז אַ מאַרקדאָוון טעקע פון ​​דער זעלביקער אינהאַלט געשריבן ינלינע, צוגעשטעלט פֿאַר פאַרגלייַך:

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 אותיות. , אויב עס איז געשריבן אין ריין HTML פֿאָרמאַט, עס וועט זיין 176 אותיות. אין HTML פֿאָרמאַט, עס זענען מער טאַגס ווי טעקסט.

ניצן מאַרקדאַון ס רעפֿערענץ-נוסח פֿאַרבינדונגען קענען מאַכן דעם דאָקומענט מער ווי די לעצט רעזולטאַט פון דעם בלעטערער, ​​אַלאַוינג איר צו מאַך עטלעכע מאַרקאַפּ-פֿאַרבונדענע מעטאַדאַטאַ אַרויס די פּאַראַגראַף טעקסט, און איר קענען לייגן לינקס אָן מאַכן דעם אַרטיקל לייענען.

强调

מאַרקדאַון ניצט אַסטעריסקס (*) און די דנאָ שורה (_) ווי אַ סימבאָל צו צייכן אַן אַנדערליינד וואָרט, איז * אָדער _ סעראַונדאַד ווערטער זענען קאָנווערטעד צו <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\*

קאָדעקס

אויב איר ווילן צו צייכן אַ קליין שטיק פון ינלינע קאָד, איר קענען ייַנוויקלען עס אין באַקטיקקס (`), למשל:

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>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

图片

דאָך, עס איז שווער צו פּלאַן אַ "נאַטירלעך" סינטאַקס פֿאַר ינסערטינג בילדער אין אַ טעקסט-בלויז אַפּלאַקיישאַן.

מאַרקדאַון ניצט אַ סינטאַקס ענלעך צו פֿאַרבינדונגען צו צייכן בילדער, און אויך אַלאַוז צוויי סטיילז: אין ליניע和רעפערענץ.

די ינלינע בילד סינטאַקס קוקט ווי:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

דעטאַילס זענען ווי גייט:

• אַ אויסרוף !
• נאכגעגאנגען דורך אַ קוואַדראַט קלאַמער מיט אַלט טעקסט פֿאַר די בילד
• דערנאָך אַ נאָרמאַל קלאַמער, שטעלן די URL פון די בילד ין, און לעסאָף ייַנוויקלען עס אין קוואָטעס און לייגן אַ אַפּשאַנאַל 'טיטל' טעקסט.

דער רעפֿערענץ בילד סינטאַקס קוקט ווי דאָס:

![Alt text][id]

"יד" איז דער נאָמען פון די בילד רעפֿערענץ, וואָס איז דיפיינד אין די זעלבע וועג ווי אַ לינק רעפֿערענץ:

[id]: url/to/image  "Optional title attribute"

ביז איצט, Markdown האט קיין וועג צו ספּעציפיצירן די ברייט און הייך פון די בילד, אויב איר דאַרפֿן, איר קענען נוצן די נאָרמאַל <img> לאַבעל.

其它

אַוטאָ לינק

מאַרקדאַון שטיצט פּראַסעסינג URL ס און ימיילז אין די פאָרעם פון קורץ אָטאַמאַטיק פֿאַרבינדונגען.ווי לאַנג ווי זיי זענען ענקלאָוזד אין ווינקל בראַקאַץ, מאַרקדאַון וועט אויטאָמאַטיש קאָנווערט עס אין אַ לינק.דער לינק טעקסט פון אַ גענעראַל URL איז די זעלבע ווי די לינק אַדרעס, למשל:

<http://example.com/>

מאַרקדאַון וועט זיין קאָנווערטעד צו:

<a href="http://example.com/">http://example.com/</a>

די אָטאַמאַטיק פֿאַרבינדונג פון בליצפּאָסט אַדרעסעס איז אויך ענלעך, אַחוץ אַז Markdown וועט ערשטער דורכפירן אַ קאָדירונג קאַנווערזשאַן פּראָצעס, קאַנווערטינג טעקסט אותיות אין העקסאַדעסימאַל HTML ענטיטיז. דער פֿאָרמאַט קענען נאַרן עטלעכע שלעכט E- בריוו אַדרעס זאַמלונג ראָובאַץ, אַזאַ ווי:

<[email protected]>

מאַרקדאַון וועט קער אין:

<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>

אין דעם בלעטערער, ​​דעם שטריקל (אַקשלי <a href="mailto:[email protected]">[email protected]</a>) ווערט אַ קליקקאַבלע "[email protected]" לינק.

(כאָטש דער צוגאַנג קען נאַרן אַ פּלאַץ פון ראָובאַץ, עס קען נישט האַלטן זיי אַלע, אָבער עס איז בעסער ווי גאָרנישט. אין קיין פאַל, עפן דיין בריווקאַסטן וועט יווענטשאַוואַלי צוציען גאַנצע בריוו.)

צוריק צעהאַקן

מאַרקדאַון קענען נוצן באַקלאַשיז צו אַרייַנלייגן סימבאָלס וואָס האָבן אנדערע מינינגז אין די גראַמאַטיק, למשל: אויב איר ווילן צו לייגן אַן אַסטעריסק ווייַטער צו דעם טעקסט פֿאַר טראָפּ (אָבער נישט <em> טאַג), איר קענען פאָרויס די אַסטעריסק מיט אַ צוריק צעהאַקן:

\*literal asterisks\*

מאַרקדאַון שטיצט די פאלגענדע סימבאָלס פּריסידאַד דורך אַ באַקלאַש צו העלפן אַרייַנלייגן פּראָסט סימבאָלס:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

מאַרקדאַון פריי רעדאַקטאָר

Windows פּלאַטפאָרמע

• מאַרקדאָוון פּאַד
• מאַרקפּאַד

מעק פּלאַטפאָרמע

• ווייך

אָנליין רעדאַקטאָר

• MPEditor

בלעטערער פּלוגין

• מאַרקדאַון דאָ פּלוגין

*** אויב עס איז אַ בעסער פריי מאַרקדאָוון רעדאַקטאָר צו רעקאָמענדירן, ביטע באַצאָלן ופמערקזאַמקייט צו באַמערקונגעןChen Weiliang, א דאנק !