Ano ang ibig sabihin ng Markdown? Paano gamitin ang Markdown syntax/formatting markup?

MarkdownAno ang ibig sabihin

Paano gamitin ang Markdown syntax/formatting markup?

Pangkalahatang-ideya

Ang Markdown ay isang magaan na markup language na nilikha ni John Gruber.

Pinapayagan nito ang mga tao na "magsulat ng mga dokumento sa plain text na format na madaling basahin at isulat, at pagkatapos ay i-convert ang mga ito sa mga wastong XHTML (o HTML) na dokumento."

Isinasama ng wika ang marami sa mga tampok ng plain text markup na nakita na sa e-mail.

Nilikha ni John Gruber ang wikang Markdown noong 2004, sa pakikipagtulungan kay Aaron Swartz sa malaking bahagi sa syntax.Ang layunin ng wika ay gumamit ng "isang plain text na format na madaling basahin, madaling isulat, at opsyonal na magko-convert sa wastong XHTML (o HTML)".

layunin

Ang layunin ng Markdown ay makamit ang "madaling basahin at madaling isulat".

pagiging madaling mabasa, gawin mo pa rinpagmemerkado gamit ang internet, ang karanasan ng gumagamit ay napakahalaga.

Ang isang dokumentong nakasulat sa Markdown ay dapat na mai-publish nang direkta sa plain text, at hindi dapat mukhang binubuo ng maraming tag o mga direktiba sa pag-format.

Ang markdown syntax ay naiimpluwensyahan ng ilang kasalukuyang text-to-HTML na format, kabilang ang Setext, atx, Textile, reStructuredText, Grutatext, at EtText, ngunit ang pinakamalaking pinagmumulan ng inspirasyon ay ang plain text na format ng email.

Sa madaling salita, ang syntax ng Markdown ay binubuo lahat ng mga simbolo, na maingat na pinili at ang kanilang mga function ay malinaw sa isang sulyap.Halimbawa: maglagay ng mga asterisk sa paligid ng text para maging parang *emphasis*.

Ang mga listahan sa Markdown ay mukhang mga listahan. Ang mga blockquotes sa Markdown ay talagang parang pag-quote ng isang piraso ng text, tulad ng nakita mo sa mga email.

Tugma sa HTML

Ang layunin ng Markdown grammar ay maging isang writing language para sa web.

Ang Markdown ay hindi sinadya upang palitan ang HTML, o kahit na lumapit dito, mayroon itong napakakaunting mga uri ng syntax at tumutugma lamang sa isang maliit na subset ng HTML markup. Ang Markdown ay hindi ipinaglihi upang gawing mas madaling isulat ang mga HTML na dokumento.

Sa aking palagay, ang HTML ay madali nang isulat. Ang ideya ng Markdown ay gawing mas madaling basahin, isulat, at baguhin ang mga dokumento ayon sa gusto. Ang HTML ay isang format ng pag-publish, ang Markdown ay isangPagsulat ng kopyanakasulat na pormat.Dahil dito, sinasaklaw lang ng syntax ng pag-format ng Markdown kung ano ang kaya ng plain text.

Ang mga tag na hindi sakop ng Markdown ay maaaring isulat sa HTML nang direkta sa dokumentoPromosyon sa Webkopya.Hindi na kailangang markahan ito bilang HTML o Markdown; direktang idagdag ang markup.

Ilang HTML block element lang ang mapipilitan - gaya ng <div>,<table>,<pre>,<p> at iba pang mga tag, dapat na ihiwalay ang mga ito mula sa iba pang mga lugar ng nilalaman na may mga blangkong linya bago at pagkatapos, at hindi dapat naka-indent ang kanilang mga pambungad at pagsasara na tag ng mga tab o puwang. Ang Markdown generator ay sapat na matalino upang hindi magdagdag ng mga hindi kinakailangang HTML block tag <p> tatak

Ang halimbawa ay ang mga sumusunod, pagdaragdag ng isang HTML na talahanayan sa Markdown file:

这是一个普通段落。

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

这是另一个普通段落。

Tandaan na ang Markdown formatting syntax sa pagitan ng mga HTML block tag ay hindi mapoproseso.Halimbawa, kung gumagamit ka ng Markdown style sa loob ng HTML blocks*强调*ay walang epekto.

Mga tag ng HTML na seksyon (inline) gaya ng <span>,<cite>,<del> Maaaring magamit nang malaya sa Markdown na mga talata, listahan o heading.Ayon sa mga personal na gawi, maaari mo ring gamitin ang mga HTML na tag upang mag-format nang hindi gumagamit ng Markdown na format.Halimbawa: Kung mas gusto mo ang HTML <a> O <img> mga tag, na maaaring direktang gamitin nang walang link o image tag syntax na ibinigay ng Markdown.

Hindi tulad sa pagitan ng mga HTML block tag, ang Markdown syntax ay wasto sa pagitan ng mga HTML section tag.

Awtomatikong pag-convert ng mga espesyal na character

Sa mga HTML file, mayroong dalawang character na nangangailangan ng espesyal na paghawak: < At & . < ang mga simbolo ay ginagamit para sa mga panimulang tag,& Ginagamit ang mga simbolo upang markahan ang mga entity ng HTML, kung gusto mo lang ipakita ang prototype ng mga character na ito, kailangan mong gamitin ang form ng entity, tulad ng < At &.

& Ang mga karakter ay lalong nagpapahirap para sa mga manunulat ng dokumento sa web, kung magta-type ka ng "AT&T", kailangan mong magsulat"AT&T".habang nasa URL & Ang mga character ay na-convert din.Halimbawa gusto mong i-link sa:

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

Kailangan mong isulat ang conversion ng URL bilang:

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

na ilagay sa link tag href sa mga ari-arian.Hindi na kailangang sabihin, ito ay madaling balewalain, at marahil ang pinakamalaking bilang ng mga error na nakita ng HTML standards validation.

Binibigyang-daan ka ng Markdown na magsulat ng mga character nang natural, at pinangangasiwaan nito kung ano ang kailangang i-convert.kung gagamit ka & Ang isang character ay bahagi ng isang entity ng HTML na character, ito ay iniiwan kung ano, kung hindi, ito ay mako-convert sa &;.

Kaya kung gusto mong magsingit ng simbolo ng copyright sa dokumento ©, maaari kang sumulat:

©

Iiwan ito ng Markdown na hindi nagalaw.At kung sumulat ka:

AT&T

Iko-convert ito ng Markdown sa:

AT&T

Ang isang katulad na sitwasyon ay nangyayari din sa < notation, dahil pinapayagan ng Markdown ang HTML compatibility, kung ilalagay mo < Ginagamit ang mga simbolo bilang mga delimiter para sa mga HTML na tag, at ang Markdown ay hindi gagawa ng anumang mga conversion sa kanila, ngunit kung isusulat mo:

4 < 5

Iko-convert ito ng Markdown sa:

4 < 5

Gayunpaman, dapat tandaan na sa loob ng saklaw ng code, ito man ay inline o block, < At & parehong simboloSiguradoay na-convert sa HTML entity, isang feature na nagbibigay-daan sa iyong madaling magsulat ng HTML code sa Markdown (kumpara sa HTML, kung saan mo inilalagay ang lahat ng < At & Ang lahat ay na-convert sa HTML entity, upang magsulat ng HTML code sa HTML file. )

elemento ng bloke

Mga talata at line break

Ang Markdown na talata ay binubuo ng isa o higit pang magkakasunod na linya ng teksto, na sinusundan at sinusundan ng higit sa isang blangkong linya (ang kahulugan ng blangkong linya ay tila walang laman sa display at itinuturing na blangko na linya. Halimbawa, , kung ang isang linya ay naglalaman lamang ng mga puwang at tab, ang linya ay ituturing din bilang isang blangkong linya).Ang mga normal na talata ay hindi dapat naka-indent ng mga puwang o tab.

Ang pariralang "binubuo ng isa o higit pang magkakasunod na linya ng teksto" ay talagang nagpapahiwatig na ang Markdown ay nagbibigay-daan sa mga sapilitang bagong linya (paglalagay ng mga bagong linya) sa loob ng mga talata, isang tampok na naiiba sa karamihan ng iba pang mga text-to-HTML na format (kabilang ang Movable Type "Convert Line Breaks " opsyon), iko-convert ng ibang mga format ang bawat line break sa <br /> tatak

kung ikawtalagaGustong umasa sa Markdown para maisingit <br /> Para sa mga label, pindutin ang dalawa o higit pang mga puwang sa lugar ng pagpapasok at pagkatapos ay pindutin ang Enter.

Sa katunayan, kailangan ng kaunti pang trabaho (mga karagdagang espasyo) para makabuo <br /> , ngunit simpleng "bawat bagong linya ay na-convert sa <br />"Ang pamamaraan ay hindi angkop sa Markdown, em sa MarkdownaiHindi lang mas kapaki-pakinabang ang mga L-style blockquotes at mga listahan ng multi-paragraph ngunit mas madaling basahin kapag nagtatakda ng mga linya gamit ang mga line break.

Pamagat

Sinusuportahan ng Markdown ang dalawang syntax para sa mga heading, tulad ng Setext at tulad ng atx.

Ang Settext-like form ay ang form na may ilalim na linya, gamit = (pinakamataas na pamagat) at - (Second order heading), halimbawa:

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

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

anumang halaga = At - maaaring maging epektibo.

Ang form na tulad ng Atx ay naglalagay ng 1 hanggang 6 sa simula ng linya # , na tumutugma sa mga heading 1 hanggang 6, halimbawa:

# 这是 H1

## 这是 H2

###### 这是 H6

Maaari mong opsyonal na "isara" ang mga heading na tulad ng atx, ito ay para lamang sa aesthetics, kung komportable ka sa ganitong paraan, maaari mo itong idagdag sa dulo ng linya #, habang nagtatapos ang linya # Ang numero ay hindi kailangang pareho sa simula (ang bilang ng mga pound na character sa simula ng linya ay tumutukoy sa pagkakasunud-sunod ng pamagat):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Ang markdown markup blockquotes ay ginagamit katulad ng mga ginamit sa email > ng mga pagsipi.Kung pamilyar ka sa mga quote sa mga sulat sa email, alam mo kung paano gumawa ng block quote sa isang Markdown file, na magmumukhang ikaw mismo ang pumutol sa mga linya, pagkatapos ay idagdag > :

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

Binibigyang-daan ka rin ng Markdown na maging tamad at magdagdag lamang ng unang linya ng buong talata > :

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

Maaaring i-nested ang mga block reference (hal: mga reference sa loob ng mga reference) sa pamamagitan ng pagdaragdag ng ibang bilang ng > :

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

Ang iba pang mga Markdown syntax ay maaari ding gamitin sa loob ng mga naka-quote na bloke, kabilang ang mga heading, listahan, mga bloke ng code, atbp.:

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

Ang anumang disenteng text editor ay madaling makagawa ng email-style citation.Halimbawa sa BBEdit maaari kang pumili ng teksto at pagkatapos ay pumili mula sa menutaasan ang hierarchy ng pagsipi.

列表

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

Gumagamit ang mga hindi nakaayos na listahan ng mga asterisk, plus sign, o minus sign bilang mga marker ng listahan:

*   Red
*   Green
*   Blue

Katumbas ng:

+   Red
+   Green
+   Blue

Katumbas din ng:

-   Red
-   Green
-   Blue

Ang mga nakaayos na listahan ay gumagamit ng mga numero na sinusundan ng isang tuldok:

1.  Bird
2.  McHale
3.  Parish

Mahalagang tandaan na ang mga numerong ginagamit mo sa list tag ay hindi nakakaapekto sa output HTML. Ang magreresultang HTML markup para sa listahan sa itaas ay:

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

Kung ang iyong listahan ng markup ay nakasulat bilang:

1.  Bird
1.  McHale
1.  Parish

o kahit na:

3. Bird
1. McHale
8. Parish

Pareho kayong makakakuha ng eksaktong parehong HTML na output.Ang punto ay, maaari mong gawin ang mga numero ng listahan sa Markdown file na kapareho ng mga resulta ng output, o kung tamad ka, hindi mo na kailangang pakialaman ang kawastuhan ng mga numero.

Kung gumagamit ka ng tamad na pagsusulat, inirerekumenda na magsimula sa 1. para sa unang item, dahil maaaring suportahan ng Markdown ang start attribute ng mga ordered list sa hinaharap.

Karaniwang inilalagay ang tag ng listahan ng item sa kaliwa, ngunit maaari itong naka-indent, hanggang 3 puwang, at dapat na sundan ang tag ng item ng kahit isang puwang o tab.

Upang gawing mas maganda ang listahan, maaari mong ayusin ang mga nilalaman gamit ang isang nakapirming indent:

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

Pero kung tamad ka, ayos lang din:

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

Kung ang mga item sa listahan ay pinaghihiwalay ng mga blangkong linya, gagamitin ng Markdown ang nilalaman ng mga item kapag nag-output ng HTML. <p> Ang mga label ay nakabalot, halimbawa:

*   Bird
*   Magic

Iko-convert sa:

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

Pero ito:

*   Bird

*   Magic

Iko-convert sa:

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

Ang mga item sa listahan ay maaaring maglaman ng maraming talata, at ang mga talata sa ilalim ng bawat item ay dapat na naka-indent ng 4 na puwang o 1 tab:

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.

Mukhang mas maganda kung i-indent mo ang bawat linya, siyempre, muli, kung tamad ka, pinapayagan din ng Markdown ang:

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

Kung gusto mong maglagay ng reference sa loob ng isang item sa listahan, kung gayon > Kailangan itong naka-indent:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Kung gusto mong maglagay ng block ng code, kailangang naka-indent ang blockdalawang beses, na 8 puwang o 2 tab:

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

        <代码写在这>

Siyempre, ang isang listahan ng mga item ay maaaring mabuo nang hindi sinasadya, tulad nito:

1986. What a great season.

Sa madaling salita, lumilitaw ito sa simula ng linyanumero-panahon-blangko, para maiwasan ito, maaari kang magdagdag ng backslash bago ang tuldok.

1986\. What a great season.

区块

Ang pagsusulat na nauugnay sa program o ang source code ng wika ng tag ay kadalasang may mga bloke ng code na na-typeset na. Karaniwan, hindi namin gustong ma-typeset ang mga bloke na ito sa paraan ng pangkalahatang mga file ng talata, ngunit ipakita ang mga ito kung ano ang mga ito. Gagamitin ang markdown <pre> At <code> mga tag upang i-wrap ang mga bloke ng code.

Ang pagbuo ng mga bloke ng code sa Markdown ay kasing simple ng pag-indent ng 4 na puwang o 1 tab, halimbawa, ilagay ang sumusunod:

这是一个普通段落：

    这是一个代码区块。

Magko-convert ang markdown sa:

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

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

Ang first-order indentation na ito sa bawat linya (4 na puwang o 1 tab) ay inalis, halimbawa:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

Iko-convert sa:

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

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

Ang isang bloke ng code ay nagpapatuloy hanggang sa hindi naka-indent na linya (o sa dulo ng file).

Sa loob ng bloke ng code, & , < At > Awtomatiko itong mako-convert sa HTML entity, na ginagawang napakadali para sa iyo na gumamit ng Markdown upang ipasok ang HTML source code para sa halimbawa, kopyahin at i-paste lang ito, magdagdag ng indentation, at ang natitirang Markdown ay hahawak nito para sa iyo, Halimbawa:

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

Iko-convert sa:

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

Sa block ng code, hindi mako-convert ang pangkalahatang Markdown syntax, tulad ng mga asterisk ay asterisk lang, na nangangahulugang madali mong maisulat ang Markdown syntax na mga file sa Markdown syntax.

Hatiin

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

* * *

***

*****

- - -

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

elemento ng seksyon

Link

Sinusuportahan ng Markdown ang dalawang anyo ng link syntax: Nasa linyaAtsangguniandalawang anyo.

Sa alinmang paraan, ang teksto ng link ay minarkahan ng [mga parisukat na bracket].

upang lumikha ng aNasa linyaKung gusto mong idagdag ang teksto ng pamagat ng link, balutin lang ang teksto ng pamagat na may dobleng panipi pagkatapos ng URL, halimbawa:

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

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

Magbubunga ng:

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

Kung nagli-link ka sa mga mapagkukunan sa parehong host, maaari kang gumamit ng mga kaugnay na landas:

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

sanggunianAng link ay sinusundan ng isa pang square bracket pagkatapos ng bracket ng link text, at ang markang ginamit upang tukuyin ang link ay dapat punan sa pangalawang square bracket:

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

Maaari ka ring opsyonal na maglagay ng puwang sa pagitan ng dalawang square bracket:

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

Pagkatapos, saanman sa file, maaari mong tukuyin ang nilalaman ng link ng tag na ito:

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

Ang nilalaman ng link ay tinukoy sa form:

• Mga square bracket (opsyonal na unahan ng hanggang tatlong puwang para sa indentation) kung saan ipinasok ang text ng link
• sinundan ng colon
• sinusundan ng isa o higit pang mga puwang o tab
• ang URL ng susunod na link
• Opsyonal na sundin ang nilalaman ng pamagat, na maaaring isama sa mga solong panipi, dobleng panipi, o panaklong

Ang mga kahulugan ng sumusunod na tatlong link ay pareho:

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

mag-ingat:May isang kilalang isyu kung saan binabalewala ng Markdown.pl 1.0.1 ang mga pamagat ng link na nakapaloob sa mga solong panipi.

Ang mga URL ng link ay maaari ding ilakip sa mga anggulong bracket:

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

Maaari mo ring ilagay ang katangian ng pamagat sa susunod na linya, o magdagdag ng ilang indentation, na magiging mas maganda kung masyadong mahaba ang URL:

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

Ang kahulugan ng URL ay ginagamit lamang kapag bumubuo ng link, at hindi direktang lumilitaw sa file.

Ang mga tag ng pagkakakilanlan ng link ay maaaring maglaman ng mga titik, numero, whitespace, at bantas, ngunit hindiHindiIto ay case sensitive, kaya ang sumusunod na dalawang link ay pareho:

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

Implicit na tag ng linkNagbibigay-daan sa iyo ang feature na alisin ang pagtukoy ng tag ng link. Sa kasong ito, ituturing na katumbas ang link tag sa text ng link. Upang gumamit ng implicit na tag ng link, magdagdag lamang ng walang laman na square bracket pagkatapos ng text ng link. Kung gusto mo ng "Google " Pagli-link sa google.com, maaari mong gawing simple ang:

[Google][]

Pagkatapos ay tukuyin ang nilalaman ng link:

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

Dahil ang teksto ng link ay maaaring naglalaman ng whitespace, ang pinasimpleng markup na ito ay maaaring maglaman ng maraming salita:

Visit [Daring Fireball][] for more information.

Pagkatapos ay magpatuloy upang tukuyin ang link:

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

Ang kahulugan ng link ay maaaring ilagay kahit saan sa file. Mas gusto kong ilagay ito nang direkta pagkatapos ng talata kung saan lumalabas ang link. Maaari mo ring ilagay ito sa dulo ng file, tulad ng isang komento.

Narito ang isang halimbawa ng isang reference na link:

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"

Kung babaguhin mo ito para gamitin ang pangalan ng link para magsulat:

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"

Ang dalawang paraan ng pagsulat sa itaas ay gagawa ng sumusunod na 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>

Nasa ibaba ang isang Markdown file ng parehong nilalaman na nakasulat sa linya, na ibinigay para sa paghahambing:

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

Sa katunayan, ang punto ng mga link sa istilo ng sanggunian ay hindi dahil mas madaling magsulat, ngunit mas madaling basahin. Ihambing ang halimbawa sa itaas. Ang artikulo sa istilo ng sanggunian mismo ay 81 character lamang, ngunit ang inline na form ay tataas sa 176 na mga character. , kung ito ay nakasulat sa purong HTML na format, magkakaroon ng 234 na mga character. Sa HTML na format, mayroong mas maraming mga tag kaysa sa teksto.

Ang paggamit ng mga reference-style na link ng Markdown ay maaaring gawing mas katulad ng huling resulta ng browser ang dokumento, na nagbibigay-daan sa iyong ilipat ang ilang metadata na nauugnay sa markup sa labas ng teksto ng talata, at maaari kang magdagdag ng mga link nang hindi binabasa ang artikulo.

强调

Gumagamit ang markdown ng mga asterisk (*) at ang ilalim na linya (_) bilang simbolo upang markahan ang salitang may salungguhit, ay * O _ Ang mga nakapaligid na salita ay na-convert sa <em> napapaligiran ng mga label, na may dalawa * O _Kung ito ay nakabalot, ito ay mako-convert sa <strong>, Hal:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

magiging:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Maaari mong gamitin ang anumang estilo na gusto mo, ang tanging limitasyon ay maaari mong gamitin ang simbolo upang buksan ang tag at ang simbolo upang tapusin ito.

Maaari ding direktang ipasok ang diin sa gitna ng teksto:

un*frigging*believable

ngunitkung ang iyong * At _ Kung may mga whitespace sa magkabilang panig, ituturing lang silang mga normal na simbolo.

Upang direktang maglagay ng mga normal na asterisk o underscore bago at pagkatapos ng text, maaari kang gumamit ng mga backslashes:

\*this text is surrounded by literal asterisks\*

Code

Kung gusto mong markahan ang isang maliit na piraso ng inline na code, maaari mo itong balutin ng mga backticks (`), Hal:

Use the `printf()` function.

Magbubunga ng:

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

Kung gusto mong magpasok ng mga backtick sa loob ng isang seksyon ng code, maaari mong simulan at tapusin ang seksyon ng code na may maraming mga backtick:

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

Ang syntax na ito ay gumagawa ng:

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

Maaari kang maglagay ng blangko sa simula at dulo ng isang seksyon ng code, isa pagkatapos ng simula at isa bago ang katapusan, upang maaari kang magpasok ng mga backticks sa simula ng seksyon:

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

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

Magbubunga ng:

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

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

Sa loob ng seksyon ng code,& at angle bracket都ay awtomatikong mako-convert sa HTML entity, na nagpapadali sa pagpasok ng HTML source code, ilalagay ng Markdown ang sumusunod na talata:

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

sa:

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

Maaari mo ring isulat ito:

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

Upang makagawa ng:

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

图片

Malinaw, mahirap magdisenyo ng "natural" na syntax para sa pagpasok ng mga larawan sa isang text-only na application.

Gumagamit ang Markdown ng syntax na katulad ng sa mga link upang markahan ang mga larawan, at pinapayagan din ang dalawang istilo: Nasa linyaAtsanggunian.

Ang inline na syntax ng imahe ay mukhang:

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

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

Ang mga detalye ay ang mga sumusunod:

• isang tandang padamdam !
• 接着 一个 方 括号 ， 里面 放上 图片 的 替代 文字
• Pagkatapos ay isang normal na bracket, ilagay ang URL ng larawan sa loob, at sa wakas ay balutin ito ng mga quote at magdagdag ng isang opsyonal na 'title' na teksto.

Ganito ang hitsura ng syntax ng reference na imahe:

![Alt text][id]

Ang "id" ay ang pangalan ng reference ng imahe, na tinukoy sa parehong paraan tulad ng isang link reference:

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

Sa ngayon, ang Markdown ay walang paraan upang tukuyin ang lapad at taas ng imahe, kung kailangan mo, maaari mong gamitin ang normal <img> tatak

其它

auto link

Sinusuportahan ng Markdown ang pagpoproseso ng mga URL at email mailbox sa anyo ng medyo maiikling mga awtomatikong link. Hangga't nakalagay ang mga ito sa mga angle bracket, awtomatikong iko-convert ito ng Markdown sa isang link.Ang teksto ng link ng isang pangkalahatang URL ay kapareho ng address ng link, halimbawa:

<http://example.com/>

Iko-convert ang markdown sa:

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

Ang awtomatikong pag-link ng mga email address ay halos magkatulad din, maliban na ang Markdown ay magsasagawa muna ng proseso ng pag-encode ng conversion, na magko-convert ng mga text character sa hexadecimal HTML entity. Maaaring lokohin ng format na ito ang ilang masamang robot ng pangongolekta ng email address, gaya ng:

<[email protected]>

Ang markdown ay magiging:

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

Sa browser, ang string na ito (sa totoo lang <a href="mailto:[email protected]">[email protected]</a>) ay nagiging isang naki-click na "[email protected]" na link.

(Bagaman ang diskarte na ito ay maaaring lokohin ang maraming mga robot, hindi nito mapipigilan silang lahat, ngunit ito ay mas mahusay kaysa sa wala. Sa anumang kaso, ang pagbubukas ng iyong mailbox sa kalaunan ay makakaakit ng mga titik sa advertising.)

backslash

Maaaring gumamit ang markdown ng mga backslashes para magpasok ng mga simbolo na may iba pang kahulugan sa grammar, halimbawa: kung gusto mong magdagdag ng asterisk sa tabi ng text para sa pagbibigay-diin (ngunit hindi <em> tag), maaari mong unahan ang asterisk na may backslash:

\*literal asterisks\*

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

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

Markdown libreng editor

Windows platform

• MarkdownPad
• MarkPad

Platform ng Mac

• malambot

online na editor

• MPEditor

plugin ng browser

• Markdown dito plugin

*** Kung may mas mahusay na libreng Markdown editor na irerekomenda, mangyaring bigyang pansin ang feedbackChen Weiliang,salamat!