Mit jelent a Markdown? Hogyan kell használni a Markdown szintaxis/formázási jelölést?

ÁrleszállításMit jelent?

Hogyan kell használni a Markdown szintaxis-/formátumjelölést?

Áttekintés

A Markdown egy egyszerű jelölőnyelv, amelyet John Gruber hozott létre.

Lehetővé teszi az emberek számára, hogy "egyszerű szöveges formátumban írjanak dokumentumokat, amelyek könnyen olvashatók és írhatók, majd azokat érvényes XHTML (vagy HTML) dokumentumokká konvertálják".

A nyelv magában foglalja az egyszerű szöveges jelölés számos funkcióját, amely már megtalálható az e-mailekben.

John Gruber 2004-ben hozta létre a Markdown nyelvet, Aaron Swartz-cal együttműködve, nagyrészt a szintaxis terén.A nyelv célja, hogy "egy egyszerű szöveges formátumot használjon, amely könnyen olvasható, könnyen írható, és opcionálisan érvényes XHTML-re (vagy HTML-re) konvertálható".

célja

A Markdown célja, hogy „könnyen olvasható és könnyen írható legyen”.

olvashatóság, mindenképp csináld网络 营销, a felhasználói élmény nagyon fontos.

A Markdown programban írt fájlokat közvetlenül egyszerű szövegként kell közzétenni, és nem szabad úgy tűnik, hogy sok címkéből vagy formázási direktívából áll.

A Markdown szintaxisát befolyásolják néhány létező szöveg-HTML formátum, köztük a Setext, az atx, a Textile, a reStructuredText, a Grutatext és az EtText, de a legnagyobb inspirációt az egyszerű szöveges e-mail formátum jelenti.

Röviden, a Markdown szintaxisa mind szimbólumokból áll, amelyeket gondosan kiválasztottak, és funkcióik egy pillantásra egyértelműek.Például: tegyen csillagokat a szöveg köré, hogy úgy nézzen ki, mint *kiemelés*.

A Markdown listái úgy néznek ki, mint a listák. A Markdown-ban a blokkos idézetek valóban úgy néznek ki, mint egy szövegrész idézése, ahogyan azt az e-mailekben láthatta.

HTML-el kompatibilis

A Markdown nyelvtan célja, hogy írásnyelv legyen a weben.

A Markdown nem helyettesíti a HTML-t, sőt nem is közelíti meg azt, nagyon kevés szintaxist tartalmaz, és a HTML-jelölések csak egy kis részhalmazának felel meg. A Markdownt nem arra tervezték, hogy megkönnyítse a HTML-dokumentumok írását.

Véleményem szerint a HTML-t már könnyű írni. A Markdown célja, hogy megkönnyítse a dokumentumok olvashatóságát, írását és tetszőleges megváltoztatását. A HTML egy publikációs formátum, a Markdown pedig egySzövegírásírott formában.Mint ilyen, a Markdown formázási szintaxisa csak azt fedi le, amit az egyszerű szöveg tud.

A Markdown által nem érintett címkék közvetlenül a dokumentumba írhatók HTML-benWebes promóciómásolat.Nem kell ezt HTML-ként vagy Markdown-ként megjelölni, csak adja hozzá közvetlenül a jelölést.

Csak néhány HTML blokk elemet kell korlátozni - mint pl <div>,<table>,<pre>,<p> és egyéb címkék, azokat a többi tartalomterülettől üres sorokkal kell elválasztani előtte és utána, nyitó és záró címkéiket nem lehet tabulátorral vagy szóközzel behúzni. A Markdown generátor elég okos ahhoz, hogy ne adjon hozzá szükségtelen HTML blokkcímkéket <p> címke.

A példa a következő, egy HTML-táblázat hozzáadása a Markdown fájlhoz:

这是一个普通段落。

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

这是另一个普通段落。

Vegye figyelembe, hogy a HTML blokkcímkék közötti Markdown formázási szintaxis nem kerül feldolgozásra.Például, ha Markdown stílust használ egy HTML blokkon belül*强调*nem lesz hatása.

HTML szakasz (inline) címkék, mint pl <span>,<cite>,<del> Szabadon használható Markdown bekezdésekben, listákban vagy címsorokban.A személyes szokásoknak megfelelően akár HTML-címkékkel is formázhat Markdown formátum használata nélkül.Példa: Ha jobban szereti a HTML-t <a> 或 <img> címkéket, amelyek közvetlenül használhatók a Markdown által biztosított hivatkozás vagy képcímke szintaxisa nélkül.

A HTML blokkcímkéktől eltérően a Markdown szintaxis a HTML szakaszcímkék között érvényes.

Speciális karakterek automatikus konvertálása

A HTML-fájlokban két olyan karakter található, amelyek különleges kezelést igényelnek: < 和 & . < szimbólumokat használnak a kezdő címkékhez,& A szimbólumok a HTML entitások jelölésére szolgálnak, ha csak ezeknek a karaktereknek a prototípusát szeretné megjeleníteni, akkor az entitás formát kell használni, mint pl. < 和 &.

& A karakterek különösen kínosak a webes dokumentumírók számára, ha azt akarják, hogy ""AT&T", írnod ​​kell"AT&T".míg az URL-ben & A karakterek is konvertálódnak.Például a következőkre szeretne hivatkozni:

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

Az URL-konverziót a következőképpen kell megírnia:

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

a linkcímkébe kell helyezni href ingatlanokban.Mondanunk sem kell, hogy ezt könnyű figyelmen kívül hagyni, és valószínűleg a HTML-szabványok érvényesítése során észlelt hibák legnagyobb száma.

A Markdown lehetővé teszi a karakterek természetes írását, és gondoskodik arról, hogy mit kell konvertálni.ha használod & A karakter egy HTML karakter entitás része, így marad, ellenkező esetben a rendszer átalakítja azzá &;.

Tehát ha szerzői jogi szimbólumot szeretne beilleszteni a dokumentumba ©, tudsz írni:

©

A Markdown érintetlenül hagyja.És ha azt írod:

AT&T

A Markdown a következőre konvertálja:

AT&T

Hasonló szituáció is előfordul itt < jelölést, mivel a Markdown lehetővé teszi a HTML-kompatibilitást, ha megadja < A szimbólumokat a HTML-címkék elválasztóként használják, és a Markdown nem hajt végre rajtuk semmilyen konverziót, de ha ezt írja:

4 < 5

A Markdown a következőre konvertálja:

4 < 5

Meg kell azonban jegyezni, hogy a kód hatókörén belül, akár inline, akár blokk, < 和 & mindkét szimbólumbiztosanHTML entitásokká konvertálódnak, ez a funkció lehetővé teszi, hogy egyszerűen írjon HTML kódot a Markdown alkalmazásban (szemben a HTML-lel, ahol minden < 和 & Mindegyiket HTML entitásokká alakítják, hogy HTML kódot írhassanak a HTML fájlba. )

blokk elem

Bekezdések és sortörések

A Markdown bekezdés egy vagy több egymást követő szövegsorból áll, amelyeket egynél több üres sor előz meg és követ (az üres sor definíciója az, hogy a kijelzőn üresnek tűnik, és üres sornak tekintendő. Például, ha egy sor csak szóközöket és tabulátorokat tartalmaz, a sort is üres sorként kezeli a rendszer).A normál bekezdéseket nem szabad szóközzel vagy tabulátorral behúzni.

Az "egy vagy több egymást követő szövegsorból áll" kifejezés valójában azt jelenti, hogy a Markdown lehetővé teszi a kényszerített újsorok beszúrását (újsorok beszúrását) a bekezdéseken belül, ez a funkció különbözik a legtöbb más szöveg-HTML formátumtól (beleértve a mozgatható típus "Sortörések konvertálása " opció), más formátumok minden sortörést a következőre konvertálnak <br /> címke.

Ha tevalóbanA beszúrásnál a Markdownra szeretne támaszkodni <br /> Címkék esetén nyomja meg a két vagy több szóközt a beillesztési helyen, majd nyomja meg az Enter billentyűt.

Valójában egy kicsit több munkára (további helyekre) van szükség a generáláshoz <br /> , hanem egyszerűen "minden újsor át lesz konvertálva <br />"A módszer nem megfelelő a Markdownban, em a MarkdownbanaiAz L-stílusú idézőjelek és a több bekezdésből álló listák nemcsak hasznosabbak, hanem könnyebben olvashatók is, ha sortöréssel szedünk.

Headline

A Markdown két szintaxist támogat a címsorokhoz: Setext-szerű és atx-szerű.

A Settext-szerű űrlap az az űrlap, amelynek alsó sora van, használva = (legmagasabb cím) és - (Másodrendű címsorok), például:

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

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

bármennyi = 和 - hatékony lehet.

Az Atx-szerű forma 1-től 6-ig szúr be a sor elejére # , amely megfelel az 1–6. címsoroknak, például:

# 这是 H1

## 这是 H2

###### 这是 H6

Opcionálisan "bezárhatod" az atx-szerű fejlécet, ez pusztán az esztétikai szempont, ha így érzed jól magad, akkor a sor végére rakhatod #, míg a sorvégek # A számnak nem kell megegyeznie az elejével (a sor elején lévő font karakterek száma határozza meg a cím sorrendjét):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

A Markdown jelölőblokk idézőjelek az e-mailekben használtakhoz hasonlóan használatosak > idézetek közül.Ha ismeri az e-mail levelekben használt idézőjeleket, tudja, hogyan hozhat létre blokk idézetet Markdown fájlban, amely úgy néz ki, mintha saját maga törné meg a sorokat, majd adja hozzá > :

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

A Markdown azt is lehetővé teszi, hogy lustálkodjon, és csak a teljes bekezdés első sorát adja hozzá > :

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

A blokkhivatkozások beágyazhatók (pl. hivatkozások a hivatkozásokon belül) eltérő számú hivatkozás hozzáadásával > :

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

Más Markdown szintaxisok is használhatók idézőjeles blokkon belül, beleértve a címsorokat, listákat, kódblokkokat stb.:

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

Bármely tisztességes szövegszerkesztő könnyen létrehozhat e-mail stílusú idézeteket.Például a BBEditben kiválaszthat szöveget, majd kiválaszthat a menübőlaz idézési hierarchia növelése.

lista

A Markdown támogatja a rendezett és rendezetlen listákat.

A rendezetlen listák csillagokat, plusz- vagy mínuszjeleket használnak listajelzőként:

*   Red
*   Green
*   Blue

Egyenértékű:

+   Red
+   Green
+   Blue

Szintén egyenértékű:

-   Red
-   Green
-   Blue

A rendezett listák számokat használnak, amelyeket pont követ:

1.  Bird
2.  McHale
3.  Parish

Fontos megjegyezni, hogy a listacímkében használt számok nem befolyásolják a kimeneti HTML-t. A fenti lista eredményül kapott HTML-jelölése a következő lesz:

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

Ha a lista jelölése így van írva:

1.  Bird
1.  McHale
1.  Parish

vagy akár:

3. Bird
1. McHale
8. Parish

Mindketten pontosan ugyanazt a HTML-kimenetet kapják.A lényeg az, hogy a Markdown fájlban lévő listaszámokat a kimeneti eredményekkel azonossá teheted, vagy ha lusta vagy, akkor egyáltalán nem kell törődni a számok helyességével.

Ha lusta írást használunk, akkor az első elemnél ajánlatos 1.-el kezdeni, mert a Markdown a jövőben támogathatja a rendezett listák start attribútumait.

A listaelem címkéje általában a bal szélre kerül, de behúzható, legfeljebb 3 szóköz lehet, és az item címkét legalább egy szóköznek vagy tabulátornak kell követnie.

A lista szebb kinézete érdekében a tartalmat rögzített behúzással rendezheti:

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

De ha lusta vagy, az is jó:

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

Ha a listaelemeket üres sorok választják el, a Markdown az elem tartalmát fogja használni a HTML kiadásakor. <p> A címkéket becsomagolják, például:

*   Bird
*   Magic

a következőre lesz konvertálva:

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

De ez:

*   Bird

*   Magic

a következőre lesz konvertálva:

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

A listaelemek több bekezdést is tartalmazhatnak, és az egyes tételek alatti bekezdéseket 4 szóközzel vagy 1 tabulátorral kell behúzni:

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.

Sokkal jobban néz ki, ha minden sort behúz, természetesen ismét, ha lusta vagy, a Markdown is lehetővé teszi:

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

Ha hivatkozást szeretne elhelyezni egy listaelemen belül, akkor > Be kell húzni:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ha kódblokkot akarunk elhelyezni, akkor a blokkot be kell húznikétszer, ami 8 szóköz vagy 2 tabulátor:

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

        <代码写在这>

Természetesen véletlenül is létrejöhet az elemek listája, valami ilyesmi:

1986. What a great season.

Más szóval, a sor elején jelenik megszám-pont-üres, ennek elkerülése érdekében a pont elé egy fordított perjelet írhat.

1986\. What a great season.

kódblokk

A programokhoz kapcsolódó írási vagy címkenyelvi forráskód általában már tartalmaz beírt kódblokkokat. Általában nem akarjuk, hogy ezek a blokkok az általános bekezdésfájlok módjában legyenek szedve, hanem úgy jelenítsük meg őket, ahogy vannak. A Markdown a <pre> 和 <code> címkék a kódblokkok tördeléséhez.

A Markdown kód építőelemei olyan egyszerűek, mint például 4 szóköz vagy 1 tabulátor behúzása, írja be a következőket:

这是一个普通段落：

    这是一个代码区块。

A Markdown a következőre lesz konvertálva:

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

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

Ez az elsőrendű soronkénti behúzás (4 szóköz vagy 1 tabulátor) el lesz távolítva, például:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

a következőre lesz konvertálva:

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

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

A kódblokk a behúzatlan sorig (vagy a fájl végéig) folytatódik.

A kódblokkon belül, & , < 和 > A rendszer automatikusan HTML entitásokká konvertálja. Ezzel a módszerrel nagyon egyszerűen használhatja a Markdown-t a példa HTML-forráskódjának beszúrásához, csak másolja ki és illessze be, adjon hozzá behúzást, a többit pedig a Markdown kezeli helyette. példa:

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

a következőre lesz konvertálva:

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

A kódblokkban az általános Markdown szintaxis nem konvertálódik, például a csillagok csak csillagok, ami azt jelenti, hogy egyszerűen írhat Markdown szintaxissal kapcsolatos fájlokat Markdown szintaxisban.

osztó

Létrehozhat egy elválasztót háromnál több csillaggal, mínuszjellel, aláhúzással egy sorban, semmi mást nem tartalmaz a sorban.A csillagok vagy mínuszjelek közé szóközt is beszúrhat.Az elválasztó vonalak a következő írásmódok mindegyikével hozhatók létre:

* * *

***

*****

- - -

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

szakasz elem

链接

A Markdown a hivatkozás szintaxisának két formáját támogatja: Sorban和Referenciakét forma.

Akárhogy is, a hivatkozás szövegét [szögletes zárójel] jelzi.

létrehozni aSorbanHa hozzá szeretné adni a link címszövegét, csak tegye a cím szövegét dupla idézőjelbe az URL után, például:

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

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

Termelni fog:

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

Ha ugyanazon a gazdagépen található erőforrásokra hivatkozik, használhat relatív elérési utat:

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

ReferenciaA hivatkozást a hivatkozás szövegének zárójele után egy újabb szögletes zárójel követi, a második szögletes zárójelbe pedig a hivatkozás azonosítására szolgáló jelet kell kitölteni:

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

Opcionálisan szóközt is tehet a két szögletes zárójel közé:

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

Ezután a fájlban bárhol meghatározhatja a címke hivatkozás tartalmát:

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

A link tartalma a következő formában van meghatározva:

• Szögletes zárójelek (opcionálisan legfeljebb három szóköz előtt lehet behúzni), amelyekbe a hivatkozás szövege kerül beírásra
• kettőspont követi
• egy vagy több szóköz vagy tabulátor követi
• a következő link URL-je
• Opcionálisan kövesse a cím tartalmát, amely egyszeres, dupla idézőjelek vagy zárójelek közé tehető

A következő három hivatkozás definíciója megegyezik:

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

Vigyázat:Ismert egy olyan probléma, amely miatt a Markdown.pl 1.0.1 figyelmen kívül hagyja az idézőjelekbe zárt hivatkozáscímeket.

A link URL-ek szögletes zárójelekbe is foglalhatók:

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

A következő sorba is elhelyezheti a title attribútumot, vagy behúzhat egy kis behúzást, ami jobban fog kinézni, ha az URL túl hosszú:

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

Az URL-definíció csak a hivatkozás generálásakor használatos, és nem jelenik meg közvetlenül a fájlban.

A linkazonosító címkék tartalmazhatnak betűket, számokat, szóközöket és írásjeleket, de nemnemEz megkülönbözteti a kis- és nagybetűket, így a következő két hivatkozás megegyezik:

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

Implicit link címkeA funkció lehetővé teszi a linkcímke megadásának elhagyását. Ebben az esetben a linkcímkét a rendszer a linkszöveggel egyenértékűként kezeli. Implicit linkcímke használatához csak adjon meg egy üres szögletes zárójelet a hivatkozás szövege után. Ha azt szeretné, hogy "Google" " A google.com webhelyre való hivatkozással leegyszerűsítheti a következőket:

[Google][]

Ezután határozza meg a link tartalmát:

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

Mivel a link szövege szóközt tartalmazhat, ez az egyszerűsített jelölés több szót is tartalmazhat:

Visit [Daring Fireball][] for more information.

Ezután folytassa a hivatkozás meghatározásával:

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

A hivatkozás definíciója bárhol elhelyezhető a fájlban.Inkább közvetlenül a bekezdés után, ahol a hivatkozás jelenik meg, a fájl végére is tehetjük, akárcsak egy megjegyzés.

Íme egy példa egy hivatkozási hivatkozásra:

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"

Ha megváltoztatja, hogy a hivatkozás nevét használja az íráshoz:

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"

A fenti két írásmód a következő HTML-t eredményezi.

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

Az alábbiakban egy azonos tartalmú Markdown-fájl látható, soron belül, összehasonlítás céljából:

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

Valójában a hivatkozási stílusú hivatkozások lényege nem az, hogy könnyebb írni, hanem az, hogy könnyebben olvasható legyen Hasonlítsa össze a fenti példát Maga a hivatkozási stílusú cikk mindössze 81 karakterből áll, de a soron belüli forma növekszik 176 karakter. , ha tiszta HTML formátumban írják, akkor 234 karakter lesz. HTML formátumban több címke van, mint szöveg.

A Markdown referencia-stílusú hivatkozásaival a dokumentumot jobban hasonlíthatja a böngésző végeredményéhez, lehetővé téve néhány jelöléssel kapcsolatos metaadat áthelyezését a bekezdés szövegén kívülre, és linkeket is hozzáadhat anélkül, hogy a cikk olvasási érzetét keltené. .

强调

A Markdown csillagokat használ (*) és az alsó sor (_) szimbólumként egy aláhúzott szót jelöl * 或 _ A környező szavakat a rendszer konvertálja <em> címkékkel körülvéve, kettővel * 或 _Ha be van csomagolva, akkor át lesz alakítva <strong>,Például:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

átalakul:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Bármilyen stílust használhatsz, csak az a korlátozás, hogy a címkét megnyithatod, melyik szimbólummal szeretnéd befejezni.

A hangsúly közvetlenül a szöveg közepébe is beilleszthető:

un*frigging*believable

deha a * 和 _ Ha mindkét oldalon szóköz van, akkor a rendszer csak normál szimbólumként kezeli őket.

Ha normál csillagokat vagy aláhúzásjeleket szeretne beszúrni közvetlenül a szöveg elé és után, használhat fordított perjelet:

\*this text is surrounded by literal asterisks\*

Kód

Ha a soron belüli kód egy kis darabját szeretné megjelölni, becsomagolhatja backtickbe (`),Például:

Use the `printf()` function.

Termelni fog:

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

Ha backtick-et szeretne beszúrni egy kódszakaszba, akkor a kódszakaszt több backtick-el is elindíthatja és befejezheti:

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

Ez a szintaxis a következőket eredményezi:

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

A kódszakasz elejére és végére üreset tehet, egyet az eleje után és egyet a vége elé, így a szakasz elejére beszúrhat backticket:

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

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

Termelni fog:

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

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

A kódrészen belül& és szögletes zárójelek都automatikusan HTML entitásokká konvertálódik, ami megkönnyíti a HTML forráskód beillesztését, a Markdown a következő bekezdést helyezi el:

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

nak nek:

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

Ezt is írhatod:

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

Termelni:

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

图片

Nyilvánvaló, hogy nehéz "természetes" szintaxist tervezni képek beszúrására egy csak szöveges alkalmazásban.

A Markdown a linkek szintaxisához hasonló szintaxist használ a képek jelölésére, és két stílust is lehetővé tesz: Sorban和Referencia.

A szövegközi kép szintaxisa így néz ki:

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

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

A részletek a következők:

• egy felkiáltójel !
• majd egy szögletes zárójel a kép alternatív szövegével
• Ezután egy normál zárójelet, helyezze bele a kép URL-jét, végül tegye idézőjelbe, és adjon hozzá egy opcionális "cím" szöveget.

A referenciakép szintaxisa így néz ki:

![Alt text][id]

Az "id" a képhivatkozás neve, amely ugyanúgy definiálható, mint egy hivatkozási hivatkozás:

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

A Markdown egyelőre nem tudja megadni a kép szélességét és magasságát, ha kell, használhatja a normált <img> címke.

其它

automatikus link

A Markdown támogatja az URL-ek és az e-mail postafiókok viszonylag rövid automatikus hivatkozások formájában történő feldolgozását, mindaddig, amíg szögletes zárójelben vannak, a Markdown automatikusan linkké alakítja.Az általános URL hivatkozás szövege megegyezik a link címével, például:

<http://example.com/>

A Markdown a következőre lesz konvertálva:

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

Az e-mail címek automatikus összekapcsolása is nagyon hasonló, kivéve, hogy a Markdown először egy kódolási átalakítási folyamatot hajt végre, a szöveges karaktereket hexadecimális HTML-entitásokká alakítja át. Ez a formátum megtéveszthet néhány rossz e-mail-címgyűjtő robotot, például:

<[email protected]>

A Markdown a következőre változik:

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

A böngészőben ez a karakterlánc (valójában <a href="mailto:[email protected]">[email protected]</a>) kattintható "[email protected]" link lesz.

(Bár ez a megközelítés sok robotot megtéveszthet, nem állíthatja meg őket, de jobb, mint a semmi. Mindenesetre a postafiók kinyitása előbb-utóbb reklámleveleket vonz.)

fordított perjel

A Markdown fordított perjeleket használhat olyan szimbólumok beszúrására, amelyeknek más jelentése van a nyelvtanban, például: ha csillagot szeretne hozzáadni a szöveg mellé a kiemelés érdekében (de nem <em> címke), a csillag elé írhat egy fordított perjelet:

\*literal asterisks\*

A Markdown a következő szimbólumokat támogatja, amelyeket fordított perjel előz meg a gyakori szimbólumok beszúrásának elősegítése érdekében:

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

Markdown ingyenes szerkesztő

Windows platform

• MarkdownPad
• MarkPad

Mac platform

• Mou

online szerkesztő

• MPE-szerkesztő

böngésző plugin

• Markdown here plugin

*** Ha van jobb ingyenes Markdown szerkesztő ajánlani, kérjük, figyeljen a visszajelzésekreChen Weiliang,Köszönöm!