Mitä Markdown tarkoittaa? Kuinka käyttää Markdown-syntaksia/muotoilumerkintöjä?

HinnanalennusMitä tarkoittaa?

Kuinka käyttää Markdownin syntaksia/muotomerkintöjä?

Yleiskatsaus

Markdown on John Gruberin luoma kevyt merkintäkieli.

Sen avulla ihmiset voivat "kirjoittaa asiakirjoja pelkässä tekstimuodossa, jota on helppo lukea ja kirjoittaa, ja sitten muuntaa ne kelvollisiksi XHTML (tai HTML) asiakirjoiksi".

Kieli on omaksunut monet sähköpostissa jo löytyneet pelkkää tekstin merkinnän ominaisuudet.

John Gruber loi Markdown-kielen vuonna 2004 yhteistyössä Aaron Swartzin kanssa suurelta osin syntaksin parissa.Kielen tarkoitus on käyttää "helppotekstimuotoa, joka on helppolukuinen, helppo kirjoittaa ja valinnaisesti muuntaa kelvolliseen XHTML:ään (tai HTML:ään)".

tarkoitus

Markdownin tavoitteena on saavuttaa "helppo lukea ja helppo kirjoittaa".

luettavuus, tee se joka tapauksessa网络 营销, käyttökokemus on erittäin tärkeä.

Markdownissa kirjoitetun tiedoston pitäisi voida julkaista suoraan pelkkänä tekstinä, eikä se saa näyttää koostuvan useista tunnisteista tai muotoiluohjeista.

Markdown-syntaksiin vaikuttavat jotkin olemassa olevat tekstistä HTML-muotoon -muodot, kuten Setext, atx, Textile, reStructuredText, Grutatext ja EtText, mutta suurin inspiraation lähde on pelkkä teksti -sähköpostimuoto.

Lyhyesti sanottuna Markdownin syntaksi koostuu kaikki symboleista, jotka on valittu huolellisesti ja niiden toiminnot ovat selkeät yhdellä silmäyksellä.Esimerkki: lisää tähtiä tekstin ympärille, jotta se näyttää *korostus*.

Markdownin listat näyttävät listoilta. Markdownin lohkolainaukset näyttävät todella tekstin lainaamiselta, aivan kuten olet nähnyt sähköposteissa.

Yhteensopiva HTML:n kanssa

Markdownin kieliopin tavoitteena on olla kirjoituskieli verkkoon.

Markdownia ei ole tarkoitettu korvaamaan HTML:ää tai edes lähelle sitä, sillä on hyvin vähän syntaksia ja se vastaa vain pientä osajoukkoa HTML-merkinnöistä. Markdownia ei suunniteltu helpottamaan HTML-dokumenttien kirjoittamista.

Mielestäni HTML on jo nyt helppo kirjoittaa. Markdownin ideana on tehdä asiakirjoista helpompi lukea, kirjoittaa ja muuttaa mieleisekseen. HTML on julkaisumuoto, Markdown on aTekstisuunnittelukirjallisessa muodossa.Sellaisenaan Markdownin muotoilusyntaksi kattaa vain sen, mitä pelkkä teksti voi.

Tunnisteet, joita Markdown ei kata, voidaan kirjoittaa HTML-kielellä suoraan dokumenttiinWeb Promotionkopio.Tätä ei tarvitse merkitä HTML:ksi tai Markdowniksi; lisää vain merkintä suoraan.

Vain jotkin HTML-lohkoelementit on rajoitettava - kuten <div>,<table>,<pre>,<p> ja muut tunnisteet, ne on erotettava muista sisältöalueista tyhjillä riveillä ennen ja jälkeen, eikä niiden alku- ja sulkemistunnisteita saa sisentää sarkaimilla tai välilyönneillä. Markdown-generaattori on tarpeeksi älykäs, jotta se ei lisää tarpeettomia HTML-lohkotageja <p> etiketti.

Esimerkki on seuraava, lisäämällä HTML-taulukko Markdown-tiedostoon:

这是一个普通段落。

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

这是另一个普通段落。

Huomaa, että HTML-lohkotunnisteiden välistä Markdown-muotoilusyntaksia ei käsitellä.Jos esimerkiksi käytät Markdown-tyyliä HTML-lohkon sisällä*强调*ei tule olemaan vaikutusta.

HTML-osion (inline) tagit, kuten <span>,<cite>,<del> Voidaan käyttää vapaasti Markdown-kappaleissa, luetteloissa tai otsikoissa.Henkilökohtaisten tapojen mukaan voit jopa käyttää HTML-tageja muotoiluun ilman Markdown-muotoa.Esimerkki: Jos pidät HTML:stä <a> 或 <img> -tunnisteet, joita voidaan käyttää suoraan ilman Markdownin tarjoamaa linkin tai kuvatunnisteen syntaksia.

Toisin kuin HTML-lohkotunnisteiden välillä, Markdown-syntaksi on voimassa HTML-osiotunnisteiden välillä.

Erikoismerkkien automaattinen muuntaminen

HTML-tiedostoissa on kaksi merkkiä, jotka vaativat erityiskäsittelyä: < 和 & . < alkutunnisteissa käytetään symboleja,& Symboleja käytetään merkitsemään HTML-entiteettiä, jos haluat vain näyttää näiden merkkien prototyypin, sinun on käytettävä entiteettimuotoa, esim. < 和 &.

& Hahmot ovat erityisen kiusallisia verkkodokumenttien kirjoittajille, jos aiot kirjoittaa "AT&T", sinun täytyy kirjoittaa"AT&T".URL-osoitteessa & Myös hahmot muunnetaan.Haluat esimerkiksi linkittää:

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

Sinun on kirjoitettava URL-muunnos seuraavasti:

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

sijoitettava linkkitunnisteeseen href kiinteistöissä.Sanomattakin on selvää, että tämä on helppo jättää huomiotta, ja se on luultavasti suurin HTML-standardien validoinnin havaitsemien virheiden määrä.

Markdownin avulla voit kirjoittaa merkkejä luonnollisesti, ja se huolehtii muunnettavista asioista.jos käytät & Merkki on osa HTML-merkkikokonaisuutta, se jätetään sellaisenaan, muuten se muunnetaan sellaiseksi &;.

Joten jos haluat lisätä tekijänoikeussymbolin asiakirjaan ©, sinä voit kirjoittaa:

©

Markdown jättää sen koskemattomaksi.Ja jos kirjoitat:

AT&T

Markdown muuntaa sen muotoon:

AT&T

Samanlainen tilanne esiintyy myös mm < merkintä, koska Markdown sallii HTML-yhteensopivuuden, jos laitat < Symboleja käytetään HTML-tunnisteiden erottimina, eikä Markdown tee niille mitään muunnoksia, mutta jos kirjoitat:

4 < 5

Markdown muuntaa sen muotoon:

4 < 5

On kuitenkin huomioitava, että koodin sisällä, olipa se rivissä tai lohkossa, < 和 & molemmat symbolitvarmastimuunnetaan HTML-kokonaisuuksiksi, ominaisuus, jonka avulla voit helposti kirjoittaa HTML-koodia Markdowniin (toisin kuin HTML:ssä, johon laitat kaikki < 和 & Kaikki muunnetaan HTML-kokonaisuuksiksi HTML-koodin kirjoittamiseksi HTML-tiedostoon. )

lohkoelementti

Kappaleet ja rivinvaihdot

Markdown-kappale koostuu yhdestä tai useammasta peräkkäisestä tekstirivistä, joita edeltää ja seuraa useampi kuin yksi tyhjä rivi (tyhjän rivin määritelmä on, että se näyttää tyhjältä näytössä ja sitä pidetään tyhjänä rivinä. Esimerkiksi , jos rivillä on vain välilyöntejä ja sarkaimia, riviä käsitellään myös tyhjänä rivinä).Tavallisia kappaleita ei saa sisentää välilyönneillä tai sarkaimilla.

Ilmaus "koostuu yhdestä tai useammasta peräkkäisestä tekstirivistä" tarkoittaa itse asiassa, että Markdown sallii pakotetut rivinvaihdot (rivinvaihtojen lisäämisen) kappaleissa. Tämä ominaisuus eroaa useimmista muista tekstistä HTML-muotoon (mukaan lukien Movable Type "Convert Line"). Breaks" -vaihtoehto), muut muodot muuntaa jokaisen rivinvaihdon muotoon <br /> etiketti.

如果 你todellakinHaluatko luottaa siihen, että Markdown lisää <br /> Tarroja varten paina kaksi tai useampaa välilyöntiä lisäyskohdassa ja paina sitten Enter.

Itse asiassa sen luominen vaatii hieman enemmän työtä (lisätiloja). <br /> , vaan yksinkertaisesti "jokainen rivinvaihto muunnetaan muotoon <br />"Menetelmä ei sovellu Markdowniin, em MarkdowniinaiL-tyyliset lainausmerkit ja monikappaleluettelot eivät ole vain hyödyllisempiä, vaan myös helpompia lukea, kun ladat rivinvaihdolla.

otsikko

Markdown tukee kahta otsikoiden syntaksia, Setext-like ja atx-like.

Settext-tyyppinen lomake on lomake, jonka alarivi käyttää = (korkein otsikko) ja - (Toisen kertaluvun otsikot), esimerkiksi:

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

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

mikä tahansa määrä = 和 - voi olla tehokasta.

Atx:n kaltainen muoto lisää rivin alkuun 1-6 # , jotka vastaavat otsikoita 1–6, esimerkiksi:

# 这是 H1

## 这是 H2

###### 这是 H6

Voit halutessasi "sulkea" atx-tyyppisiä otsikoita, tämä on puhtaasti estetiikkaa varten, jos tunnet olosi mukavaksi tällä tavalla, voit lisätä sen rivin loppuun #, kun rivi loppuu # Numeron ei tarvitse olla sama kuin alun (rivin alussa olevien puntamerkkien määrä määrittää otsikon järjestyksen):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Markdown-merkintöjen lohkolainauksia käytetään samalla tavalla kuin sähköpostissa käytettyjä > sitaateista.Jos tunnet sähköpostikirjeiden lainaukset, osaat luoda Markdown-tiedostoon lohkolainauksen, joka näyttäisi siltä, ​​että rikkoisit rivit itse ja lisäät sitten > :

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

Markdownin avulla voit myös olla laiska ja lisätä vain koko kappaleen ensimmäisen rivin > :

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

Lohkoviitteet voidaan upottaa sisäkkäin (esim. viittaukset viitteiden sisällä) lisäämällä eri lukumäärä > :

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

Muita Markdown-syntakseja voidaan käyttää myös lainauslohkoissa, mukaan lukien otsikot, luettelot, koodilohkot jne.:

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

Mikä tahansa kunnollinen tekstieditori voi helposti luoda sähköpostityylisiä lainauksia.Esimerkiksi BBEditissä voit valita tekstin ja valita sitten valikostalisätä viittaushierarkiaa.

lista

Markdown 支持 有序 列表 和 无序 列表。

Järjestämättömät luettelot käyttävät tähtiä, plus- tai miinusmerkkejä luettelon merkeinä:

*   Red
*   Green
*   Blue

Vastaa:

+   Red
+   Green
+   Blue

Vastaa myös:

-   Red
-   Green
-   Blue

Järjestetyissä luetteloissa käytetään numeroita, joita seuraa piste:

1.  Bird
2.  McHale
3.  Parish

On tärkeää huomata, että luettelotunnisteessa käyttämäsi numerot eivät vaikuta tulostettavaan HTML-koodiin. Tuloksena oleva HTML-merkintä yllä olevalle luettelolle olisi:

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

Jos luettelomerkintäsi on kirjoitettu seuraavasti:

1.  Bird
1.  McHale
1.  Parish

tai jopa:

3. Bird
1. McHale
8. Parish

Saat molemmat täsmälleen saman HTML-tulosteen.Pointti on siinä, että voit tehdä Markdown-tiedoston listanumerot samanlaisiksi kuin tulostulokset, tai jos olet laiska, sinun ei tarvitse välittää numeroiden oikeellisuudesta ollenkaan.

Jos käytät laiskaa kirjoittamista, on suositeltavaa aloittaa 1.:llä ensimmäiselle alkiolle, koska Markdown voi jatkossa tukea järjestettyjen listojen start-attribuuttia.

Luettelokohteen tunniste sijoitetaan yleensä äärivasemmalle, mutta se voi olla sisennetty, enintään 3 välilyöntiä, ja nimiketunnisteen jälkeen on oltava vähintään yksi välilyönti tai sarkain.

Jotta luettelo näyttää kauniimmalta, voit järjestää sisällön kiinteällä sisennyksellä:

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

Mutta jos olet laiska, sekin on hyvä:

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

Jos luettelon kohteet erotetaan tyhjillä riveillä, Markdown käyttää kohteen sisältöä HTML-tulostuksessa. <p> Tarrat kääritään esimerkiksi:

*   Bird
*   Magic

muunnetaan muotoon:

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

Mutta tämä:

*   Bird

*   Magic

muunnetaan muotoon:

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

Luettelokohteet voivat sisältää useita kappaleita, ja kunkin kohteen alla olevat kappaleet on sisennettävä 4 välilyönnillä tai yhdellä sarkaimella:

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.

Se näyttää paljon paremmalta, jos sisestät jokaisen rivin, tietysti taas, jos olet laiska, Markdown sallii myös:

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

Jos haluat laittaa viitteen luettelokohteen sisään, niin > Se on sisennettävä:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Jos haluat laittaa koodilohkon, lohko on sisennettäväkahdesti, joka on 8 välilyöntiä tai 2 sarkainta:

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

        <代码写在这>

Tietenkin luettelo kohteista voi syntyä vahingossa, vaikkapa näin:

1986. What a great season.

Toisin sanoen se näkyy rivin alussanumero-piste-tyhjä, tämän välttämiseksi voit lisätä kenoviivan ennen pistettä.

1986\. What a great season.

代码 区块

Ohjelmaan liittyvä kirjoitus tai tagikielen lähdekoodi sisältää yleensä jo ladattuna koodilohkoja. Yleensä emme halua, että näitä lohkoja ladetaan yleisten kappaletiedostojen tapaan, vaan näytetään ne sellaisinaan. Markdown käyttää <pre> 和 <code> koodilohkot käärimään tageja.

Markdownin koodin rakennuspalikoita on niin yksinkertaista kuin sisentää esimerkiksi 4 välilyöntiä tai 1 sarkain, kirjoita seuraava:

这是一个普通段落：

    这是一个代码区块。

Markdown muuntaa muotoon:

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

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

Tämä ensimmäisen asteen sisennys riviä kohden (4 välilyöntiä tai 1 sarkain) poistetaan, esimerkiksi:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

muunnetaan muotoon:

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

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

Koodilohko jatkuu sisennyttämättömään riviin (tai tiedoston loppuun).

Koodilohkon sisällä & , < 和 > Se muunnetaan automaattisesti HTML-kokonaisuuksiksi, mikä tekee Markdownin käyttämisestä erittäin helppoa lisätäksesi esimerkin HTML-lähdekoodin. Kopioi ja liitä se, lisää sisennys, ja loput Markdownista hoitavat sen puolestasi. esimerkiksi:

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

muunnetaan muotoon:

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

Koodilohkossa yleistä Markdown-syntaksia ei muunneta, kuten tähdet ovat vain tähtiä, mikä tarkoittaa, että voit helposti kirjoittaa Markdown-syntaksiin liittyviä tiedostoja Markdown-syntaksilla.

jakaja

你 可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 来 建立 一个 分隔线 ， 行 内 不能 有 其他 东西 你 也 可以 在 星 号 或是 减号 中间 插入 空格 下面 每种 写法 都 都 可以 建立分隔线 ：

* * *

***

*****

- - -

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

osion elementti

链接

Markdown tukee kahta linkkien syntaksia: Linjassa和Viitekaksi muotoa.

Joka tapauksessa linkkiteksti on merkitty [hakasulkeilla].

luomaan aLinjassaJos haluat lisätä linkin otsikkotekstin, kierrä otsikkoteksti lainausmerkeillä URL-osoitteen jälkeen, esimerkiksi:

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

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

Tuottaa:

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

Jos linkität saman isännän resursseihin, voit käyttää suhteellisia polkuja:

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

ViiteLinkkiä seuraa toinen hakasulku linkkitekstin hakasulkeen jälkeen, ja linkin tunnistamiseen käytetty merkki tulee täyttää toiseen hakasulkeeseen:

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

Voit myös halutessasi laittaa välilyönnin kahden hakasulkeen väliin:

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

Sitten missä tahansa tiedoston kohdassa voit määrittää tämän tunnisteen linkin sisällön:

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

Linkin sisältö määritellään muodossa:

• Hakasulkeet (valinnaisesti edeltää enintään kolme välilyöntiä sisennystä varten), joihin linkin teksti syötetään
• jota seuraa kaksoispiste
• jota seuraa yksi tai useampi välilyönti tai sarkain
• seuraavan linkin URL-osoite
• Noudata valinnaisesti otsikon sisältöä, joka voidaan sulkea lainausmerkkeihin, kaksoislainausmerkkeihin tai sulkeisiin

Seuraavien kolmen linkin määritelmät ovat samat:

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

Varoitus:On tunnettu ongelma, jossa Markdown.pl 1.0.1 jättää huomioimatta linkkien otsikot yksittäisissä lainausmerkeissä.

Linkkien URL-osoitteet voidaan myös sulkea kulmasuluissa:

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

Voit myös laittaa otsikko-attribuutin seuraavalle riville tai lisätä sisennyksen, joka näyttää paremmalta, jos URL-osoite on liian pitkä:

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

URL-määrityksiä käytetään vain luotaessa linkkejä, eivätkä ne näy suoraan tiedostossa.

Linkin tunnistetunnisteet voivat sisältää kirjaimia, numeroita, välilyöntejä ja välimerkkejä, mutta eiväteiKirjainkoolla on merkitystä, joten seuraavat kaksi linkkiä ovat samat:

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

Implisiittinen linkkitunnisteominaisuuden avulla voit jättää linkkitunnisteen määrittämättä. Tässä tapauksessa linkkitunnistetta käsitellään vastaavana linkkitekstiä. Jos haluat käyttää implisiittistä linkkitunnistetta, lisää vain tyhjä hakasulke linkkitekstin perään. Jos haluat "Google" " Kun linkität osoitteeseen google.com, voit yksinkertaistaa seuraavaa:

[Google][]

Määritä sitten linkin sisältö:

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

Koska linkkiteksti voi sisältää välilyöntejä, tämä yksinkertaistettu merkintä voi sisältää useita sanoja:

Visit [Daring Fireball][] for more information.

Jatka sitten linkin määrittämistä:

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

Linkin määritelmä voidaan sijoittaa mihin tahansa tiedostoon. Laitan sen mieluummin suoraan sen kappaleen jälkeen, jossa linkki näkyy. Voit myös laittaa sen tiedoston loppuun, aivan kuten kommentin.

Tässä esimerkki viitelinkistä:

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"

Jos muutat sen käyttämään linkin nimeä kirjoittamiseen:

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"

Yllä olevat kaksi kirjoitustapaa tuottavat seuraavan HTML-koodin.

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

Alla on samansisältöinen Markdown-tiedosto, joka on kirjoitettu tekstiin vertailua varten:

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

Itse asiassa referenssityylisissä linkeissä ei ole se, että ne on helpompi kirjoittaa, vaan että ne on helpompi lukea. Vertaa yllä olevaa esimerkkiä. Viitteetyylinen artikkeli itsessään on vain 81 merkkiä, mutta tekstin sisäinen muoto kasvaa 176 merkkiä. , jos se on kirjoitettu puhtaassa HTML-muodossa, merkkiä on 234. HTML-muodossa tunnisteita on enemmän kuin tekstiä.

Markdownin viitetyylisten linkkien avulla voit tehdä asiakirjasta enemmän selaimen lopputuloksen kaltaisen, jolloin voit siirtää joitakin merkintöihin liittyviä metatietoja kappaletekstin ulkopuolelle ja voit lisätä linkkejä luomatta artikkelin lukutuntumaa. .

强调

Markdown käyttää tähtiä (*) ja alarivi (_) symbolina, joka merkitsee alleviivattua sanaa, on * 或 _ Ympäröivät sanat muunnetaan muotoiksi <em> tarrojen ympäröimä, kahdella * 或 _Jos se on kääritty, se muunnetaan <strong>,Esimerkiksi:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

muuttuu:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Voit käyttää mitä tahansa tyyliä, ainoa rajoitus on, että voit avata tagin millä symbolilla haluat sen lopettaa.

Korostus voidaan lisätä myös suoraan tekstin keskelle:

un*frigging*believable

muttajos sinun * 和 _ Jos molemmilla puolilla on välilyöntejä, niitä käsitellään vain normaaleina symboleina.

Voit lisätä tavallisia tähtiä tai alaviivoja suoraan ennen ja jälkeen tekstin käyttämällä kenoviivaa:

\*this text is surrounded by literal asterisks\*

Koodi

Jos haluat merkitä pienen palan upotettua koodia, voit kääriä sen backtickseihin (`),Esim:

Use the `printf()` function.

Tuottaa:

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

Jos haluat lisätä koodiosion sisään backticks, voit aloittaa ja lopettaa koodiosion useilla backticksillä:

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

Tämä syntaksi tuottaa:

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

Voit laittaa tyhjän koodiosan alkuun ja loppuun, yhden alun jälkeen ja toisen ennen loppua, jotta voit lisätä osion alkuun backtiks:

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

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

Tuottaa:

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

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

Koodiosion sisällä& ja kulmakiinnikkeet都muunnetaan automaattisesti HTML-kokonaisuuksiksi, mikä tekee HTML-lähdekoodin lisäämisestä helppoa, Markdown laittaa seuraavan kappaleen:

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

vastaanottajalle:

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

Voit myös kirjoittaa tämän:

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

Tuottaa:

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

图片

On selvää, että on vaikeaa suunnitella "luonnollista" syntaksia kuvien lisäämiselle vain teksti -sovelluksessa.

Markdown käyttää kuvien merkitsemiseen samanlaista syntaksia kuin linkit, ja se sallii myös kaksi tyyliä: Linjassa和Viite.

Sisäinen kuvan syntaksi näyttää tältä:

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

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

Yksityiskohdat ovat seuraavat:

• huutomerkki !
• 接着 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• Tätä seuraa normaalit sulkeet kuvan URL-osoitteella ja lopuksi valinnainen otsikkoteksti lainausmerkeissä.

Viitekuvan syntaksi näyttää tältä:

![Alt text][id]

"id" on kuvaviitteen nimi, joka määritellään samalla tavalla kuin linkkiviittaus:

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

Markdownilla ei toistaiseksi ole mahdollisuutta määrittää kuvan leveyttä ja korkeutta, voit tarvittaessa käyttää normaalia <img> etiketti.

其它

automaattinen linkki

Markdown tukee URL-osoitteiden ja sähköpostilaatikoiden käsittelyä suhteellisen lyhyiden automaattisten linkkien muodossa. Niin kauan kuin ne on suljettu kulmasuluissa, Markdown muuntaa sen automaattisesti linkiksi.Yleisen URL-osoitteen linkkiteksti on sama kuin linkin osoite, esimerkiksi:

<http://example.com/>

Markdown muunnetaan muotoon:

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

Sähköpostiosoitteiden automaattinen linkittäminen on myös hyvin samankaltaista, paitsi että Markdown suorittaa ensin koodausmuunnosprosessin, joka muuntaa tekstimerkit heksadesimaalimuotoisiksi HTML-kokonaisuuksiksi. Tämä muoto voi huijata joitain huonoja sähköpostiosoitteiden keräämisrobotteja, kuten:

<[email protected]>

Markdownista tulee:

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

Selaimessa tämä merkkijono (itse asiassa <a href="mailto:[email protected]">[email protected]</a>) muuttuu napsautettavaksi "[email protected]"-linkiksi.

(Vaikka tämä lähestymistapa voi huijata monia robotteja, se ei voi pysäyttää niitä kaikkia, mutta se on parempi kuin ei mitään. Joka tapauksessa postilaatikon avaaminen houkuttelee lopulta mainoskirjeitä.)

kenoviiva

Markdown voi käyttää kenoviivaa lisätäkseen symboleja, joilla on muita merkityksiä kielioppiin, esimerkiksi: jos haluat lisätä tähden tekstin viereen korostaakseen (mutta ei <em> tag), voit ennen tähtiä kenoviivalla:

\*literal asterisks\*

Markdown 支持 以下 这些 符号 前面 加上 反斜杠 来 帮助 插入 普通 的 符号 ：

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

Markdown ilmainen editori

Windows-alusta

• MarkdownPad
• MarkPad

Mac-alusta

• Mou

online-editori

• MPE-editori

selainlaajennus

• Merkitse tähän plugin

*** Jos on parempi ilmainen Markdown-editori suositella, kiinnitä huomiota palautteeseenChen Weiliang,Kiitos!