Ką reiškia Markdown? Kaip naudoti Markdown sintaksės / formatavimo žymėjimą?

Akcijos kainosKą reiškia?

Kaip naudoti Markdown sintaksės / formatavimo žymėjimą?

Apžvalga

Markdown yra lengva žymėjimo kalba, kurią sukūrė Johnas Gruberis.

Tai leidžia žmonėms „rašyti dokumentus paprasto teksto formatu, kurį lengva skaityti ir rašyti, o tada konvertuoti juos į galiojančius XHTML (arba HTML) dokumentus“.

Kalba apima daugybę paprasto teksto žymėjimo funkcijų, jau esančių el. pašte.

John Gruber sukūrė Markdown kalbą 2004 m., bendradarbiaudamas su Aaron Swartz, daugiausia sintaksės srityje.Kalbos tikslas yra naudoti „paprasto teksto formatą, kurį lengva skaityti, lengva rašyti ir pasirinktinai konvertuoti į galiojantį XHTML (arba HTML)“.

tikslas

„Markdown“ tikslas yra būti „lengvai skaitomai ir lengvai rašomai“.

skaitomumas, darykite tai vis tiekInterneto rinkodara, vartotojo patirtis yra labai svarbi.

Dokumentas, parašytas naudojant Markdown, turėtų būti skelbiamas tiesiogiai paprastu tekstu ir neturėtų atrodyti sudarytas iš daugybės žymų ar formatavimo direktyvų.

Markdown sintaksę įtakoja kai kurie esami teksto į HTML formatai, įskaitant Setext, atx, Textile, reStructuredText, Grutatext ir EtText, tačiau didžiausias įkvėpimo šaltinis yra paprasto teksto el. pašto formatas.

Trumpai tariant, Markdown sintaksė susideda iš simbolių, kurie yra kruopščiai atrinkti ir jų funkcijos yra aiškios iš pirmo žvilgsnio.Pavyzdžiui: aplink tekstą padėkite žvaigždutes, kad jis atrodytų kaip *pabrėžimas*.

„Markdown“ sąrašai atrodo kaip sąrašai. „Markdown“ citatos iš tikrųjų atrodo kaip teksto citavimas, kaip matėte el. laiškuose.

Suderinamas su HTML

Markdown gramatikos tikslas yra būti rašymo kalba žiniatinklyje.

Markdown nėra skirtas pakeisti HTML ar net priartėti prie jo, jis turi labai nedaug sintaksės tipų ir atitinka tik nedidelį HTML žymėjimo poaibį. Markdown nebuvo sukurta tam, kad palengvintų HTML dokumentų rašymą.

Mano nuomone, HTML jau lengva rašyti. Markdown idėja yra palengvinti dokumentų skaitymą, rašymą ir keitimą pagal pageidavimą. HTML yra leidybos formatas, Markdown yra aReklamos rašymasrašytinis formatas.Taigi Markdown formatavimo sintaksė apima tik tai, ką gali paprastas tekstas.

Žymos, kurioms netaikomas Markdown, gali būti įrašytos HTML tiesiai į dokumentąInterneto reklamakopija.Nereikia to pažymėti kaip HTML arba Markdown; tiesiog pridėkite žymėjimą tiesiogiai.

Tik kai kurie HTML bloko elementai turi būti apriboti – pvz <div>,<table>,<pre>,<p> ir kitos žymos, jos turi būti atskirtos nuo kitų turinio sričių tuščiomis eilutėmis prieš ir po, o jų atidarymo ir uždarymo žymos neturi būti įtrauktos tabuliavimo ženklais ar tarpais. Markdown generatorius yra pakankamai protingas, kad nepridėtų nereikalingų HTML bloko žymų <p> etiketė.

Pavyzdys yra toks, pridedant HTML lentelę prie Markdown failo:

这是一个普通段落。

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

这是另一个普通段落。

Atminkite, kad Markdown formatavimo sintaksė tarp HTML bloko žymų nebus apdorojama.Pavyzdžiui, jei naudojate Markdown stilių HTML blokuose*强调*neturės jokio poveikio.

HTML sekcijos (įterptosios) žymos, pvz <span>,<cite>,<del> Gali būti laisvai naudojamas Markdown pastraipose, sąrašuose ar antraštėse.Atsižvelgdami į asmeninius įpročius, netgi galite naudoti HTML žymas formatuodami nenaudodami Markdown formato.Pavyzdys: jei jums labiau patinka HTML <a> Arba <img> žymas, kurias galima naudoti tiesiogiai be nuorodos arba vaizdo žymų sintaksės, kurią pateikia Markdown.

Skirtingai nei tarp HTML bloko žymų, Markdown sintaksė galioja tarp HTML skyriaus žymų.

Automatinis specialiųjų simbolių konvertavimas

HTML failuose yra du simboliai, kuriuos reikia tvarkyti specialiai: < Ir & . < simboliai naudojami pradžios žymoms,& Simboliai naudojami HTML subjektams žymėti, jei norite tiesiog parodyti šių simbolių prototipą, turite naudoti objekto formą, pvz. < Ir &.

& Simboliai ypač kankina žiniatinklio dokumentų rašytojus, jei ketinate rašytiAT&T", jūs turite parašyti"AT&T“.būdamas URL & Simboliai taip pat konvertuojami.Pavyzdžiui, norite susieti su:

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

URL konversiją turite parašyti taip:

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

turi būti įdėta į nuorodos žymą href savybėse.Nereikia nė sakyti, kad tai lengva nepaisyti ir tikriausiai didžiausias klaidų skaičius, aptiktas tikrinant HTML standartus.

Markdown leidžia rašyti simbolius natūraliai ir pasirūpina tuo, ką reikia konvertuoti.jei naudojate & Simbolis yra HTML simbolio objekto dalis, jis paliekamas toks, koks yra, kitu atveju konvertuojamas į &;。

Taigi, jei norite į dokumentą įterpti autorių teisių simbolį ©, tu gali rašyti:

©

Markdown paliks jį nepaliestą.O jei parašysi:

AT&T

Markdown konvertuos jį į:

AT&T

Panaši situacija pasitaiko ir < žymėjimas, nes Markdown leidžia suderinti HTML, jei įdėsite < Simboliai naudojami kaip HTML žymų skyrikliai, o Markdown nevykdys jų konvertavimo, bet jei rašysite:

4 < 5

Markdown konvertuos jį į:

4 < 5

Tačiau reikia pažymėti, kad kodo apimtyje, nesvarbu, ar jis yra įterptas, ar blokuotas, < Ir & abu simboliaitikraiyra konvertuojami į HTML objektus – funkciją, kuri leidžia lengvai rašyti HTML kodą į Markdown (priešingai nei HTML, kur įdedate visus < Ir & Visi jie konvertuojami į HTML esybes, kad būtų galima įrašyti HTML kodą į HTML failą. )

bloko elementas

Pastraipos ir eilučių lūžiai

Pažymėjimo pastraipą sudaro viena ar daugiau iš eilės einančių teksto eilučių, prieš ir po daugiau nei viena tuščia eilutė (tuščios eilutės apibrėžimas yra toks, kad ekrane ji atrodo tuščia ir laikoma tuščia eilute. Pavyzdžiui, , jei eilutėje yra tik tarpai ir skirtukai, eilutė taip pat bus traktuojama kaip tuščia eilutė).Įprastos pastraipos neturėtų būti įtrauktos tarpais ar skirtukais.

Frazė „sudaryta iš vienos ar kelių iš eilės einančių teksto eilučių“ iš tikrųjų reiškia, kad Markdown leidžia priverstines naujas eilutes (naujų eilučių įterpimas) pastraipose – funkcija, kuri skiriasi nuo daugelio kitų teksto į HTML formatų (įskaitant kilnojamojo tipo „Konvertuoti eilučių lūžius“ " parinktį), kiti formatai konvertuos kiekvieną eilutės lūžį į <br /> etiketė.

Jei tuiš tikrųjųNorite pasikliauti „Markdown“ įterpimu <br /> Jei norite naudoti etiketes, įterpimo vietoje paspauskite du ar daugiau tarpų, tada paspauskite Enter.

Iš tiesų, norint sukurti reikia šiek tiek daugiau darbo (papildomų erdvių). <br /> , bet tiesiog „kiekviena nauja eilutė konvertuojama į <br />„Metodas netinka Markdown, em MarkdownaiL stiliaus blokinės kabutės ir kelių pastraipų sąrašai yra ne tik naudingesni, bet ir lengviau skaitomi, kai spausdiname su eilučių pertraukomis.

Pavadinimas

Markdown palaiko dvi antraščių sintakses, panašias į Setext ir panašias į atx.

Į „Settext“ panaši forma yra forma su apatine eilute, naudojant = (aukščiausias titulas) ir - (Antros eilės antraštės), pavyzdžiui:

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

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

bet kokia suma = Ir - gali būti veiksmingi.

Atx tipo forma eilutės pradžioje įterpiama nuo 1 iki 6 # , atitinkantys 1–6 antraštes, pavyzdžiui:

# 这是 H1

## 这是 H2

###### 这是 H6

Pasirinktinai galite „uždaryti“ į atx panašias antraštes, tai tik dėl estetikos, jei taip jaučiatės patogiai, galite pridėti eilutės pabaigoje #, o eilutės pabaigos # Skaičius nebūtinai turi būti toks pat kaip pradžia (svarstinių simbolių skaičius eilutės pradžioje lemia pavadinimo tvarką):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Pažymėjimo žymėjimo blokinės kabutės naudojamos panašiai kaip ir el. laiške > citatų.Jei esate susipažinę su citatomis el. laiškuose, žinote, kaip Markdown faile sukurti blokinę citatą, kuri atrodytų taip, lyg pats sulaužytumėte eilutes, tada pridėkite > :

> 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 taip pat leidžia tingėti ir pridėti tik pirmąją visos pastraipos eilutę > :

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

Blokų nuorodos gali būti įdėtos (pvz., nuorodos nuorodose) pridedant skirtingą skaičių > :

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

Kitos Markdown sintaksės taip pat gali būti naudojamos kabutėse, įskaitant antraštes, sąrašus, kodų blokus ir kt.:

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

Bet kuris tinkamas teksto redaktorius gali lengvai sukurti el. pašto stiliaus citatas.Pavyzdžiui, BBEdit galite pasirinkti tekstą ir tada pasirinkti iš meniupadidinti citatų hierarchiją.

列表

Markdown palaiko sutvarkytus ir netvarkingus sąrašus.

Netvarkinguose sąrašuose kaip sąrašo žymekliai naudojami žvaigždutės, pliuso arba minuso ženklai:

*   Red
*   Green
*   Blue

Atitinka:

+   Red
+   Green
+   Blue

Taip pat lygiavertis:

-   Red
-   Green
-   Blue

Sutvarkytuose sąrašuose naudojami skaičiai, po kurių rašomas taškas:

1.  Bird
2.  McHale
3.  Parish

Svarbu pažymėti, kad sąrašo žymoje naudojami skaičiai neturi įtakos išvesties HTML. Gautas HTML žymėjimas aukščiau pateiktam sąrašui būtų toks:

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

Jei sąrašo žymėjimas parašytas taip:

1.  Bird
1.  McHale
1.  Parish

ar net:

3. Bird
1. McHale
8. Parish

Abu gausite lygiai tą pačią HTML išvestį.Esmė ta, kad Markdown failo sąrašo numerius galite padaryti tokius pat, kaip ir išvesties rezultatus, arba, jei esate tingus, jums visai nereikia rūpintis skaičių teisingumu.

Jei naudojate tingų rašymą, pirmą elementą rekomenduojama pradėti nuo 1., nes Markdown ateityje gali palaikyti sutvarkytų sąrašų pradžios atributą.

Sąrašo elemento žyma paprastai dedama kairėje pusėje, tačiau ji gali būti įtraukta, iki 3 tarpų, o po elemento žymos turi būti bent vienas tarpas arba tabuliatorius.

Kad sąrašas atrodytų gražiau, turinį galite tvarkyti naudodami fiksuotą įtrauką:

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

Bet jei esate tingus, tai taip pat gerai:

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

Jei sąrašo elementai yra atskirti tuščiomis eilutėmis, Markdown naudos elementų turinį išvesdama HTML. <p> Etiketės suvyniotos, pavyzdžiui:

*   Bird
*   Magic

bus konvertuojamas į:

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

Tačiau tai:

*   Bird

*   Magic

bus konvertuojamas į:

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

Sąrašo elementus gali sudaryti kelios pastraipos, o pastraipos po kiekvienu elementu turi būti įtrauktos 4 tarpais arba 1 skirtuko ženklu:

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.

Atrodo daug geriau, jei įtrauksite kiekvieną eilutę, žinoma, vėlgi, jei esate tingus, Markdown taip pat leidžia:

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

Jei norite įtraukti nuorodą sąrašo elemente, tada > Turi būti įtraukta:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Jei norite įdėti kodo bloką, blokas turi būti įtrauktasdu kartus, tai yra 8 tarpai arba 2 skirtukai:

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

        <代码写在这>

Žinoma, elementų sąrašas gali būti sugeneruotas netyčia, maždaug taip:

1986. What a great season.

Kitaip tariant, jis pasirodo eilutės pradžiojeskaičius-taškas-tuščias, kad to išvengtumėte, prieš tašką galite pridėti pasvirąjį brūkšnį.

1986\. What a great season.

kodo blokas

Su programa susijusiame rašymo arba žymų kalbos šaltinio kode paprastai jau yra įvesti kodų blokai. Paprastai nenorime, kad šie blokai būtų rinkti kaip bendrieji pastraipų failai, bet būtų rodomi tokie, kokie jie yra. Markdown naudos <pre> Ir <code> žymų kodų blokams apvynioti.

Sukurti kodo blokus Markdown yra taip paprasta, kaip įtraukus 4 tarpus arba 1 skirtuką. Pavyzdžiui, įveskite:

这是一个普通段落：

    这是一个代码区块。

Markdown bus konvertuojamas į:

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

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

Ši pirmos eilės įtrauka eilutėje (4 tarpai arba 1 skirtukas) pašalinama, pavyzdžiui:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

bus konvertuojamas į:

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

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

Kodo blokas tęsiasi iki neįtrauktos eilutės (arba failo pabaigos).

Kodo bloko viduje, & , < Ir > Jis bus automatiškai konvertuojamas į HTML objektus, todėl labai lengva naudoti Markdown, kad įterptumėte pavyzdžio HTML šaltinio kodą, tiesiog nukopijuokite ir įklijuokite jį, pridėkite įtrauką, o likusi Markdown dalis atliks tai už jus. pavyzdžiui:

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

bus konvertuojamas į:

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

Kodo bloke bendra Markdown sintaksė nebus konvertuojama, pvz., žvaigždutės yra tik žvaigždutės, o tai reiškia, kad Markdown sintaksėje galite lengvai įrašyti su Markdown sintaksę susijusius failus.

skirstytuvas

Galite sukurti skirstytuvą su daugiau nei trimis žvaigždutėmis, minuso ženklais, apatiniais brūkšniais eilutėje ir nieko kito.Taip pat galite įterpti tarpus tarp žvaigždučių arba minuso ženklų.Atskyrimo eilutes galima sukurti kiekvienu iš šių rašymo būdų:

* * *

***

*****

- - -

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

skyriaus elementas

nuoroda

Markdown palaiko dvi nuorodos sintaksės formas: InlineIrNuorodadvi formos.

Bet kuriuo atveju nuorodos tekstas pažymėtas [laužtiniais skliaustais].

sukurti aInlineJei norite pridėti nuorodos pavadinimo tekstą, tiesiog apvyniokite pavadinimo tekstą dvigubomis kabutėmis po URL, pavyzdžiui:

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

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

Gamins:

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

Jei susiejate su ištekliais tame pačiame pagrindiniame kompiuteryje, galite naudoti santykinius kelius:

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

NuorodaPo nuorodos po nuorodos teksto skliaustuose rašomas kitas laužtinis skliaustas, o nuorodai identifikuoti naudojamas ženklas turi būti įrašytas antrame laužtiniame skliauste:

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

Taip pat galite pasirinktinai palikti tarpą tarp dviejų laužtinių skliaustų:

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

Tada bet kurioje failo vietoje galite apibrėžti šios žymos nuorodos turinį:

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

Nuorodos turinys apibrėžiamas tokia forma:

• laužtiniai skliaustai (pasirinktinai prieš tris tarpus įtraukai), į kuriuos įvedamas nuorodos tekstas
• po to dvitaškis
• po kurio yra vienas ar keli tarpai arba tabuliacijos ženklai
• kitos nuorodos URL
• Pasirinktinai vadovaukitės pavadinimo turiniu, kuris gali būti įtrauktas į viengubas, dvigubas kabutes arba skliaustus

Šių trijų nuorodų apibrėžimai yra vienodi:

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

Atkreipkite dėmesį:Yra žinoma problema, kai Markdown.pl 1.0.1 nepaiso nuorodų pavadinimų, pateiktų atskirose kabutėse.

Nuorodų URL taip pat gali būti įterpti į kampinius skliaustus:

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

Taip pat galite įdėti pavadinimo atributą kitoje eilutėje arba pridėti įtrauką, kuri atrodys geriau, jei URL yra per ilgas:

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

URL apibrėžimas naudojamas tik generuojant nuorodą ir nerodomas tiesiogiai faile.

Nuorodų identifikavimo žymose gali būti raidžių, skaičių, tarpų ir skyrybos ženklų, bet neNeSkiriamos didžiosios ir mažosios raidės, todėl šios dvi nuorodos yra vienodos:

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

Netiesioginė nuorodos žymafunkcija leidžia nenurodyti nuorodos žymos. Tokiu atveju nuorodos žyma bus traktuojama kaip lygiavertė nuorodos tekstui. Jei norite naudoti numanomą nuorodos žymą, tiesiog pridėkite tuščią laužtinį skliaustelį po nuorodos teksto. Jei norite „Google“ Susiedami su google.com galite supaprastinti:

[Google][]

Tada apibrėžkite nuorodos turinį:

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

Kadangi nuorodos tekste gali būti tarpų, šiame supaprastintame žymėjime gali būti keli žodžiai:

Visit [Daring Fireball][] for more information.

Tada pereikite prie nuorodos apibrėžimo:

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

Nuorodos apibrėžimą galima patalpinti bet kurioje failo vietoje. Man labiau patinka jį dėti iškart po pastraipos, kurioje rodoma nuoroda. Taip pat galite įdėti jį į failo pabaigą, kaip ir komentarą.

Štai nuorodos nuorodos pavyzdys:

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"

Jei jį pakeisite ir rašydami naudosite nuorodos pavadinimą:

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"

Pirmiau nurodyti du rašymo būdai sukurs tokį 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>

Žemiau pateikiamas to paties turinio Markdown failas, parašytas eilute, pateiktas palyginimui:

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

Tiesą sakant, nuorodos stiliaus nuorodų esmė yra ne ta, kad lengviau rašyti, o kad lengviau skaityti. Palyginkite aukščiau pateiktą pavyzdį. Pats nuorodos stiliaus straipsnis yra tik 81 simbolio, bet eilutinė forma padidės iki 176 simboliai. , jei parašyta grynu HTML formatu, simbolių bus 234. HTML formate žymų yra daugiau nei teksto.

Naudodami „Markdown“ nuorodos stiliaus nuorodas, galite padaryti dokumentą panašesnį į galutinį naršyklės rezultatą, leidžiantį perkelti kai kuriuos su žymėjimu susijusius metaduomenis už pastraipos teksto ribų, taip pat galite pridėti nuorodų nesukeldami skaitymo pojūčio. nutraukti .

强调

Markdown naudoja žvaigždutes (*) ir apatinė eilutė (_) kaip simbolis pabrauktam žodžiui pažymėti, yra * Arba _ Aplinkiniai žodžiai konvertuojami į <em> apsuptas etiketėmis, su dviem * Arba _Jei jis bus suvyniotas, jis bus paverstas <strong>, Pvz .:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

pavirs:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Galite naudoti bet kokį jums patinkantį stilių. Vienintelis apribojimas yra tas, kad galite atidaryti žymą su kokiu simboliu norite ją užbaigti.

Kirčiavimą taip pat galima įterpti tiesiai teksto viduryje:

un*frigging*believable

betjei tavo * Ir _ Jei abiejose pusėse yra tarpų, jie traktuojami kaip įprasti simboliai.

Norėdami įterpti įprastas žvaigždutes arba apatinius brūkšnius tiesiai prieš ir po teksto, galite naudoti pasviruosius brūkšnius:

\*this text is surrounded by literal asterisks\*

Kodas

Jei norite pažymėti nedidelę eilutinio kodo dalį, galite ją apvynioti atgalinėmis varnelėmis (`),Pvz.:

Use the `printf()` function.

Gamins:

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

Jei norite įterpti atgalines žymes į kodo skiltį, kodo sekciją galite pradėti ir baigti naudodami kelis atpakalinius varnelius:

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

Ši sintaksė sukuria:

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

Kodo sekcijos pradžioje ir pabaigoje galite įdėti tarpą, vieną po pradžios ir kitą prieš pabaigą, kad galėtumėte įterpti atgalines žymes skyriaus pradžioje:

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

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

Gamins:

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

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

Kodo skiltyje& ir kampiniai laikikliai都bus automatiškai konvertuojami į HTML objektus, todėl bus lengva įterpti HTML šaltinio kodą, Markdown įdės šią pastraipą:

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

į:

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

Taip pat galite parašyti tai:

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

Gaminti:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

图片

Akivaizdu, kad sunku sukurti „natūralią“ vaizdų įterpimo sintaksę tik teksto programoje.

Markdown naudoja sintaksę, panašią į nuorodas vaizdams žymėti, taip pat leidžia naudoti du stilius: InlineIrNuoroda.

Eilutinio vaizdo sintaksė atrodo taip:

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

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

Išsami informacija yra tokia:

• šauktukas !
• po kurio yra laužtiniai skliaustai su vaizdo alternatyviuoju tekstu
• Tada įdėkite įprastą skliaustą, įdėkite vaizdo URL į vidų, galiausiai įdėkite jį į kabutes ir pridėkite pasirenkamą „pavadinimo“ tekstą.

Nuorodos vaizdo sintaksė atrodo taip:

![Alt text][id]

„id“ yra vaizdo nuorodos pavadinimas, kuris apibrėžiamas taip pat, kaip nuorodos nuoroda:

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

Kol kas Markdown negali nurodyti vaizdo pločio ir aukščio, jei reikia, galite naudoti įprastą <img> etiketė.

其它

automatinė nuoroda

„Markdown“ palaiko URL ir el. pašto dėžučių apdorojimą santykinai trumpų automatinių nuorodų pavidalu. Jei jie yra įterpti į kampinius skliaustus, „Markdown“ automatiškai konvertuos juos į nuorodą.Bendrojo URL nuorodos tekstas yra toks pat kaip nuorodos adresas, pavyzdžiui:

<http://example.com/>

Markdown bus konvertuotas į:

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

Automatinis el. pašto adresų susiejimas taip pat panašus, išskyrus tai, kad Markdown pirmiausia atliks kodavimo konvertavimo procesą, paversdama teksto simbolius šešioliktainiais HTML objektais. Šis formatas gali apgauti kai kuriuos blogus el. pašto adresų rinkimo robotus, pvz.:

<[email protected]>

Markdown pavirs į:

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

Naršyklėje ši eilutė (iš tikrųjų <a href="mailto:[email protected]">[email protected]</a>) tampa nuoroda „[email protected]“, kurią galima spustelėti.

(Nors toks požiūris gali apgauti daugybę robotų, jis negali jų visų sustabdyti, tačiau tai geriau nei nieko. Bet kokiu atveju, atidarius pašto dėžutę, ilgainiui pritrauks reklaminių laiškų.)

pasvirasis brūkšnys

Markdown gali naudoti pasviruosius brūkšnius, kad įterptų simbolius, kurie gramatikoje turi kitas reikšmes, pavyzdžiui: jei norite pridėti žvaigždutę šalia teksto, kad būtų pabrėžta (bet ne <em> žymą), prieš žvaigždutę galite įrašyti pasvirąjį brūkšnį:

\*literal asterisks\*

Markdown palaiko šiuos simbolius, prieš kuriuos yra pasvirasis brūkšnys, kad būtų lengviau įterpti įprastus simbolius:

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

Markdown nemokama redaktorius

Windows platforma

• MarkdownPad
• MarkPad

Mac platforma

• minkštas

internetinis redaktorius

• MPE redaktorius

naršyklės papildinys

• Pažymėjimo čia papildinys

*** Jei yra geresnis nemokamas Markdown redaktorius, kurį galite rekomenduoti, atkreipkite dėmesį į atsiliepimusChen Weiliang,dėkoju!