Beth mae Markdown yn ei olygu Sut i ddefnyddio Markdown cystrawen/marcio fformatio?

MarkdownBeth yw ystyr?

Sut i ddefnyddio Markdown cystrawen/marcio fformat?

Trosolwg

Mae Markdown yn iaith farcio ysgafn a grëwyd gan John Gruber.

Mae'n caniatáu i bobl "ysgrifennu dogfennau mewn fformat testun plaen sy'n hawdd eu darllen a'u hysgrifennu, ac yna eu trosi'n ddogfennau XHTML (neu HTML) dilys".

Mae'r iaith yn ymgorffori llawer o nodweddion marcio testun plaen a ddarganfuwyd eisoes mewn e-bost.

Creodd John Gruber yr iaith Markdown yn 2004, mewn cydweithrediad ag Aaron Swartz i raddau helaeth ar y gystrawen.Pwrpas yr iaith yw defnyddio "fformat testun plaen sy'n hawdd ei ddarllen, yn hawdd ei ysgrifennu, ac sy'n trosi'n ddewisol i XHTML (neu HTML) dilys".

pwrpas

Nod Markdown yw bod yn “hawdd ei ddarllen ac yn hawdd ei ysgrifennu”.

darllenadwyedd, gwnewch hynny beth bynnagMarchnata rhyngrwyd, mae profiad y defnyddiwr yn bwysig iawn.

Dylai ffeil a ysgrifennwyd yn Markdown allu cael ei chyhoeddi'n uniongyrchol mewn testun plaen, ac ni ddylai ymddangos ei bod yn cynnwys llawer o dagiau neu gyfarwyddebau fformatio.

Mae rhai fformatau testun-i-HTML sy'n bodoli eisoes yn dylanwadu ar gystrawen Markdown, gan gynnwys Setext, atx, Textile, reStructuredText, Grutatext, ac EtText, ond y ffynhonnell fwyaf o ysbrydoliaeth yw'r fformat e-bost testun plaen.

Yn fyr, mae cystrawen Markdown i gyd yn cynnwys symbolau, sy'n cael eu dewis yn ofalus ac mae cipolwg clir ar eu swyddogaethau.Er enghraifft: rhowch seren o amgylch testun i wneud iddo edrych fel *pwyslais*.

Mae rhestrau yn Markdown yn edrych fel rhestrau, wel. Mae Blockquotes yn Markdown wir yn edrych fel dyfynnu darn o destun, fel rydych chi wedi'i weld mewn e-byst.

Yn gydnaws â HTML

Nod gramadeg Markdown yw bod yn iaith ysgrifennu ar gyfer y we.

Nid yw Markdown i fod i gymryd lle HTML, neu hyd yn oed ddod yn agos ato, ychydig iawn o fathau o gystrawen sydd ganddo ac mae'n cyfateb i is-set bach yn unig o farcio HTML. Ni luniwyd Markdown i wneud dogfennau HTML yn haws i'w hysgrifennu.

Yn fy marn i, mae HTML eisoes yn hawdd i'w ysgrifennu. Syniad Markdown yw gwneud dogfennau'n haws i'w darllen, eu hysgrifennu, a'u newid yn ôl ewyllys. Fformat cyhoeddi yw HTML, Markdown yw aYsgrifennu copifformat ysgrifenedig.O'r herwydd, dim ond yr hyn y gall testun plaen ei gynnwys y mae cystrawen fformatio Markdown yn ei gynnwys.

Gellir ysgrifennu tagiau nad ydynt wedi'u cynnwys gan Markdown yn HTML yn uniongyrchol yn y ddogfenHyrwyddo Gwecopi.Nid oes angen marcio hwn fel HTML neu Markdown; dim ond ychwanegu'r marcio yn uniongyrchol.

Dim ond rhai elfennau bloc HTML i'w cyfyngu - megis <div>,<table>,<pre>,<p> a thagiau eraill, rhaid eu gwahanu oddi wrth feysydd cynnwys eraill gyda llinellau gwag cyn ac ar ôl, ac ni ellir mewnoli eu tagiau agor a chau â thabiau neu fylchau. Mae'r generadur Markdown yn ddigon craff i beidio ag ychwanegu tagiau bloc HTML diangen <p> Label.

Mae'r enghraifft fel a ganlyn, gan ychwanegu tabl HTML i'r ffeil Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Sylwch na fydd cystrawen fformatio Markdown rhwng tagiau bloc HTML yn cael ei brosesu.Er enghraifft, os ydych chi'n defnyddio arddull Markdown y tu mewn i bloc HTML*强调*fydd yn cael unrhyw effaith.

Tagiau adran HTML (mewnol) fel <span>,<cite>,<del> Gellir ei ddefnyddio'n rhydd ym mharagraffau, rhestrau neu benawdau Markdown.Yn ôl arferion personol, gallwch hyd yn oed ddefnyddio tagiau HTML i fformatio heb ddefnyddio fformat Markdown.Enghraifft: Os yw'n well gennych HTML <a> 或 <img> tagiau, y gellir eu defnyddio'n uniongyrchol heb y ddolen neu'r gystrawen tag delwedd a ddarperir gan Markdown.

Yn wahanol rhwng tagiau bloc HTML, mae cystrawen Markdown yn ddilys rhwng tagiau adran HTML.

Trosi nodau arbennig yn awtomatig

Mewn ffeiliau HTML, mae dau nod sydd angen eu trin yn arbennig: < 和 & . < defnyddir symbolau ar gyfer tagiau cychwyn,& Defnyddir symbolau i farcio endidau HTML, os ydych am arddangos y prototeip o'r nodau hyn yn unig, rhaid i chi ddefnyddio'r ffurflen endid, fel < 和 &.

& Mae cymeriadau yn poenydio'n arbennig ar gyfer ysgrifenwyr dogfennau gwe, os ydych chi'n mynd i deipio "AT&T", rhaid i chi ysgrifennu"AT&T" .tra yn yr URL & Mae cymeriadau hefyd yn cael eu trosi.Er enghraifft, rydych chi am gysylltu â:

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

Mae'n rhaid i chi ysgrifennu'r trosiad URL fel:

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

i'w gosod yn y tag cyswllt href mewn eiddo.Afraid dweud, mae hyn yn hawdd i'w anwybyddu, ac mae'n debyg y nifer fwyaf o wallau a ganfuwyd gan ddilysu safonau HTML.

Mae Markdown yn caniatáu ichi ysgrifennu cymeriadau yn naturiol, ac mae'n gofalu am yr hyn sydd angen ei drosi.os ydych yn defnyddio & Mae nod yn rhan o endid nodau HTML, mae'n cael ei adael fel y mae, fel arall caiff ei drosi iddo &;.

Felly os ydych chi am fewnosod symbol hawlfraint yn y ddogfen ©, gallwch chi ysgrifennu:

©

Bydd Markdown yn ei adael heb ei gyffwrdd.Ac os ydych chi'n ysgrifennu:

AT&T

Bydd Markdown yn ei drosi i:

AT&T

Mae sefyllfa debyg hefyd yn digwydd yn < nodiant, gan fod Markdown yn caniatáu cydnawsedd HTML, os rhowch < Defnyddir symbolau fel amffinyddion ar gyfer tagiau HTML, ac ni fydd Markdown yn gwneud unrhyw drawsnewidiadau arnynt, ond os ysgrifennwch:

4 < 5

Bydd Markdown yn ei drosi i:

4 < 5

Fodd bynnag, dylid nodi, o fewn cwmpas y cod, p'un a yw'n unol neu'n bloc, < 和 & y ddau symbolyn sicryn cael eu trosi i endidau HTML, nodwedd sy'n eich galluogi i ysgrifennu cod HTML yn hawdd yn Markdown (yn hytrach na HTML, lle rydych chi'n rhoi'r holl < 和 & Mae pob un yn cael ei drawsnewid yn endidau HTML, er mwyn ysgrifennu cod HTML yn y ffeil HTML. )

elfen bloc

Paragraffau a thoriadau llinell

Mae paragraff Markdown yn cynnwys un neu fwy o linellau olynol o destun, gyda mwy nag un llinell wag o'i flaen a'i dilyn (y diffiniad o linell wag yw ei bod yn ymddangos yn wag ac yn cael ei hystyried yn llinell wag. Er enghraifft, , os yw llinell yn cynnwys bylchau a thabiau yn unig, bydd y llinell hefyd yn cael ei thrin fel llinell wag).Ni ddylid mewnoli paragraffau arferol gyda bylchau neu dabiau.

Mae'r ymadrodd "yn cynnwys un neu fwy o linellau testun yn olynol" mewn gwirionedd yn awgrymu bod Markdown yn caniatáu llinellau newydd gorfodol (gosod llinellau newydd) o fewn paragraffau, nodwedd sy'n wahanol i'r rhan fwyaf o fformatau testun-i-HTML eraill (gan gynnwys Math Symudol "Trosi Llinellau Toriadau " opsiwn), bydd fformatau eraill yn trosi pob toriad llinell i <br /> Label.

Os ydychyn wirEisiau dibynnu ar Markdown i fewnosod <br /> Ar gyfer labeli, pwyswch ddau neu fwy o fylchau yn y man mewnosod ac yna pwyswch Enter.

Yn wir, mae angen ychydig mwy o waith (mannau ychwanegol) i'w gynhyrchu <br /> , ond yn syml "mae pob llinell newydd yn cael ei throsi i <br />“Nid yw’r dull yn addas yn Markdown, em yn MarkdownaiMae dyfyniadau bloc arddull L a rhestrau aml-baragraff nid yn unig yn fwy defnyddiol ond hefyd yn haws eu darllen wrth gysodi â thoriadau llinell.

Teitl

Mae Markdown yn cefnogi dwy gystrawen ar gyfer penawdau, tebyg i Setext ac atx-like.

Y ffurf debyg i Settext yw'r ffurflen gyda'r llinell waelod, gan ddefnyddio = (teitl uchaf) a - (Penawdau ail drefn), er enghraifft:

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

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

unrhyw swm = 和 - gall fod yn effeithiol.

Mae'r ffurf tebyg i Atx yn mewnosod 1 i 6 ar ddechrau'r llinell # , yn cyfateb i benawdau 1 i 6, er enghraifft:

# 这是 H1

## 这是 H2

###### 这是 H6

Gallwch chi "gau" penawdau tebyg i atx yn ddewisol, mae hyn ar gyfer estheteg yn unig, os ydych chi'n teimlo'n gyfforddus fel hyn, gallwch chi ei ychwanegu ar ddiwedd y llinell #, tra y terfyna y llinell # Nid oes rhaid i'r rhif fod yr un peth â'r dechrau (nifer y nodau punt ar ddechrau'r llinell sy'n pennu trefn y teitl):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Defnyddir blockquotes markdown yn debyg i'r rhai a ddefnyddir mewn e-bost > o ddyfyniadau.Os ydych chi'n gyfarwydd â dyfyniadau mewn llythyrau e-bost, rydych chi'n gwybod sut i greu dyfynbris bloc mewn ffeil Markdown, a fyddai'n edrych fel pe baech chi'n torri'r llinellau eich hun, yna ychwanegwch > :

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

Mae Markdown hefyd yn caniatáu ichi fod yn ddiog ac ychwanegu llinell gyntaf y paragraff cyfan yn unig > :

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

Gellir nythu cyfeiriadau bloc (ee: cyfeiriadau o fewn cyfeiriadau) trwy ychwanegu nifer gwahanol o > :

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

Gellir defnyddio cystrawennau Markdown eraill hefyd o fewn blociau a ddyfynnir, gan gynnwys penawdau, rhestrau, blociau cod, ac ati:

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

Gall unrhyw olygydd testun gweddus greu dyfyniadau ar ffurf e-bost yn hawdd.Er enghraifft yn BBEdit gallwch ddewis testun ac yna dewis o'r ddewislencynyddu hierarchaeth dyfyniadau.

Rhestr

Mae Markdown yn cefnogi rhestrau archebedig a di-drefn.

Mae rhestrau heb eu trefnu yn defnyddio seren, ynghyd ag arwyddion, neu arwyddion minws fel marcwyr rhestr:

*   Red
*   Green
*   Blue

Cyfwerth â:

+   Red
+   Green
+   Blue

Hefyd yn cyfateb i:

-   Red
-   Green
-   Blue

Mae rhestrau trefnedig yn defnyddio rhifau ac yna cyfnod:

1.  Bird
2.  McHale
3.  Parish

Mae'n bwysig nodi nad yw'r rhifau a ddefnyddiwch ar y tag rhestr yn effeithio ar yr allbwn HTML. Y marc HTML dilynol ar gyfer y rhestr uchod fyddai:

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

Os yw marcio eich rhestr wedi'i ysgrifennu fel:

1.  Bird
1.  McHale
1.  Parish

neu hyd yn oed:

3. Bird
1. McHale
8. Parish

Bydd y ddau ohonoch yn cael yr un allbwn HTML yn union.Y pwynt yw, gallwch chi wneud y rhifau rhestr yn y ffeil Markdown yr un peth â'r canlyniadau allbwn, neu os ydych chi'n ddiog, nid oes angen i chi ofalu am gywirdeb y niferoedd o gwbl.

Os ydych chi'n defnyddio ysgrifennu diog, argymhellir dechrau gyda 1. ar gyfer yr eitem gyntaf, oherwydd efallai y bydd Markdown yn cefnogi priodoledd cychwyn rhestrau archebedig yn y dyfodol.

Fel arfer gosodir y tag eitem rhestr ar y chwith eithaf, ond gellir ei fewnoli, hyd at 3 bwlch, a rhaid i'r tag eitem gael ei ddilyn gan o leiaf un gofod neu dab.

I wneud i'r rhestr edrych yn brafiach, gallwch chi drefnu'r cynnwys gyda mewnoliad sefydlog:

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

Ond os ydych chi'n ddiog, mae hynny'n iawn hefyd:

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

Os yw'r eitemau rhestr yn cael eu gwahanu gan linellau gwag, bydd Markdown yn defnyddio cynnwys yr eitemau wrth allbynnu HTML. <p> Mae labeli wedi'u lapio, er enghraifft:

*   Bird
*   Magic

yn cael ei drosi i:

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

Ond hyn:

*   Bird

*   Magic

yn cael ei drosi i:

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

Gall eitemau rhestr gynnwys paragraffau lluosog, a rhaid i'r paragraffau o dan bob eitem gael eu mewnoli â 4 bwlch neu 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.

Mae'n edrych yn llawer gwell os ydych chi'n mewnoli pob llinell, wrth gwrs, eto, os ydych chi'n ddiog, mae Markdown hefyd yn caniatáu:

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

Os ydych chi am roi cyfeirnod y tu mewn i eitem rhestr, yna > Mae angen ei mewnoli:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Os ydych chi am roi bloc o god, mae angen mewnoli'r blocddwywaith, sef 8 bwlch neu 2 dab:

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

        <代码写在这>

Wrth gwrs, gellid cynhyrchu rhestr o eitemau yn ddamweiniol, rhywbeth fel hyn:

1986. What a great season.

Mewn geiriau eraill, mae'n ymddangos ar ddechrau'r llinellrhif-cyfnod-gwag, er mwyn osgoi hyn, gallwch ychwanegu slaes cyn y cyfnod.

1986\. What a great season.

bloc cod

Fel arfer mae gan ysgrifennu sy'n gysylltiedig â rhaglen neu god ffynhonnell iaith dag flociau cod wedi'u cysodi eisoes. Fel arfer, nid ydym am i'r blociau hyn gael eu cysodi fel ffeiliau paragraff cyffredinol, ond dangoswch nhw fel y maent. Bydd Markdown yn defnyddio <pre> 和 <code> tagiau i lapio blociau cod.

Mae blociau adeiladu cod yn Markdown mor syml â mewnoli 4 bwlch neu 1 tab, er enghraifft, nodwch y canlynol:

这是一个普通段落：

    这是一个代码区块。

Bydd Markdown yn trosi i:

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

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

Mae'r mewnoliad gorchymyn cyntaf hwn fesul llinell (4 bwlch neu 1 tab) yn cael ei ddileu, er enghraifft:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

yn cael ei drosi i:

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

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

Mae bloc o god yn parhau tan y llinell heb ei mewnoli (neu ddiwedd y ffeil).

Y tu mewn i'r bloc cod, & , < 和 > Bydd yn cael ei drawsnewid yn endidau HTML yn awtomatig. Mae'r dull hwn yn ei gwneud yn hawdd iawn i chi ddefnyddio Markdown i fewnosod y cod ffynhonnell HTML ar gyfer yr enghraifft, dim ond ei gopïo a'i gludo, ychwanegu mewnoliad, a bydd y gweddill Markdown yn ei drin ar eich rhan, er enghraifft:

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

yn cael ei drosi i:

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

Yn y bloc cod, ni fydd y gystrawen Markdown gyffredinol yn cael ei throsi, fel seren yn ddim ond sêr, sy'n golygu y gallwch chi ysgrifennu ffeiliau sy'n gysylltiedig â chystrawen Markdown yn hawdd yng nghystrawen Markdown.

rhannwr

Gallwch ddefnyddio mwy na thair seren, arwydd minws, tanlinellu i greu rhannwr mewn llinell, dim byd arall yn y llinell.Gallwch hefyd fewnosod bylchau rhwng sêr neu arwyddion minws.Gellir creu llinellau gwahanu ym mhob un o’r ffyrdd canlynol o ysgrifennu:

* * *

***

*****

- - -

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

elfen adran

dolen

Mae Markdown yn cefnogi dau fath o gystrawen cyswllt: Mewn llinell和Cyfeiriaddwy ffurf.

Y naill ffordd neu'r llall, mae testun cyswllt wedi'i farcio â [cromfachau sgwâr].

i greu aMewn llinellOs ydych chi am ychwanegu testun teitl y ddolen, lapiwch y testun teitl gyda dyfynodau dwbl ar ôl yr URL, er enghraifft:

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

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

Bydd yn cynhyrchu:

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

Os ydych chi'n cysylltu ag adnoddau ar yr un gwesteiwr, gallwch ddefnyddio llwybrau cymharol:

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

CyfeiriadDilynir y ddolen gan fraced sgwâr arall ar ôl cromfachau testun y ddolen, a dylid llenwi’r marc a ddefnyddiwyd i adnabod y ddolen yn yr ail fraced sgwâr:

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

Gallwch hefyd osod bwlch rhwng y ddau fraced sgwâr yn ddewisol:

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

Yna, unrhyw le yn y ffeil, gallwch chi ddiffinio cynnwys cyswllt y tag hwn:

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

Diffinnir cynnwys dolen yn y ffurf:

• Cromfachau sgwâr (yn ddewisol gyda hyd at dri gofod ar gyfer mewnoliad) y gosodir testun cyswllt iddynt
• ac yna colon
• ac yna un neu fwy o fylchau neu dabiau
• URL y ddolen nesaf
• Dilynwch y cynnwys teitl yn ddewisol, y gellir ei amgáu mewn dyfyniadau sengl, dyfyniadau dwbl, neu gromfachau

Mae diffiniadau'r tri dolen ganlynol yr un fath:

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

rhybudd:Mae yna fater hysbys lle mae Markdown.pl 1.0.1 yn anwybyddu teitlau cyswllt sydd wedi'u hamgáu mewn dyfyniadau sengl.

Gellir hefyd amgáu URLs cyswllt mewn cromfachau ongl:

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

Gallwch hefyd roi'r priodoledd teitl ar y llinell nesaf, neu ychwanegu rhywfaint o mewnoliad, a fydd yn edrych yn well os yw'r URL yn rhy hir:

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

Dim ond wrth gynhyrchu'r ddolen y defnyddir y diffiniad URL, ac nid yw'n ymddangos yn uniongyrchol yn y ffeil.

Gall tagiau adnabod cyswllt gynnwys llythrennau, rhifau, gofod gwyn, ac atalnodi, ond nid ydyntDdimMae'n sensitif i achosion, felly mae'r ddwy ddolen ganlynol yr un peth:

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

Tag cyswllt ymhlygnodwedd yn eich galluogi i hepgor nodi tag cyswllt. Yn yr achos hwn, bydd y tag cyswllt yn cael ei drin fel un sy'n cyfateb i destun y ddolen. I ddefnyddio tag cyswllt ymhlyg, ychwanegwch fraced sgwâr gwag ar ôl testun y ddolen. Os ydych chi eisiau "Google " Gan gysylltu â google.com, gallwch symleiddio i:

[Google][]

Yna diffiniwch gynnwys y ddolen:

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

Gan y gall testun cyswllt gynnwys gofod gwyn, gall y marcio symlach hwn gynnwys geiriau lluosog:

Visit [Daring Fireball][] for more information.

Yna ewch ymlaen i ddiffinio'r ddolen:

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

Gellir gosod diffiniad y ddolen unrhyw le yn y ffeil.Mae'n well gen i ei roi yn syth ar ôl y paragraff lle mae'r ddolen yn ymddangos.Gallwch hefyd ei roi ar ddiwedd y ffeil, yn union fel sylw.

Dyma enghraifft o ddolen gyfeirio:

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"

Os byddwch yn ei newid i ddefnyddio enw'r ddolen i ysgrifennu:

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"

Bydd y ddwy ffordd uchod o ysgrifennu yn cynhyrchu'r HTML canlynol.

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

Isod mae ffeil Markdown o'r un cynnwys wedi'i ysgrifennu mewn llinell, a ddarperir ar gyfer cymhariaeth:

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

Mewn gwirionedd, nid y pwynt cyswllt arddull cyfeirio yw ei fod yn haws ei ysgrifennu, ond ei fod yn haws ei ddarllen Cymharwch yr enghraifft uchod.Dim ond 81 nod yw'r erthygl arddull cyfeirio ei hun, ond bydd y ffurf mewnlin yn cynyddu i 176 nod. , os yw wedi'i ysgrifennu mewn fformat HTML pur, bydd yna nodau 234. Mewn fformat HTML, mae mwy o dagiau na thestun.

Gan ddefnyddio dolenni arddull cyfeirio Markdown, gallwch wneud y ddogfen yn debycach i ganlyniad terfynol y porwr, gan ganiatáu i chi symud rhai metadata cysylltiedig â marcio y tu allan i destun y paragraff, a gallwch ychwanegu dolenni heb wneud i deimlad darllen yr erthygl dorri ar draws .

强调

Mae Markdown yn defnyddio seren (*) a'r llinell waelod (_) fel symbol i nodi gair wedi'i danlinellu, yn * 或 _ Mae geiriau amgylchynol yn cael eu trosi i <em> amgylchynu gan labeli, gyda dau * 或 _Os caiff ei lapio, caiff ei drawsnewid yn <strong>, E.g:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

yn troi i mewn i:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Gallwch ddefnyddio pa bynnag arddull rydych chi'n ei hoffi, yr unig gyfyngiad yw y gallwch chi ddefnyddio'r symbol i agor y tag a'r symbol i ddod ag ef i ben.

Gellir gosod pwyslais hefyd yn uniongyrchol yng nghanol y testun:

un*frigging*believable

ondos yw eich * 和 _ Os oes gofod gwyn ar y ddwy ochr, maen nhw'n cael eu trin fel symbolau arferol.

I fewnosod serennau neu danlinellau arferol yn union cyn ac ar ôl testun, gallwch ddefnyddio slaes:

\*this text is surrounded by literal asterisks\*

Côd

Os ydych chi am farcio darn bach o god mewnol, gallwch ei lapio mewn ticio cefn (`), e.e.:

Use the `printf()` function.

Bydd yn cynhyrchu:

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

Os ydych chi am fewnosod tic wrth gefn y tu mewn i adran cod, gallwch chi ddechrau a gorffen yr adran cod gyda thiciau ôl lluosog:

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

Mae'r gystrawen hon yn cynhyrchu:

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

Gallwch chi roi gwag ar ddechrau a diwedd adran cod, un ar ôl y dechrau ac un cyn y diwedd, fel y gallwch chi fewnosod ticciau ar ddechrau'r adran:

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

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

Bydd yn cynhyrchu:

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

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

Y tu mewn i'r adran cod,& a cromfachau ongl都yn cael eu trosi'n awtomatig i endidau HTML, sy'n ei gwneud hi'n hawdd mewnosod cod ffynhonnell HTML, bydd Markdown yn rhoi'r paragraff canlynol:

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

i:

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

Gallwch hefyd ysgrifennu hwn:

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

I gynhyrchu:

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

图片

Yn amlwg, mae'n anodd dylunio cystrawen "naturiol" ar gyfer mewnosod delweddau mewn cymhwysiad testun yn unig.

Mae Markdown yn defnyddio cystrawen tebyg i ddolenni i farcio delweddau, ac mae hefyd yn caniatáu dwy arddull: Mewn llinell和Cyfeiriad.

Mae'r gystrawen delwedd fewnol yn edrych fel:

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

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

Mae'r manylion fel a ganlyn:

• ebychnod !
• yna braced sgwâr gyda thestun alt ar gyfer y ddelwedd
• Dilynir hyn gan gromfachau arferol gyda URL y ddelwedd, ac yn olaf testun 'teitl' dewisol wedi'i amgáu mewn dyfyniadau.

Mae cystrawen y ddelwedd gyfeirio yn edrych fel hyn:

![Alt text][id]

"id" yw enw'r cyfeirnod delwedd, a ddiffinnir yn yr un modd â chyfeirnod cyswllt:

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

Hyd yn hyn, nid oes gan Markdown unrhyw ffordd i nodi lled ac uchder y ddelwedd, os oes angen, gallwch ddefnyddio'r arferol <img> Label.

其它

cyswllt auto

Mae Markdown yn cefnogi prosesu URLs a blychau post e-bost ar ffurf dolenni awtomatig cymharol fyr.Cyn belled â'u bod wedi'u hamgáu mewn cromfachau ongl, bydd Markdown yn ei drosi'n awtomatig yn ddolen.Mae testun cyswllt yr URL cyffredinol yr un peth â'r cyfeiriad cyswllt, er enghraifft:

<http://example.com/>

Bydd Markdown yn cael ei drawsnewid i:

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

Mae cysylltu cyfeiriadau e-bost yn awtomatig hefyd yn debyg iawn, ac eithrio y bydd Markdown yn cyflawni proses drosi amgodio yn gyntaf, gan drosi nodau testun yn endidau HTML hecsadegol. Gall y fformat hwn dwyllo rhai robotiaid casglu cyfeiriadau e-bost gwael, megis:

<[email protected]>

Bydd Markdown yn troi'n:

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

Yn y porwr, mae'r llinyn hwn (mewn gwirionedd <a href="mailto:[email protected]">[email protected]</a>) yn dod yn ddolen "[email protected]" y gellir ei chlicio.

(Er y gall y dull hwn dwyllo llawer o robotiaid, ni all eu hatal i gyd, ond mae'n well na dim. Mewn unrhyw achos, bydd agor eich blwch post yn denu llythyrau hysbysebu yn y pen draw.)

slaes

Gall Markdown ddefnyddio slaes i fewnosod symbolau sydd ag ystyron eraill yn y gramadeg, er enghraifft: os ydych am ychwanegu seren wrth ymyl y testun ar gyfer pwyslais (ond nid <em> tag), gallwch ddod o flaen y seren gydag adlach:

\*literal asterisks\*

Mae Markdown yn cefnogi'r symbolau canlynol ac adlach o'u blaenau i helpu i fewnosod symbolau cyffredin:

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

Golygydd Markdown am ddim

Llwyfan Windows

• MarkdownPad
• MarkPad

Llwyfan Mac

• meddal

golygydd ar-lein

• MPGolygydd

ategyn porwr

• Markdown yma ategyn

*** Os oes gwell golygydd Markdown am ddim i'w argymell, rhowch sylw i adborthChen Weiliang, diolch!