Unsa ang gipasabut sa Markdown? Giunsa paggamit ang Markdown syntax/formatting markup?

MarkdownUnsay pasabot?

Giunsa paggamit ang Markdown syntax/formatting markup?

Paghinuktok

Ang Markdown usa ka lightweight nga markup nga pinulongan nga gihimo ni John Gruber.

Gitugotan niini ang mga tawo nga "magsulat sa mga dokumento sa usa ka yano nga format sa teksto nga dali basahon ug isulat, ug dayon i-convert kini nga balido nga XHTML (o HTML) nga mga dokumento".

Ang pinulongan naglakip sa daghang mga bahin sa plain text markup nga nakaplagan na sa e-mail.

Gihimo ni John Gruber ang Markdown nga pinulongan sa 2004, sa kolaborasyon ni Aaron Swartz sa dakong bahin sa syntax.Ang katuyoan sa lengguwahe mao ang paggamit sa "usa ka yano nga pormat sa teksto nga dali basahon, dali isulat, ug mahimo’g mabag-o sa balido nga XHTML (o HTML)".

katuyoan

Ang katuyoan sa Markdown mao ang "sayon ​​basahon ug dali isulat".

pagkabasa, buhata gihaponMarketing sa Internet, ang kasinatian sa tiggamit hinungdanon kaayo.

Ang usa ka file nga gisulat sa Markdown kinahanglan nga direkta nga mapatik sa yano nga teksto, ug dili kinahanglan nga makita nga adunay daghang mga tag o mga direktiba sa pag-format.

Ang markdown syntax naimpluwensyahan sa pipila nga naglungtad nga text-to-HTML nga mga format, lakip ang Setext, atx, Textile, reStructuredText, Grutatext, ug EtText, apan ang pinakadako nga tinubdan sa inspirasyon mao ang plain text email format.

Sa laktud, ang syntax sa Markdown tanan gilangkuban sa mga simbolo, nga gipili pag-ayo ug ang ilang mga gimbuhaton klaro sa usa ka pagtan-aw.Pananglitan: ibutang ang mga asterisk sa palibot sa teksto aron kini sama sa *emphasis*.

Ang mga lista sa Markdown morag, maayo, mga lista. Ang mga blockquotes sa Markdown morag nagkutlo sa usa ka piraso sa teksto, sama sa imong nakita sa mga email.

Nahiuyon sa HTML

Ang tumong sa Markdown grammar mao ang pagkahimong usa ka sinultian nga sinultian para sa web.

Ang Markdown wala gituyo nga ilisan ang HTML, o bisan pa nga duol niini, kini adunay gamay kaayo nga syntax ug katumbas lamang sa gamay nga subset sa HTML markup. Ang Markdown wala gimugna aron sa paghimo sa mga dokumento sa HTML nga mas sayon ​​​​sa pagsulat.

Sa akong opinyon, ang HTML sayon ​​na nga isulat. Ang ideya sa Markdown mao ang paghimo sa mga dokumento nga dali basahon, isulat, ug usbon kung gusto. Ang HTML usa ka format sa pagmantala, ang Markdown usa kaCopywritingsinulat nga pormat.Ingon niana, ang syntax sa pag-format sa Markdown naglangkob ra kung unsa ang mahimo sa yano nga teksto.

Ang mga tag nga dili sakop sa Markdown mahimong isulat sa HTML direkta sa dokumentoPromosyon sa Webkopya.Dili kinahanglan nga markahan kini nga HTML o Markdown; idugang lang ang markup direkta.

Pipila ra nga mga elemento sa block sa HTML ang pugngan - sama sa <div>,<table>,<pre>,<p> ug uban pang mga tag, kinahanglan nga ibulag sila gikan sa ubang mga lugar sa sulud nga adunay mga blangko nga linya sa wala pa ug pagkahuman, ug ang ilang pangbukas ug panapos nga mga tag kinahanglan dili mag-indent sa mga tab o espasyo. Ang Markdown generator igo nga maalamon nga dili makadugang sa dili kinahanglan nga HTML block tags <p> 标签.

Ang pananglitan mao ang mosunod, pagdugang ug HTML nga lamesa sa Markdown file:

这是一个普通段落。

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

这是另一个普通段落。

Timan-i nga ang Markdown formatting syntax tali sa HTML block tags dili maproseso.Pananglitan, kon mogamit ka ug Markdown style sulod sa HTML block*强调*walay epekto.

HTML nga seksyon (inline) nga mga tag sama sa <span>,<cite>,<del> Mahimong magamit nga gawasnon sa Markdown nga mga parapo, lista o ulohan.Sumala sa personal nga mga batasan, mahimo pa nimo gamiton ang mga tag sa HTML sa pag-format nga wala gigamit ang Markdown format.Pananglitan: Kung gusto nimo ang HTML <a> o <img> tag, nga mahimong gamiton direkta nga walay link o image tag syntax nga gihatag sa Markdown.

Dili sama sa taliwala sa HTML block tags, ang Markdown syntax balido tali sa HTML section tags.

Awtomatikong pagkakabig sa mga espesyal nga karakter

Sa HTML nga mga file, adunay duha ka karakter nga nanginahanglan espesyal nga pagdumala: < ug & . < ang mga simbolo gigamit para sa mga tag sa pagsugod,& Ang mga simbolo gigamit aron markahan ang mga entidad sa HTML, kung gusto nimo ipakita ang prototype niini nga mga karakter, kinahanglan nimo gamiton ang porma sa entidad, sama sa < ug &.

& Ang mga karakter labi nga nagsakit alang sa mga magsusulat sa dokumento sa web, kung imong i-type ang "AT&T", kinahanglan ka magsulat"AT&T".samtang sa URL & Ang mga karakter nakabig usab.Pananglitan gusto nimong i-link sa:

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

Kinahanglan nimong isulat ang pagkakabig sa URL ingon:

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

nga ibutang sa link tag href sa mga kabtangan.Dili kinahanglan nga isulti, kini dali nga ibalewala, ug tingali ang labing kadaghan nga mga sayup nga nakit-an sa pag-validate sa mga sumbanan sa HTML.

Gitugotan ka sa Markdown nga isulat ang mga karakter nga natural, ug giatiman niini kung unsa ang kinahanglan nga mabag-o.kung imong gamiton & Ang usa ka karakter maoy bahin sa usa ka HTML nga karakter nga entidad, kini ibilin ingon nga mao, kon dili kini nakabig ngadto sa &;.

Mao nga kung gusto nimo magsulud usa ka simbolo sa copyright sa dokumento ©, mahimo nimong isulat:

©

Ang Markdown ibilin kini nga dili matandog.Ug kung magsulat ka:

AT&T

Ang Markdown mag-convert niini ngadto sa:

AT&T

Ang susama nga sitwasyon mahitabo usab sa < notation, tungod kay ang Markdown nagtugot sa HTML compatibility, kon imong ibutang < Ang mga simbolo gigamit isip mga delimiter alang sa HTML nga mga tag, ug ang Markdown dili magbuhat ug bisan unsang mga pagkakabig niini, apan kon ikaw magsulat:

4 < 5

Ang Markdown mag-convert niini ngadto sa:

4 < 5

Bisan pa, kinahanglan nga matikdan nga sa sulud sa code, kung kini inline o block, < ug & pareho nga simbolopara siguradonakabig ngadto sa HTML entities, usa ka feature nga makapahimo nimo nga daling magsulat sa HTML code sa Markdown (sukwahi sa HTML, diin imong ibutang ang tanang < ug & Ang tanan nakabig ngadto sa HTML entidad, aron sa pagsulat sa HTML code sa HTML file. )

bloke nga elemento

Mga parapo ug mga linya sa linya

Ang Markdown paragraph gilangkoban sa usa o daghang sunodsunod nga linya sa teksto, giunhan ug gisundan sa labaw sa usa ka blangko nga linya (ang kahulugan sa blangko nga linya mao nga kini makita nga walay sulod sa display ug giisip nga blangko nga linya. Kay pananglitan, , kung ang usa ka linya adunay mga espasyo ug tab lamang, ang linya isipon usab nga blangko nga linya).Ang mga normal nga paragraph dili kinahanglan nga mag-indent sa mga espasyo o tab.

Ang hugpong sa mga pulong nga "naglangkob sa usa o labaw pa nga sunud-sunod nga mga linya sa teksto" sa tinuud nagpasabut nga gitugotan sa Markdown ang pinugos nga mga bag-ong linya (pagsulud sa mga bag-ong linya) sa sulod sa mga parapo, usa ka bahin nga lahi sa kadaghanan sa ubang mga format sa text-to-HTML (lakip ang Movable Type "Convert Line Breaks " kapilian), ang ubang mga format mag-convert sa matag linya sa break sa <br /> 标签.

Kung ikawsa tinuudGusto nga mosalig sa Markdown sa pagsal-ot <br /> Alang sa mga label, i-press ang duha o daghan pa nga mga espasyo sa lugar nga gisulud ug dayon pindota ang Enter.

Sa pagkatinuod, nagkinahanglan kini og gamay pa nga trabaho (dugang mga luna) aron makamugna <br /> , apan yano nga "matag bag-ong linya gikabig sa <br />"Ang pamaagi dili angay sa Markdown, em sa MarkdownaiAng L-style blockquotes ug multi-paragraph lists dili lang mas mapuslanon kondili mas sayon ​​sab basahon kung mag-typeset gamit ang line break.

Pamagat

Gisuportahan sa Markdown ang duha ka syntax alang sa mga ulohan, sama sa Setext ug sama sa atx.

Ang Settext-sama nga porma mao ang porma nga adunay ubos nga linya, gamit = (labing taas nga titulo) ug - (Mga ulohan sa ikaduhang han-ay), pananglitan:

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

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

bisan unsang kantidad = ug - mahimong epektibo.

Ang porma nga sama sa Atx nagsal-ot sa 1 hangtod 6 sa sinugdanan sa linya # , katumbas sa mga ulohan 1 hangtod 6, pananglitan:

# 这是 H1

## 这是 H2

###### 这是 H6

Mahimo nimong opsyonal nga "isira" ang mga ulohan nga sama sa atx, kini alang lamang sa mga aesthetics, kung gibati nimo nga komportable kini nga paagi, mahimo nimo kini idugang sa katapusan sa linya #, samtang ang linya matapos # Ang numero dili kinahanglan nga pareho sa sinugdanan (ang gidaghanon sa libra nga mga karakter sa sinugdanan sa linya nagtino sa han-ay sa titulo):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Ang markdown markup blockquotes gigamit nga susama sa gigamit sa email > sa mga citation.Kung pamilyar ka sa mga kinutlo sa mga sulat sa email, nahibal-an nimo kung giunsa paghimo ang usa ka block quote sa usa ka Markdown file, nga morag gibuak nimo ang mga linya sa imong kaugalingon, unya idugang > :

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

Gitugotan ka usab sa Markdown nga tapolan ug idugang lamang ang una nga linya sa tibuuk nga parapo > :

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

Ang mga reference sa block mahimong ibutang (pananglitan: mga reference sulod sa mga reference) pinaagi sa pagdugang og lain nga gidaghanon sa > :

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

Ang ubang mga Markdown syntaxes mahimo usab nga gamiton sulod sa gikutlo nga mga bloke, lakip ang mga ulohan, mga listahan, mga bloke sa code, ug uban pa:

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

Ang bisan unsang disente nga editor sa teksto dali nga makahimo og mga citation nga istilo sa email.Pananglitan sa BBEdit makapili ka og teksto ug dayon mopili gikan sa menudugangi ang hierarchy sa citation.

Paglista

Gisuportahan sa Markdown ang ordered ug unordered lists.

Ang dili han-ay nga mga lista naggamit og mga asterisk, plus nga mga timailhan, o mga minus nga mga timaan isip mga marka sa listahan:

*   Red
*   Green
*   Blue

Katumbas sa:

+   Red
+   Green
+   Blue

Katumbas usab sa:

-   Red
-   Green
-   Blue

Ang gi-order nga mga lista naggamit mga numero nga gisundan sa usa ka yugto:

1.  Bird
2.  McHale
3.  Parish

Importante nga timan-an nga ang mga numero nga imong gigamit sa list tag dili makaapekto sa output HTML. Ang resulta nga HTML markup para sa listahan sa ibabaw mao ang:

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

Kung ang imong marka sa lista gisulat ingon:

1.  Bird
1.  McHale
1.  Parish

o bisan:

3. Bird
1. McHale
8. Parish

Kamong duha makakuha og parehas nga HTML nga output.Ang punto mao, mahimo nimong buhaton ang mga numero sa lista sa Markdown file nga parehas sa mga resulta sa output, o kung tapolan ka, dili nimo kinahanglan nga magtagad sa katukma sa mga numero.

Kung mogamit ka nga tapulan nga pagsulat, girekomenda nga magsugod sa 1. alang sa una nga aytem, ​​tungod kay ang Markdown mahimong mosuporta sa pagsugod nga hiyas sa gimando nga mga lista sa umaabot.

Ang listahan sa butang nga tag kasagaran gibutang sa halayong wala, apan kini mahimong indented, ngadto sa 3 mga luna, ug ang butang tag kinahanglan nga gisundan sa labing menos usa ka luna o tab.

Aron mas nindot tan-awon ang listahan, mahimo nimong organisahon ang mga sulod gamit ang fixed 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.

Apan kung tapolan ka, maayo usab kana:

*   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 butang sa lista gibulag sa mga blangko nga linya, ang Markdown mogamit sa sulud sa aytem kung mag-output sa HTML. <p> Ang mga label giputos, pananglitan:

*   Bird
*   Magic

makabig ngadto sa:

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

Apan kini:

*   Bird

*   Magic

makabig ngadto sa:

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

Ang mga butang sa lista mahimong adunay daghang mga paragraph, ug ang mga parapo sa ilawom sa matag aytem kinahanglan nga i-indent sa 4 ka mga espasyo 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.

Mas maayo kini tan-awon kung imong i-indent ang matag linya, siyempre, pag-usab, kung tapolan ka, gitugotan usab sa Markdown:

*   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 nimong ibutang ang usa ka pakisayran sa sulod sa usa ka butang sa lista, nan > Kini kinahanglan nga i-indent:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Kung gusto nimo ibutang ang usa ka bloke sa code, kinahanglan nga i-indent ang blokemakaduha, nga 8 ka espasyo o 2 ka tab:

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

        <代码写在这>

Siyempre, ang usa ka lista sa mga butang mahimo nga wala tuyoa, sama niini:

1986. What a great season.

Sa laing pagkasulti, kini makita sa sinugdanan sa linyanumero-panahon-blangko, aron malikayan kini, mahimo nimong idugang ang usa ka backslash sa wala pa ang panahon.

1986\. What a great season.

block sa code

Program-related nga pagsulat o tag language source code kasagaran adunay mga bloke sa code nga na-typeset na. Kasagaran, dili namo gusto nga kini nga mga block ma-typeset sa paagi sa kinatibuk-ang mga file sa paragraph, apan ipakita kini kung unsa sila. Ang Markdown mogamit <pre> ug <code> mga tag aron maputos ang mga bloke sa code.

Ang mga bloke sa pagtukod sa code sa Markdown yano ra sama sa pag-indent sa 4 nga mga wanang o 1 tab, pananglitan, isulod ang mosunod:

这是一个普通段落：

    这是一个代码区块。

Ang Markdown ma-convert sa:

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

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

Kining first-order indentation kada linya (4 spaces o 1 tab) gikuha, pananglitan:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

makabig ngadto sa:

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

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

Ang usa ka bloke sa kodigo nagpadayon hangtod sa wala ma-indent nga linya (o sa katapusan sa file).

Sa sulod sa code block, & , < ug > Awtomatiko kini nga mabag-o sa mga entidad sa HTML, nga nagpasayon ​​kanimo sa paggamit sa Markdown aron ipasok ang HTML source code alang sa pananglitan, kopyaha ug idikit lang kini, idugang ang indentation, ug ang nahabilin nga Markdown magdumala niini alang kanimo, pananglitan:

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

makabig ngadto sa:

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

Sa code block, ang kinatibuk-ang Markdown syntax dili makombertir, sama sa mga asterisk kay mga asterisk lang, nga nagpasabot nga dali nimong isulat ang Markdown syntax related files sa Markdown syntax.

tigbahin

Mahimo nimong gamiton ang labaw sa tulo ka mga asterisk, minus nga mga timailhan, mga underscore aron makahimo usa ka divider sa usa ka linya, wala’y lain sa linya.Mahimo usab nimo nga i-insert ang mga espasyo taliwala sa mga asterisk o minus nga mga timailhan.Ang mga linya sa panagbulag mahimong mabuhat sa matag usa sa mosunod nga mga paagi sa pagsulat:

* * *

***

*****

- - -

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

elemento sa seksyon

sumpay

Ang Markdown nagsuporta sa duha ka porma sa link syntax: InlineugReperensyaduha ka porma.

Sa bisan asa nga paagi, ang link nga teksto gimarkahan og [square bracket].

sa paghimo aInlineKung gusto nimong idugang ang titulo nga teksto sa link, ibutang lang ang titulo nga teksto nga adunay doble nga marka sa kinutlo pagkahuman sa URL, pananglitan:

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

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

Maghimo og:

<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 nag-link ka sa mga kapanguhaan sa parehas nga host, mahimo nimong gamiton ang mga relatibong agianan:

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

ReperensyaAng link gisundan sa laing square bracket human sa parentesis sa link text, ug ang marka nga gigamit sa pag-ila sa link kinahanglang mapuno sa ikaduhang square bracket:

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

Mahimo usab nimo nga opsyonal nga ibutang ang usa ka luna tali sa duha ka square bracket:

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

Unya, bisan asa sa file, mahimo nimong ipasabut ang sulud sa link sa kini nga tag:

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

Ang sulud sa link gihubit sa porma:

• Mga square bracket (opsyonal nga giunhan ug hangtod sa tulo ka mga espasyo para sa indentation) diin gisulod ang link nga teksto
• gisundan sa usa ka colon
• gisundan sa usa o daghang mga espasyo o tab
• ang URL sa sunod nga link
• Opsyonal nga sundon ang sulud sa titulo, nga mahimong ilakip sa usa ka kinutlo, doble nga mga kinutlo, o parentesis

Ang mga kahulugan sa mosunod nga tulo ka mga link managsama:

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

pag-amping:Adunay usa ka nahibal-an nga isyu diin ang Markdown.pl 1.0.1 wala magtagad sa mga titulo sa link nga gilakip sa usa ka kinutlo.

Ang mga URL sa link mahimo usab nga ilakip sa mga anggulo nga bracket:

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

Mahimo usab nimo ibutang ang title attribute sa sunod nga linya, o idugang ang pipila ka indentation, nga mas nindot tan-awon kung ang URL taas kaayo:

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

Ang mga depinisyon sa URL gigamit lang kung maghimo og mga link, ug dili direkta nga makita sa file.

Ang mga tag sa pag-ila sa link mahimong adunay mga letra, numero, whitespace, ug punctuation, apan diliDiliKini sensitibo sa kaso, mao nga ang mosunod nga duha ka mga link managsama:

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

Implicit nga link tagAng feature nagtugot kanimo sa paglaktaw sa pagpiho sa usa ka link tag. Sa kini nga kaso, ang link tag isipon nga katumbas sa link text. Aron sa paggamit sa usa ka implicit link tag, pagdugang lang ug walay sulod nga square bracket human sa link text. Kung gusto nimo "Google " Pag-link sa google.com, mahimo nimong pasimplehon ang:

[Google][]

Dayon ipasabut ang sulod sa link:

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

Tungod kay ang link nga teksto mahimong adunay whitespace, kining gipasimple nga markup mahimong adunay daghang mga pulong:

Visit [Daring Fireball][] for more information.

Dayon ipadayon ang paghubit sa link:

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

Ang kahulugan sa link mahimong ibutang bisan asa sa file. Mas gusto nako nga ibutang kini direkta pagkahuman sa paragraph diin makita ang link. Mahimo usab nimo ibutang kini sa katapusan sa file, sama sa usa ka komento.

Ania ang usa ka pananglitan sa usa ka reference 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 imong usbon kini aron gamiton ang ngalan sa link sa pagsulat:

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 labaw sa duha ka mga paagi sa pagsulat makahimo sa mosunod nga 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>

Sa ubos usa ka Markdown file sa parehas nga sulud nga gisulat sa linya, gihatag alang sa pagtandi:

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 pagkatinuod, ang punto sa reference-style nga mga link dili kay kini sayon ​​​​isulat, apan kini mas sayon ​​​​basahon. Itandi ang ibabaw nga pananglitan. Ang reference-style nga artikulo sa iyang kaugalingon mao lamang ang 81 ka mga karakter, apan ang inline nga porma mosaka ngadto sa 176 ka mga karakter. , kung kini gisulat sa purong HTML nga format, adunay 234 ka mga karakter. Sa HTML format, adunay mas daghan nga mga tag kay sa teksto.

Ang paggamit sa Markdown's reference-style links makahimo sa dokumento nga mas sama sa kataposang resulta sa browser, nga magtugot kanimo sa paglihok sa pipila ka markup-related nga metadata sa gawas sa paragraph text, ug ikaw makadugang ug mga link nga dili mobasa sa artikulo.

hatagan gibug-aton

Ang Markdown naggamit og mga asterisk (*) ug ang ubos nga linya (_) isip usa ka simbolo sa pagmarka sa usa ka badlis nga pulong, mao * o _ Ang gilibutan nga mga pulong nakabig ngadto sa <em> gilibutan sa mga label, nga adunay duha * o _Kon kini giputos, kini makabig ngadto sa <strong>,E.g:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

mahimong:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Mahimo nimong gamiton ang bisan unsang istilo nga gusto nimo, ang bugtong limitasyon mao nga mahimo nimong ablihan ang tag kung unsang simbolo ang gusto nimo tapuson.

Ang emphasis mahimo usab nga isulod direkta sa tunga sa teksto:

un*frigging*believable

apankung ang imong * ug _ Kung adunay mga whitespace sa duha ka kilid, kini giisip nga normal nga mga simbolo.

Aron isulod ang mga normal nga asterisk o underscore direkta sa wala pa ug pagkahuman sa teksto, mahimo nimong gamiton ang mga backslashes:

\*this text is surrounded by literal asterisks\*

Code

Kung gusto nimong markahan ang usa ka gamay nga piraso sa inline nga code, mahimo nimo kini ibutang sa mga backticks (`), pananglitan:

Use the `printf()` function.

Maghimo og:

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

Kung gusto nimong isulod ang mga backticks sa sulod sa seksyon sa code, mahimo nimong sugdan ug tapuson ang seksyon sa code nga adunay daghang mga backticks:

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

Kini nga syntax naghimo:

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

Mahimo nimong ibutang ang usa ka whitespace sa sinugdanan ug katapusan sa usa ka seksyon sa code, usa pagkahuman sa sinugdanan ug usa sa wala pa matapos, aron mahimo nimong isulud ang mga backticks sa sinugdanan sa seksyon:

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

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

Maghimo og:

<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 sulod sa seksyon sa code,& ug anggulo bracket都awtomatik nga makombertir sa mga entidad sa HTML, nga makapasayon ​​sa pagsal-ot sa HTML source code, ibutang sa Markdown ang mosunod nga parapo:

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

sa:

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

Mahimo usab nimong isulat kini:

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

Aron makahimo:

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

图片

Dayag nga lisud ang pagdesinyo sa usa ka "natural" nga syntax alang sa pagsal-ot sa mga imahe sa usa ka aplikasyon nga teksto lamang.

Ang Markdown naggamit ug syntax nga susama sa mga link aron markahan ang mga hulagway, ug gitugotan usab ang duha ka estilo: InlineugReperensya.

Ang inline nga syntax sa imahe sama sa:

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

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

Ang mga detalye mao ang mosunod:

• usa ka exclamation mark !
• gisundan sa usa ka square bracket nga adunay alt text para sa imahe
• Gisundan kini sa mga normal nga parentesis nga adunay URL sa imahe, ug sa katapusan usa ka opsyonal nga 'titulo' nga teksto nga gilakip sa mga kinutlo.

Ang reference image syntax ingon niini:

![Alt text][id]

Ang "id" mao ang ngalan sa reperensya sa imahe, nga gihubit sa parehas nga paagi sa usa ka link nga pakisayran:

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

Hangtod karon, ang Markdown wala’y paagi aron mahibal-an ang gilapdon ug gitas-on sa imahe, kung kinahanglan nimo, mahimo nimong gamiton ang normal <img> 标签.

其它

auto link

Gisuportahan sa Markdown ang pagproseso sa mga URL ug mga mailbox sa email sa porma sa medyo mugbo nga awtomatik nga mga link. Hangtud nga kini gilakip sa mga anggulo nga bracket, ang Markdown awtomatiko nga magbag-o niini nga usa ka link.Ang link nga teksto sa kinatibuk-ang URL parehas sa link address, pananglitan:

<http://example.com/>

Ang markdown makombertir sa:

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

Ang awtomatik nga pag-link sa mga adres sa email susama usab kaayo, gawas nga ang Markdown una nga maghimo usa ka proseso sa pagbag-o sa pag-encode, pag-convert sa mga karakter sa teksto ngadto sa hexadecimal nga HTML nga mga entidad. Kini nga format mahimong makalimbong sa pipila ka dili maayo nga mga robot sa pagkolekta sa email address, sama sa:

<[email protected]>

Ang Markdown mahimong:

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

Sa browser, kini nga string (sa tinuud <a href="mailto:[email protected]">[email protected]</a>) mahimong ma-click nga "[email protected]" nga link.

(Bisan tuod nga kini nga pamaagi makalimbong sa daghang mga robot, dili kini makapugong sa tanan, apan kini mas maayo kay sa wala. Sa bisan unsa nga kaso, ang pag-abli sa imong mailbox sa katapusan makadani sa mga sulat sa advertising.)

backslash

Ang Markdown mahimong mogamit og mga backslashes sa pagsal-ot sa mga simbolo nga adunay lain nga kahulugan sa gramatika, pananglitan: kung gusto nimo magdugang ug asterisk sunod sa teksto para sa paghatag gibug-aton (apan dili <em> tag), mahimo nimong unahan ang asterisk nga adunay backslash:

\*literal asterisks\*

Gisuportahan sa Markdown ang mosunod nga mga simbolo nga giunhan sa backslash aron makatabang sa pagsal-ot sa komon nga mga simbolo:

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

Markdown nga libre nga editor

Windows plataporma

• MarkdownPad
• MarkPad

plataporma sa Mac

• Mou

online nga editor

• MPEditor

plugin sa browser

• Markdown dinhi nga plugin

*** Kung adunay mas maayo nga libre nga Markdown editor nga irekomenda, palihug pagtagad sa feedbackChen Weiliang,salamat!