Markdown ina maana gani Jinsi ya kutumia syntax ya Markdown / markup ya umbizo?

MchapishajiIna maana gani?

Jinsi ya kutumia syntax ya Markdown / markup ya umbizo?

Maelezo ya jumla

Markdown ni lugha nyepesi ya markup iliyoundwa na John Gruber.

Inaruhusu watu "kuandika hati katika umbizo la maandishi wazi ambalo ni rahisi kusoma na kuandika, na kisha kuzibadilisha kuwa hati halali za XHTML (au HTML)".

Lugha imechukua vipengele vingi vya maandishi wazi ambayo tayari yamepatikana katika barua pepe.

John Gruber aliunda lugha ya Markdown mnamo 2004, kwa ushirikiano na Aaron Swartz kwa sehemu kubwa kwenye sintaksia.Madhumuni ya lugha ni kutumia "umbizo la maandishi wazi ambalo ni rahisi kusoma, rahisi kuandika, na kwa hiari kubadilisha hadi XHTML halali (au HTML)".

kusudi

Lengo la Markdown ni kuwa "rahisi kusoma na rahisi kuandika".

usomaji, fanya hivyo hivyoUuzaji wa mtandao, uzoefu wa mtumiaji ni muhimu sana.

Hati iliyoandikwa katika Markdown inapaswa kuchapishwa moja kwa moja kwa maandishi wazi, na haipaswi kuonekana kuwa inajumuisha lebo nyingi au maagizo ya uumbizaji.

Sintaksia ya Markdown inaathiriwa na baadhi ya miundo iliyopo ya maandishi-hadi-HTML, ikiwa ni pamoja na Setext, atx, Textile, reStructuredText, Grutatext, na EtText, lakini chanzo kikubwa cha msukumo ni umbizo la barua pepe la maandishi wazi.

Kwa kifupi, syntax ya Markdown yote inajumuisha alama, ambazo zimechaguliwa kwa uangalifu na kazi zao ni wazi kwa mtazamo.Kwa mfano: weka nyota karibu na maandishi ili kuifanya ionekane kama *msisitizo*.

Orodha katika Markdown inaonekana kama, vizuri, orodha. Nukuu za kuzuia katika Markdown kwa kweli zinaonekana kama kunukuu kipande cha maandishi, kama vile ulivyoona kwenye barua pepe.

Sambamba na HTML

Lengo la sarufi ya Markdown ni kuwa lugha ya kuandika kwa wavuti.

Markdown haikusudiwi kuchukua nafasi ya HTML, au hata kuja karibu nayo, ina aina chache sana za sintaksia na inalingana na sehemu ndogo tu ya markup ya HTML. Markdown haikuundwa ili kurahisisha kuandika hati za HTML.

Kwa maoni yangu, HTML tayari ni rahisi kuandika. Wazo la Markdown ni kufanya hati ziwe rahisi kusoma, kuandika, na kubadilisha kwa mapenzi. HTML ni umbizo la uchapishaji, Markdown ni aUandishi wa nakalamuundo ulioandikwa.Kwa hivyo, syntax ya umbizo la Markdown inashughulikia tu kile ambacho maandishi wazi yanaweza.

Lebo ambazo hazijafunikwa na Markdown zinaweza kuandikwa katika HTML moja kwa moja kwenye hatiUkuzaji wa Wavutinakala.Hakuna haja ya kuweka alama hii kama HTML au Markdown; ongeza tu alama moja kwa moja.

Baadhi tu ya vipengee vya uzuiaji wa HTML vinapaswa kubanwa - kama vile <div>,<table>,<pre>,<p> na vitambulisho vingine, lazima vitenganishwe na maeneo mengine ya maudhui kwa mistari tupu kabla na baada, na vitambulisho vyao vya kufungua na kufunga havipaswi kuingizwa kwa tabo au nafasi. Jenereta ya Markdown ni mahiri vya kutosha kuongeza vitambulisho visivyo vya lazima vya HTML <p> Lebo.

Mfano ni kama ifuatavyo, kuongeza jedwali la HTML kwenye faili ya Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Kumbuka kuwa sintaksia ya umbizo la Markdown kati ya vitambulisho vya kuzuia HTML haitachakatwa.Kwa mfano, ikiwa unatumia mtindo wa Markdown ndani ya kizuizi cha HTML*强调*haitakuwa na athari.

tagi za sehemu ya HTML (za ndani) kama vile <span>,<cite>,<del> Inaweza kutumika kwa uhuru katika aya za Markdown, orodha au vichwa.Kulingana na tabia za kibinafsi, unaweza kutumia hata lebo za HTML kufomati bila kutumia umbizo la Markdown.Mfano: Ikiwa unapendelea HTML <a> Au <img> vitambulisho, ambavyo vinaweza kutumika moja kwa moja bila kiungo au sintaksia ya lebo ya picha iliyotolewa na Markdown.

Tofauti na kati ya vitambulisho vya HTML, syntax ya Markdown ni halali kati ya lebo za sehemu ya HTML.

Ugeuzaji otomatiki wa herufi maalum

Katika faili za HTML, kuna herufi mbili zinazohitaji utunzaji maalum: < Na & . < alama hutumiwa kwa vitambulisho vya kuanza,& Alama hutumiwa kuashiria huluki za HTML, ikiwa unataka tu kuonyesha mfano wa herufi hizi, lazima utumie fomu ya huluki, kama vile < Na &.

& Wahusika wanatesa haswa kwa waandishi wa hati za wavuti, ikiwa utaandika "AT&T", lazima uandike"AT&T".ukiwa kwenye URL & Wahusika pia hubadilishwa.Kwa mfano unataka kuunganisha kwa:

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

Lazima uandike ubadilishaji wa URL kama:

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

kuwekwa kwenye lebo ya kiungo href katika mali.Bila kusema, hii ni rahisi kupuuza, na labda idadi kubwa zaidi ya makosa iliyogunduliwa na uthibitishaji wa viwango vya HTML.

Markdown hukuruhusu kuandika herufi kwa kawaida, na inachukua huduma ya kile kinachohitaji kubadilishwa.ukitumia & Tabia ni sehemu ya huluki ya herufi ya HTML, inaachwa kama ilivyo, vinginevyo inabadilishwa kuwa &;.

Kwa hivyo ikiwa unataka kuingiza alama ya hakimiliki kwenye hati ©, unaweza kuandika:

©

Markdown itaiacha bila kuguswa.Na ikiwa unaandika:

AT&T

Markdown itaibadilisha kuwa:

AT&T

Hali kama hiyo pia hufanyika < nukuu, kwani Markdown inaruhusu utangamano wa HTML, ikiwa utaweka < Alama hutumika kama vikomo vya vitambulisho vya HTML, na Markdown haitafanya ubadilishaji wowote juu yao, lakini ukiandika:

4 < 5

Markdown itaibadilisha kuwa:

4 < 5

Walakini, inapaswa kuzingatiwa kuwa ndani ya wigo wa nambari, iwe ni inline au block, < Na & alama zote mbilikwa hakikahubadilishwa kuwa vyombo vya HTML, kipengele kinachokuruhusu kuandika msimbo wa HTML kwa urahisi katika Markdown (kinyume na HTML, ambapo unaweka < Na & Wote hubadilishwa kuwa vyombo vya HTML, ili kuandika msimbo wa HTML katika faili ya HTML. )

kipengele cha kuzuia

Aya na mapumziko ya mstari

Aya ya Markdown ina mstari mmoja au zaidi mfululizo wa maandishi, unaotanguliwa na kufuatiwa na zaidi ya mstari mmoja tupu (ufafanuzi wa mstari tupu ni kwamba inaonekana kuwa tupu kwenye onyesho na inachukuliwa kuwa mstari tupu. , ikiwa mstari una nafasi na vichupo pekee, mstari pia utachukuliwa kama mstari tupu).Aya za kawaida hazipaswi kuingizwa kwa nafasi au vichupo.

Maneno "ina mstari mmoja au zaidi mfululizo wa maandishi" inamaanisha kuwa Markdown inaruhusu laini mpya za kulazimishwa (uingizaji wa laini mpya) ndani ya aya, kipengele ambacho ni tofauti na muundo mwingine wa maandishi hadi HTML (pamoja na Aina Inayohamishika "Badilisha Migawanyiko ya Mistari. " chaguo), fomati zingine zitabadilisha kila mapumziko ya mstari kuwa <br /> Lebo.

Ikiwa wewekweliUnataka kutegemea Markdown kuingiza <br /> Kwa lebo, bonyeza nafasi mbili au zaidi kwenye mahali pa kupachika kisha ubonyeze Enter.

Hakika, inachukua kazi kidogo zaidi (nafasi za ziada) kutengeneza <br /> , lakini kwa urahisi "kila laini mpya inabadilishwa kuwa <br />"Njia hiyo haifai katika Markdown, em huko MarkdownaiManukuu ya mtindo wa L na orodha za aya nyingi sio tu muhimu zaidi lakini pia ni rahisi kusoma wakati wa kupanga chapa kwa kukatika kwa mistari.

Kichwa

Markdown inasaidia sintaksia mbili za vichwa, Setext-like na atx-like.

Fomu ya Settext ni fomu iliyo na mstari wa chini, kwa kutumia = (kichwa cha juu zaidi) na - (Vichwa vya mpangilio wa pili), kwa mfano:

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

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

kiasi chochote = Na - inaweza kuwa na ufanisi.

Fomu inayofanana na Atx inaingiza 1 hadi 6 mwanzoni mwa mstari # , inayolingana na vichwa 1 hadi 6, kwa mfano:

# 这是 H1

## 这是 H2

###### 这是 H6

Kwa hiari unaweza "kufunga" vichwa kama atx, hii ni ya urembo tu, ikiwa unajisikia vizuri kwa njia hii, unaweza kuiongeza mwishoni mwa mstari. #, wakati mstari unaishia # Nambari sio lazima iwe sawa na mwanzo (idadi ya wahusika pauni mwanzoni mwa mstari huamua mpangilio wa kichwa):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Nukuu za kuzuia alama za chini zinatumika sawa na zile zinazotumiwa kwenye barua pepe > ya manukuu.Ikiwa unajua nukuu katika barua za barua pepe, unajua jinsi ya kuunda nukuu ya kuzuia katika faili ya Markdown, ambayo ingeonekana kama unavunja mistari mwenyewe, kisha ongeza. > :

> 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 pia inakuwezesha kuwa wavivu na kuongeza tu mstari wa kwanza wa aya nzima > :

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

Marejeleo ya kuzuia yanaweza kuwekwa (kwa mfano: marejeleo ndani ya marejeleo) kwa kuongeza idadi tofauti ya > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

Sintaksia zingine za Markdown pia zinaweza kutumika ndani ya vizuizi vilivyonukuliwa, pamoja na vichwa, orodha, vizuizi vya msimbo, n.k.:

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

Kihariri chochote cha maandishi kinachofaa kinaweza kuunda nukuu za mtindo wa barua pepe kwa urahisi.Kwa mfano katika BBEdit unaweza kuchagua maandishi kisha uchague kutoka kwenye menyukuongeza daraja la manukuu.

Orodha

Markdown inasaidia orodha zilizopangwa na zisizopangwa.

Orodha zisizo na mpangilio hutumia nyota, ishara za kuongeza, au ishara za kuondoa kama alama za orodha:

*   Red
*   Green
*   Blue

Sawa na:

+   Red
+   Green
+   Blue

Pia ni sawa na:

-   Red
-   Green
-   Blue

Orodha zilizoagizwa hutumia nambari zinazofuatwa na kipindi:

1.  Bird
2.  McHale
3.  Parish

Ni muhimu kutambua kwamba nambari unazotumia kwenye lebo ya orodha haziathiri matokeo ya HTML. Alama ya matokeo ya HTML ya orodha iliyo hapo juu itakuwa:

<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

Ikiwa orodha yako imeandikwa kama:

1.  Bird
1.  McHale
1.  Parish

au hata:

3. Bird
1. McHale
8. Parish

Nyote wawili mtapata pato sawa la HTML.Jambo ni kwamba, unaweza kufanya nambari za orodha kwenye faili ya Markdown sawa na matokeo ya pato, au ikiwa wewe ni mvivu, hauitaji kujali juu ya usahihi wa nambari hata kidogo.

Ikiwa unatumia uandishi wa uvivu, inashauriwa kuanza na 1. kwa kipengee cha kwanza, kwa sababu Markdown inaweza kusaidia sifa ya mwanzo ya orodha zilizoagizwa katika siku zijazo.

Lebo ya kipengee cha orodha kwa kawaida huwekwa upande wa kushoto kabisa, lakini inaweza kuingizwa ndani, hadi nafasi 3, na lebo ya kipengee lazima ifuatwe na angalau nafasi moja au kichupo.

Ili kufanya orodha ionekane nzuri zaidi, unaweza kupanga yaliyomo kwa ujongezaji usiobadilika:

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

Lakini ikiwa wewe ni mvivu, ni sawa pia:

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

Vipengee vya orodha vikitenganishwa kwa mistari tupu, Markdown itatumia maudhui ya vipengee wakati wa kutoa HTML. <p> Lebo zimefungwa, kwa mfano:

*   Bird
*   Magic

itabadilishwa kuwa:

<ul>
<li>Bird</li>
<li>Magic</li>
</ul>

Lakini hii:

*   Bird

*   Magic

itabadilishwa kuwa:

<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>

Vipengee vya orodha vinaweza kuwa na aya nyingi, na aya chini ya kila kipengee lazima ziingizwe kwa nafasi 4 au kichupo 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.

Inaonekana bora zaidi ikiwa utaingiza kila mstari, kwa kweli, tena, ikiwa wewe ni mvivu, Markdown pia inaruhusu:

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

Ikiwa unataka kuweka rejeleo ndani ya kipengee cha orodha, basi > Inahitaji kuingizwa ndani:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ikiwa unataka kuweka kizuizi cha msimbo, kizuizi kinahitaji kuingizwamara mbili, ambayo ni nafasi 8 au tabo 2:

*   一列表项包含一个列表区块：

        <代码写在这>

Kwa kweli, orodha ya vitu inaweza kuzalishwa kwa bahati mbaya, kitu kama hiki:

1986. What a great season.

Kwa maneno mengine, inaonekana mwanzoni mwa mstarinambari-kipindi-tupu, ili kuepuka hili, unaweza kuongeza backslash kabla ya kipindi.

1986\. What a great season.

kizuizi cha nambari

Maandishi yanayohusiana na programu au msimbo wa chanzo cha lugha ya lebo huwa na vizuizi vya msimbo ambavyo tayari vimepangwa. Kwa kawaida, hatutaki vizuizi hivi viwatwe kwa njia ya faili za aya za jumla, lakini zionyeshe jinsi zilivyo. Markdown itatumia <pre> Na <code> vitambulisho vya kufunga vizuizi vya msimbo.

Vizuizi vya ujenzi wa nambari katika Markdown ni rahisi kama kujongeza nafasi 4 au tabo 1, kwa mfano, ingiza zifuatazo:

这是一个普通段落：

    这是一个代码区块。

Markdown itabadilika kuwa:

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

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

Ujongezaji huu wa mpangilio wa kwanza kwa kila mstari (nafasi 4 au kichupo 1) huondolewa, kwa mfano:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

itabadilishwa kuwa:

<p>Here is an example of AppleScript:</p>

<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

Kizuizi cha nambari kinaendelea hadi mstari ambao haujaingizwa (au mwisho wa faili).

Ndani ya kizuizi cha nambari, & , < Na > Itabadilishwa kiotomatiki kuwa vyombo vya HTML, ambayo hurahisisha sana kutumia Markdown kuingiza msimbo wa chanzo wa HTML kwa mfano, nakili tu na ubandike, ongeza ujongezaji, na Alama iliyobaki itakushughulikia, kwa mfano:

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

itabadilishwa kuwa:

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

Katika kizuizi cha msimbo, syntax ya jumla ya Markdown haitabadilishwa, kama vile nyota ni nyota tu, ambayo inamaanisha kuwa unaweza kuandika kwa urahisi faili zinazohusiana na syntax ya Markdown katika syntax ya Markdown.

mgawanyiko

Unaweza kutumia zaidi ya nyota tatu, minus ishara, underscores kuunda kigawanyiko katika mstari, hakuna kitu kingine katika mstari.Unaweza pia kuingiza nafasi kati ya nyota au alama za minus.Mistari ya kutenganisha inaweza kuundwa kwa kila moja ya njia zifuatazo za kuandika:

* * *

***

*****

- - -

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

kipengele cha sehemu

kiungo

Markdown inasaidia aina mbili za syntax ya kiungo: Katika mstariNaRejeafomu mbili.

Vyovyote vile, maandishi ya kiungo yana alama ya [mabano ya mraba].

kuunda aKatika mstariIkiwa unataka kuongeza maandishi ya kichwa cha kiungo, funga tu maandishi ya kichwa na alama mbili za nukuu baada ya URL, kwa mfano:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Itazalisha:

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

Ikiwa unaunganisha kwa rasilimali kwenye mwenyeji sawa, unaweza kutumia njia za jamaa:

See my [About](/about/) page for details.

RejeaKiungo kinafuatwa na mabano mengine ya mraba baada ya mabano ya maandishi ya kiungo, na alama inayotumiwa kutambua kiungo inapaswa kujazwa kwenye mabano ya mraba ya pili:

This is [an example][id] reference-style link.

Unaweza pia kwa hiari kuweka nafasi kati ya mabano mawili ya mraba:

This is [an example] [id] reference-style link.

Kisha, mahali popote kwenye faili, unaweza kufafanua maudhui ya kiungo cha lebo hii:

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

Maudhui ya kiungo yamefafanuliwa katika fomu:

• Mabano ya mraba (hiari hutanguliwa na hadi nafasi tatu za kujongezwa) ambamo maandishi ya kiungo yameingizwa
• ikifuatiwa na koloni
• ikifuatiwa na nafasi moja au zaidi au vichupo
• URL ya kiungo kinachofuata
• Fuata kwa hiari maudhui ya mada, ambayo yanaweza kuambatanishwa katika nukuu moja, nukuu mbili au mabano

Ufafanuzi wa viungo vitatu vifuatavyo ni sawa:

[foo]: http://example.com/  "Optional Title Here"
[foo]: http://example.com/  'Optional Title Here'
[foo]: http://example.com/  (Optional Title Here)

tahadhari:Kuna suala linalojulikana ambapo Markdown.pl 1.0.1 inapuuza mada za viungo zilizoambatanishwa katika nukuu moja.

URL za viungo pia zinaweza kuambatanishwa kwenye mabano ya pembeni:

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

Unaweza pia kuweka sifa ya kichwa kwenye mstari unaofuata, au kuongeza ujongezaji, ambao utaonekana bora ikiwa URL ni ndefu sana:

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

Ufafanuzi wa URL hutumiwa tu wakati wa kuunda viungo, na hauonekani moja kwa moja kwenye faili.

Lebo za utambulisho wa kiungo zinaweza kuwa na herufi, nambari, nafasi nyeupe na uakifishaji, lakini hazifanyi hivyoHapanaNi nyeti kwa kesi, kwa hivyo viungo viwili vifuatavyo ni sawa:

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

Lebo ya kiungo isiyo wazikipengele kinakuruhusu kuacha kubainisha lebo ya kiungo. Katika kesi hii, lebo ya kiungo itachukuliwa kuwa sawa na maandishi ya kiungo. Ili kutumia lebo ya kiungo iliyofichwa, ongeza tu mabano ya mraba tupu baada ya maandishi ya kiungo. Ikiwa unataka "Google". " Kuunganisha kwa google.com, unaweza kurahisisha kwa:

[Google][]

Kisha fafanua yaliyomo kwenye kiungo:

[Google]: http://google.com/

Kwa kuwa maandishi ya kiungo yanaweza kuwa na nafasi nyeupe, lebo hii iliyorahisishwa inaweza kuwa na maneno mengi:

Visit [Daring Fireball][] for more information.

Kisha endelea kufafanua kiungo:

[Daring Fireball]: http://daringfireball.net/

Ufafanuzi wa kiungo unaweza kuwekwa mahali popote kwenye faili. Napendelea kuiweka moja kwa moja baada ya aya ambapo kiungo kinaonekana. Unaweza pia kuiweka mwishoni mwa faili, kama maoni tu.

Hapa kuna mfano wa kiungo cha kumbukumbu:

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"

Ukiibadilisha kutumia jina la kiungo kuandika:

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"

Njia mbili zilizo hapo juu za uandishi zitatoa HTML ifuatayo.

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

Ifuatayo ni faili ya Markdown ya maudhui sawa yaliyoandikwa ndani, iliyotolewa kwa kulinganisha:

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

Kwa kweli, uhakika wa viungo vya mtindo wa marejeleo sio kwamba ni rahisi kuandika, lakini ni rahisi kusoma. Linganisha mfano hapo juu. Nakala ya mtindo wa marejeleo yenyewe ni herufi 81 tu, lakini fomu ya ndani itaongezeka hadi Herufi 176. , ikiwa imeandikwa katika umbizo safi la HTML, kutakuwa na herufi 234. Katika umbizo la HTML, kuna vitambulisho zaidi kuliko maandishi.

Kwa kutumia viungo vya mtindo wa marejeleo wa Markdown, unaweza kufanya hati iwe kama matokeo ya mwisho ya kivinjari, ikikuruhusu kuhamisha baadhi ya metadata inayohusiana na uwekaji alama nje ya maandishi ya aya, na unaweza kuongeza viungo bila kufanya usomaji wa makala uhisiwe. .

强调

Markdown hutumia nyota (*) na msingi (_) kama ishara ya kuashiria neno lililopigiwa mstari, ni * Au _ Maneno yaliyozungukwa hubadilishwa kuwa <em> kuzungukwa na lebo, na mbili * Au _Ikiwa imefungwa, itabadilishwa kuwa <strong>,k.m:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

itageuka kuwa:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Unaweza kutumia mtindo wowote unaopenda, kizuizi pekee ni kwamba unaweza kutumia ishara kufungua lebo na ishara kuimaliza.

Mkazo unaweza pia kuingizwa moja kwa moja katikati ya maandishi:

un*frigging*believable

lakiniikiwa yako * Na _ Ikiwa kuna nafasi nyeupe kwa pande zote mbili, zinachukuliwa tu kama alama za kawaida.

Ili kuingiza nyota za kawaida au mistari chini moja kwa moja kabla na baada ya maandishi, unaweza kutumia mikwaju ya nyuma:

\*this text is surrounded by literal asterisks\*

Kanuni

Ikiwa unataka kuweka alama kwa kipande kidogo cha msimbo wa ndani, unaweza kuifunga kwa vijiti (`),Mf:

Use the `printf()` function.

Itazalisha:

<p>Use the <code>printf()</code> function.</p>

Ikiwa ungependa kuingiza vijiti vya nyuma ndani ya sehemu ya msimbo, unaweza kuanza na kumaliza sehemu ya msimbo kwa vijiti vingi:

``There is a literal backtick (`) here.``

Syntax hii hutoa:

<p><code>There is a literal backtick (`) here.</code></p>

Unaweza kuweka tupu mwanzoni na mwisho wa sehemu ya nambari, moja baada ya mwanzo na moja kabla ya mwisho, kwa hivyo unaweza kuingiza vijiti mwanzoni mwa sehemu:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

Itazalisha:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

Ndani ya sehemu ya kanuni,& na mabano ya pembe都itabadilishwa kiotomatiki kuwa huluki za HTML, ambayo hurahisisha kuingiza msimbo wa chanzo wa HTML, Markdown itaweka aya ifuatayo:

Please don't use any `<blink>` tags.

kwa:

<p>Please don't use any <code><blink></code> tags.</p>

Unaweza pia kuandika hii:

`—` is the decimal-encoded equivalent of `—`.

Ili kuzalisha:

<p><code>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>

图片

Kwa wazi, ni vigumu kuunda syntax ya "asili" ya kuingiza picha katika programu ya maandishi pekee.

Markdown hutumia syntax sawa na ile ya viungo kuweka alama kwenye picha, na pia inaruhusu mitindo miwili: Katika mstariNaRejea.

Syntax ya picha ya ndani inaonekana kama:

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

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

Maelezo ni kama ifuatavyo:

• alama ya mshangao !
• ikifuatiwa na mabano ya mraba yenye maandishi mbadala ya picha
• Kisha mabano ya kawaida, weka URL ya picha ndani, na hatimaye uifunge kwa nukuu na uongeze maandishi ya 'kichwa' cha hiari.

Syntax ya picha ya kumbukumbu inaonekana kama hii:

![Alt text][id]

"id" ni jina la rejeleo la picha, ambalo linafafanuliwa kwa njia sawa na marejeleo ya kiungo:

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

Hadi sasa, Markdown haina njia ya kutaja upana na urefu wa picha, ikiwa unahitaji, unaweza kutumia kawaida <img> Lebo.

其它

kiungo otomatiki

Markdown inasaidia kuchakata URL na visanduku vya barua pepe kwa njia ya viungo vifupi vifupi vya kiotomatiki. Mradi tu vimefungwa katika mabano ya pembe, Markdown itaibadilisha kiotomatiki kuwa kiungo.Maandishi ya kiungo ya URL ya jumla ni sawa na anwani ya kiungo, kwa mfano:

<http://example.com/>

Markdown itabadilishwa kuwa:

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

Kuunganisha kiotomatiki kwa anwani za barua pepe pia kunafanana sana, isipokuwa kwamba Markdown itafanya kwanza mchakato wa ubadilishaji wa usimbaji, kubadilisha herufi za maandishi kuwa huluki za HTML za heksadesimali. Umbizo hili linaweza kudanganya baadhi ya roboti mbaya za kukusanya anwani za barua pepe, kama vile:

<[email protected]>

Markdown itageuka kuwa:

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

Kwenye kivinjari, kamba hii (kwa kweli <a href="mailto:[email protected]">[email protected]</a>) inakuwa kiungo cha kubofya "[email protected]".

(Ingawa mbinu hii inaweza kudanganya roboti nyingi, haiwezi kuwazuia wote, lakini ni bora kuliko chochote. Kwa vyovyote vile, kufungua kisanduku chako cha barua hatimaye kutavutia barua za utangazaji.)

kurudi nyuma

Markdown inaweza kutumia mikwaju ya nyuma ili kuingiza alama ambazo zina maana nyingine katika sarufi, kwa mfano: ikiwa unataka kuongeza nyota karibu na maandishi kwa msisitizo (lakini sivyo. <em> tag), unaweza kutangulia kinyota kwa kurudi nyuma:

\*literal asterisks\*

Markdown inasaidia alama zifuatazo zinazotanguliwa na kurudi nyuma ili kusaidia kuingiza alama za kawaida:

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

Kihariri cha bure cha Markdown

Jukwaa la Windows

• MarkdownPad
• MarkPad

Jukwaa la Mac

• laini

mhariri wa mtandaoni

• MPEMhariri

programu-jalizi ya kivinjari

• Markdown hapa programu-jalizi

*** Ikiwa kuna kihariri bora cha Markdown kisicholipishwa cha kupendekeza, tafadhali zingatia maoni yakeChen Weiliang, asante!