Kaj pomeni Markdown? Kako uporabljati sintakso Markdown/označevanje oblikovanja?

Kaj pomeni Markdown?

Kako uporabljati Markdown sintakso/označevanje oblikovanja?

Pregled

Markdown je lahek označevalni jezik, ki ga je ustvaril John Gruber.

Ljudem omogoča, da "pišejo dokumente v formatu navadnega besedila, ki je enostaven za branje in pisanje, in jih nato pretvorijo v veljavne dokumente XHTML (ali HTML).

Jezik vključuje številne funkcije označevanja navadnega besedila, ki jih že najdemo v e-pošti.

John Gruber je leta 2004 ustvaril jezik Markdown v sodelovanju z Aaronom Swartzom, v veliki meri na sintaksi.Namen jezika je uporaba "formate navadnega besedila, ki je enostaven za branje, enostaven za pisanje in se po želji pretvori v veljaven XHTML (ali HTML)".

namen

Cilj Markdowna je biti "enostaven za branje in enostaven za pisanje".

Berljivost je ključnega pomena; ne glede na to, kako izvajate spletni marketing , je uporabniška izkušnja najpomembnejša.

Datoteko, napisano v Markdownu, bi moralo biti mogoče objaviti neposredno v navadnem besedilu in ne bi smelo biti videti, da je sestavljena iz številnih oznak ali direktiv za oblikovanje.

Na sintakso Markdown vplivajo nekateri obstoječi formati besedila v HTML, vključno s Setext, atx, Textile, reStructuredText, Grutatext in EtText, vendar je največji vir navdiha oblika e-pošte z navadnim besedilom.

Skratka, sintaksa Markdown je sestavljena iz simbolov, ki so skrbno izbrani in njihove funkcije so jasne na prvi pogled.Na primer: okoli besedila postavite zvezdice, da bo videti kot *poudarek*.

Seznami v Markdown izgledajo kot, no, seznami. Blockquotes v Markdown res izgledajo kot citiranje dela besedila, kot ste ga videli v e-poštnih sporočilih.

Združljivo s HTML

Cilj slovnice Markdown je biti pisni jezik za splet.

Markdown ni mišljen, da bi nadomestil HTML ali se mu celo približal, ima zelo malo vrst sintakse in ustreza le majhnemu podnaboru oznak HTML. Markdown ni bil zasnovan za lažje pisanje dokumentov HTML.

Po mojem mnenju je HTML že tako dokaj enostaven za pisanje. Filozofija jezika Markdown je olajšati branje, pisanje in spreminjanje dokumentov. HTML je format za objavljanje, medtem ko je Markdown format za pisanje dokumentov . Zato sintaksa jezika Markdown pokriva le obseg, ki ga lahko zajame navadno besedilo.

Oznake, ki jih Markdown ne zajema, lahko uporabite neposredno v dokumentu HTML za pisanje spletnega promocijskega besedila. Ni vam treba izrecno navesti, ali gre za HTML ali Markdown; oznake preprosto dodajte neposredno.

Omejiti je treba samo nekatere elemente bloka HTML - kot npr <div>,<table>,<pre>,<p> in druge oznake, morajo biti ločene od drugih področij vsebine s praznimi vrsticami pred in za njimi, njihove začetne in končne oznake pa ne smejo biti zamaknjene z zavihki ali presledki. Generator Markdown je dovolj pameten, da ne dodaja nepotrebnih blokovnih oznak HTML <p> nalepko.

Primer je naslednji, dodajanje tabele HTML v datoteko Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Upoštevajte, da sintaksa oblikovanja Markdown med oznakami blokov HTML ne bo obdelana.Na primer, če uporabljate slog Markdown znotraj blokov HTML*强调*ne bo imelo učinka.

Oznake razdelka HTML (v vrstici), kot je npr <span>,<cite>,<del> Lahko se prosto uporablja v odstavkih, seznamih ali naslovih Markdown.Glede na osebne navade lahko celo uporabite oznake HTML za formatiranje brez uporabe formata Markdown.Primer: Če imate raje HTML <a> 或 <img> oznake, ki jih je mogoče uporabiti neposredno brez sintakse povezave ali slikovne oznake, ki jo zagotavlja Markdown.

Za razliko od blokovnih oznak HTML je sintaksa Markdown veljavna med oznakami odsekov HTML.

Samodejna pretvorba posebnih znakov

V datotekah HTML obstajata dva znaka, ki zahtevata posebno obravnavo: < In & . < simboli se uporabljajo za začetne oznake,& Simboli se uporabljajo za označevanje entitet HTML, če želite samo prikazati prototip teh znakov, morate uporabiti obrazec entitete, npr. < In &.

& Znaki so še posebej mučni za pisce spletnih dokumentov, če boste tipkali "AT&T", morate napisati "AT&T".medtem ko je v URL-ju & Pretvorjeni so tudi znaki.Na primer, želite se povezati z:

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

Pretvorbo URL-ja morate zapisati kot:

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

da se postavi v oznako povezave href v lastnostih.Ni treba posebej poudarjati, da je to enostavno prezreti in verjetno je največje število napak, ki jih odkrije preverjanje standardov HTML.

Markdown vam omogoča naravno pisanje znakov in poskrbi za to, kaj je treba pretvoriti.če uporabljate & Znak je del entitete znaka HTML, ostane tak, kot je, drugače se pretvori v &;.

Torej, če želite v dokument vstaviti simbol avtorskih pravic ©, lahko napišete:

©

Markdown ga bo pustil nedotaknjenega.In če napišete:

AT&T

Markdown ga bo pretvoril v:

AT&T

Podobna situacija se dogaja tudi v < zapis, saj Markdown omogoča združljivost HTML, če vnesete < Simboli se uporabljajo kot ločila za oznake HTML in Markdown jih ne bo pretvoril, če pa napišete:

4 < 5

Markdown ga bo pretvoril v:

4 < 5

Vendar je treba upoštevati, da v okviru kode, ne glede na to, ali je vstavljena ali blok, < In & oba simbolazagotovose pretvorijo v entitete HTML, funkcija, ki vam omogoča preprosto pisanje kode HTML v Markdown (v nasprotju s HTML, kamor vstavite vse < In & Vsi so pretvorjeni v entitete HTML, da se v datoteko HTML zapiše koda HTML. )

blok element

Odstavki in prelomi vrstic

Odstavek Markdown je sestavljen iz ene ali več zaporednih vrstic besedila, pred in za njimi pa je več kot ena prazna vrstica (definicija prazne vrstice je, da se na zaslonu zdi prazna in se šteje za prazno vrstico. Na primer, , če vrstica vsebuje samo presledke in tabulatorje, bo tudi vrstica obravnavana kot prazna vrstica).Običajni odstavki ne smejo biti zamaknjeni s presledki ali zavihki.

Besedna zveza "sestoji iz ene ali več zaporednih vrstic besedila" dejansko pomeni, da Markdown omogoča vsiljene nove vrstice (vstavljanje novih vrstic) znotraj odstavkov, funkcija, ki se razlikuje od večine drugih formatov besedila v HTML (vključno s premično vrsto "Pretvori prelome vrstic "), bodo drugi formati pretvorili vsak prelom vrstice v <br /> nalepko.

Če tiprav zaresZa vstavljanje se želite zanesti na Markdown <br /> Za oznake pritisnite dva ali več presledkov na mestu vstavljanja in nato pritisnite Enter.

Dejansko je za ustvarjanje potrebno malo več dela (dodatni prostori). <br /> , ampak preprosto "vsaka nova vrstica je pretvorjena v <br />"Metoda ni primerna v Markdown, em v MarkdownaiBlokirani narekovaji v slogu L in seznami z več odstavki niso samo bolj uporabni, ampak tudi lažji za branje pri stavljenju s prelomi vrstic.

Naslov

Markdown podpira dve sintaksi za naslove, podobno kot Setext in atx.

Obrazec, podoben Settextu, je obrazec s spodnjo vrstico, ki uporablja = (najvišji naziv) in - (Naslovi drugega reda), na primer:

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

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

poljubni znesek = In - lahko učinkovito.

Atx podoben obrazec vstavi 1 do 6 na začetek vrstice # , ki ustreza naslovom 1 do 6, na primer:

# 这是 H1

## 这是 H2

###### 这是 H6

Izbirno lahko "zaprete" atx podobne naslove, to je zgolj estetsko, če se tako počutite udobno, jih lahko dodate na konec vrstice #, medtem ko se vrstica konča # Ni nujno, da je številka enaka začetku (število znakov funtov na začetku vrstice določa vrstni red naslova):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Blokirani narekovaji za oznako markdown se uporabljajo podobno kot tisti, ki se uporabljajo v e-pošti > citatov.Če ste seznanjeni z narekovaji v e-poštnih pismih, veste, kako ustvariti blokovni narekovaj v datoteki Markdown, ki bi bil videti, kot da sami prelomite vrstice, nato pa dodate > :

> 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 vam omogoča tudi, da ste leni in dodate samo prvo vrstico celotnega odstavka > :

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

Sklici na bloke se lahko ugnezdijo (npr.: sklici znotraj sklicev) z dodajanjem različnega števila > :

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

Znotraj narekovanih blokov je mogoče uporabiti tudi druge sintakse Markdown, vključno z naslovi, seznami, kodnimi bloki itd.:

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

Vsak spodoben urejevalnik besedil lahko preprosto ustvari citate v slogu e-pošte. Na primer, v BBEditu lahko izberete besedilo in nato v meniju izberete dodajanje ravni citiranja.

列表

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

Neurejeni seznami uporabljajo zvezdice, znake plus ali znake minus kot oznake seznamov:

*   Red
*   Green
*   Blue

Enakovreden:

+   Red
+   Green
+   Blue

Tudi enakovredno:

-   Red
-   Green
-   Blue

Urejeni seznami uporabljajo številke, ki jim sledi pika:

1.  Bird
2.  McHale
3.  Parish

Pomembno je vedeti, da številke, ki jih uporabite v oznaki seznama, ne vplivajo na izhodni HTML. Končna oznaka HTML za zgornji seznam bi bila:

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

Če je oznaka vašega seznama zapisana kot:

1.  Bird
1.  McHale
1.  Parish

ali celo:

3. Bird
1. McHale
8. Parish

Oba bosta dobila popolnoma enak rezultat HTML.Bistvo je, da lahko številke seznama v datoteki Markdown naredite enake izhodnim rezultatom ali pa vam, če ste leni, sploh ni treba skrbeti za pravilnost številk.

Če uporabljate leno pisanje, je priporočljivo, da začnete z 1. za prvi element, ker lahko Markdown v prihodnosti podpira začetni atribut urejenih seznamov.

Oznaka elementa seznama je običajno postavljena skrajno levo, vendar je lahko zamaknjena, do 3 presledke, oznaki predmeta pa mora slediti vsaj en presledek ali tabulator.

Za lepši videz seznama lahko vsebino organizirate s fiksnim zamikom:

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

Če pa ste leni, je tudi v redu:

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

Če so elementi seznama ločeni s praznimi vrsticami, bo Markdown pri izpisu HTML uporabil vsebino elementa. <p> Etikete so zavite, na primer:

*   Bird
*   Magic

bo pretvorjen v:

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

Ampak tole:

*   Bird

*   Magic

bo pretvorjen v:

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

Elementi seznama lahko vsebujejo več odstavkov, odstavki pod vsakim elementom pa morajo biti zamaknjeni s 4 presledki ali 1 zavihkom:

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.

Videti je veliko bolje, če vsako vrstico zamaknete, seveda, spet, če ste leni, Markdown omogoča tudi:

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

Če želite v element seznama postaviti sklic, potem > Treba je zamakniti:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Če želite vključiti blok kode, mora biti ta blok dvakrat zamaknjen , kar je bodisi 8 presledkov bodisi 2 tabulatorja:

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

        <代码写在这>

Seveda se lahko seznam elementov ustvari pomotoma, nekako takole:

1986. What a great season.

Z drugimi besedami, da se izognete situaciji, ko se na začetku vrstice pojavi presledek med številom in piko , lahko pred piko dodate poševno črtico nazaj.

1986\. What a great season.

代码 区块

S programom povezano pisanje ali izvorna koda jezika oznak ima običajno že vnesene bloke kode. Običajno ne želimo, da so ti bloki vneseni kot datoteke splošnih odstavkov, ampak jih prikažemo takšne, kot so. Markdown bo uporabil <pre> In <code> oznake za zavijanje blokov kode.

Gradniki kode v Markdownu so tako preprosti kot zamik 4 presledkov ali 1 zavihka, na primer vnesite naslednje:

这是一个普通段落：

    这是一个代码区块。

Markdown se bo pretvoril v:

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

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

Ta zamik prvega reda na vrstico (4 presledki ali 1 tabulator) je odstranjen, na primer:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

bo pretvorjen v:

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

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

Blok kode se nadaljuje do nezamaknjene vrstice (ali konca datoteke).

Znotraj kodnega bloka, & , < In > Samodejno bo pretvorjen v entitete HTML. Ta metoda vam zelo olajša uporabo Markdowna za vstavljanje izvorne kode HTML za primer, preprosto jo kopirajte in prilepite, dodajte zamik, ostalo pa bo Markdown poskrbel za vas, za primer:

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

bo pretvorjen v:

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

V bloku kode splošna sintaksa Markdown ne bo pretvorjena, na primer zvezdice so samo zvezdice, kar pomeni, da lahko preprosto napišete datoteke, povezane s sintakso Markdown, v sintaksi Markdown.

delilnik

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

* * *

***

*****

- - -

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

element razdelka

povezava

Markdown podpira dve obliki sintakse povezovanja: vrstično in referenčno.

V vsakem primeru je besedilo povezave označeno z [oglatimi oklepaji].

Če želite ustvariti povezavo v vrstici , preprosto sledite oglatim oklepajem z oklepaji in vstavite URL. Če želite povezavi dodati tudi naslovno besedilo, preprosto za URL-jem postavite naslovno besedilo v dvojne narekovaje, na primer:

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

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

Izdelal bo:

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

Če se povezujete z viri na istem gostitelju, lahko uporabite relativne poti:

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

Povezave v slogu referenc se ustvarijo tako, da se besedilo povezave zapre v oklepaj, ki mu sledi še en niz oglatih oklepajev. Znotraj tega drugega niza oklepajev je treba namestiti oznako za identifikacijo povezave:

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

Po želji lahko vstavite tudi presledek med dvema oglatima oklepajema:

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

Nato lahko kjer koli v datoteki določite vsebino povezave te oznake:

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

Vsebina povezave je definirana v obliki:

• Oglati oklepaji (izbirno pred njimi do trije presledki za zamik), v katere se vnese besedilo povezave
• sledi dvopičje
• ki mu sledi en ali več presledkov ali zavihkov
• URL naslednje povezave
• Po želji sledite vsebini naslova, ki je lahko v enojnih narekovajih, dvojnih narekovajih ali oklepajih

Definicije naslednjih treh povezav so enake:

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

Opomba: Znana je težava, da Markdown.pl 1.0.1 prezre naslove povezav, zaprte v enojne narekovaje.

URL-ji povezav so lahko tudi v oglatih oklepajih:

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

Atribut naslova lahko postavite tudi v naslednjo vrstico ali dodate nekaj zamika, kar bo videti bolje, če bo URL predolg:

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

Definicija URL-ja se uporablja samo pri generiranju povezave in se ne prikaže neposredno v datoteki.

Identifikatorji povezav lahko vsebujejo črke, številke, presledke in ločila, vendar ne razlikujejo med velikimi in malimi črkami; zato sta spodnji povezavi enaki:

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

Implicitne oznake povezav vam omogočajo, da izpustite navedbo oznake povezave. V tem primeru se oznaka povezave obravnava kot enakovredna besedilu povezave. Če želite uporabiti implicitne oznake povezav, preprosto dodajte prazen oglati oklepaj za besedilom povezave. Če želite, da »Google« povezuje na google.com, lahko to poenostavite na:

[Google][]

Nato določite vsebino povezave:

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

Ker lahko besedilo povezave vsebuje presledke, lahko ta poenostavljena oznaka vsebuje več besed:

Visit [Daring Fireball][] for more information.

Nato nadaljujte z definiranjem povezave:

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

Definicijo povezave lahko postavite kamor koli v datoteki. Najraje jo dam neposredno za odstavkom, kjer se pojavi povezava. Lahko jo postavite tudi na konec datoteke, tako kot komentar.

Tukaj je primer referenčne povezave:

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"

Če ga spremenite tako, da uporabite ime povezave za pisanje:

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"

Zgornja dva načina pisanja bosta ustvarila naslednji 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>

Spodaj je datoteka Markdown z isto vsebino, zapisana v vrstici, za primerjavo:

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

Pravzaprav bistvo povezav v referenčnem slogu ni v tem, da jih je lažje napisati, ampak v tem, da jih je lažje brati. Primerjajte zgornji primer. Sam članek v referenčnem slogu ima samo 81 znakov, vendar se bo vstavljena oblika povečala na 176 znakov. , če je napisan v čisti obliki HTML, bo znakov 234. V obliki HTML je več oznak kot besedila.

Z uporabo povezav v referenčnem slogu Markdown lahko naredite dokument bolj podoben končnemu rezultatu brskalnika, kar vam omogoča, da nekatere metapodatke, povezane z označevanjem, premaknete izven besedila odstavka, poleg tega pa lahko dodate povezave, ne da bi pri tem naredili občutek branja članka. .

强调

Markdown uporablja zvezdice (*) in spodnja vrstica (_) kot simbol za označevanje podčrtane besede, je * 或 _ Obkrožene besede se pretvorijo v <em> obdan z nalepkami, z dvema * 或 _Če je zavit, se bo spremenil v <strong>, npr.:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

se bo spremenil v:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Uporabite lahko poljubni slog, edina omejitev je, da lahko oznako odprete s katerim simbolom jo želite končati.

Poudarke lahko vstavite tudi neposredno na sredino besedila:

un*frigging*believable

ampakče tvoj * In _ Če so na obeh straneh presledki, se obravnavajo kot običajni simboli.

Če želite vstaviti običajne zvezdice ali podčrtaje neposredno pred in za besedilom, lahko uporabite poševnice nazaj:

\*this text is surrounded by literal asterisks\*

Koda

Če želite označiti majhen košček vstavljene kode, ga lahko zavijete v povratne kljukice (`), npr.:

Use the `printf()` function.

Izdelal bo:

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

Če želite v odsek kode vstaviti povratne oznake, lahko začnete in končate razdelek kode z več povratnimi oznakami:

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

Ta sintaksa ustvari:

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

Na začetek in konec odseka kode lahko postavite prazno, enega za začetkom in enega pred koncem, tako da lahko vstavite povratne kljukice na začetek odseka:

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

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

Izdelal bo:

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

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

Znotraj razdelka kode,& in kotne oklepaje都bo samodejno pretvorjen v entitete HTML, kar olajša vstavljanje izvorne kode HTML, bo Markdown postavil naslednji odstavek:

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

za:

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

Lahko napišete tudi tole:

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

Izdelovati:

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

图片

Očitno je težko oblikovati "naravno" sintakso za vstavljanje slik v aplikacijo samo z besedilom.

Markdown uporablja sintakso, podobno kot povezave, za označevanje slik in omogoča tudi dva sloga: inline in reference.

Sintaksa slike v vrstici izgleda takole:

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

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

Podrobnosti so naslednje:

• klicaj !
• 接着 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• Temu sledijo običajni oklepaji z URL-jem slike in na koncu neobvezno besedilo 'naslova' v narekovajih.

Sintaksa referenčne slike je videti takole:

![Alt text][id]

"id" je ime sklica na sliko, ki je definiran na enak način kot sklic na povezavo:

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

Zaenkrat Markdown ne more določiti širine in višine slike, če potrebujete, lahko uporabite običajno <img> nalepko.

其它

samodejna povezava

Markdown podpira obdelavo URL-jev in e-poštnih nabiralnikov v obliki relativno kratkih samodejnih povezav. Dokler so v oglatih oklepajih, jih bo Markdown samodejno pretvoril v povezavo.Besedilo povezave splošnega URL-ja je enako naslovu povezave, na primer:

<http://example.com/>

Markdown bo pretvorjen v:

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

Samodejno povezovanje e-poštnih naslovov je prav tako zelo podobno, le da bo Markdown najprej izvedel postopek pretvorbe kodiranja in pretvoril besedilne znake v heksadecimalne entitete HTML. Ta oblika lahko preslepi nekatere slabe robote za zbiranje e-poštnih naslovov, kot so:

<[email protected]>

Markdown se bo spremenil v:

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

V brskalniku ta niz (pravzaprav <a href="mailto:[email protected]">[email protected]</a>) postane povezava »[email protected]«, ki jo je mogoče klikniti.

(Čeprav lahko ta pristop preslepi veliko robotov, ne more ustaviti vseh, vendar je bolje kot nič. V vsakem primeru bo odpiranje vašega nabiralnika sčasoma pritegnilo reklamna pisma.)

poševnica nazaj

Markdown lahko uporablja poševnice nazaj za vstavljanje simbolov, ki imajo v slovnici druge pomene, na primer: če želite poleg besedila dodati zvezdico za poudarek (vendar ne <em> oznako), lahko pred zvezdico postavite poševnico nazaj:

\*literal asterisks\*

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

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

Brezplačni urejevalnik Markdown

Windows platforma

• MarkdownPad
• MarkPad

Mac platforma

• soft

spletni urednik

• MPEditor

vtičnik brskalnika

• Vtičnik Markdown here

*** Če imate kakšna boljša priporočila za brezplačne urejevalnike Markdown, prosim sporočite Chen Weiliangu . Hvala!