Wat docht Markdown betsjutte Hoe kinne jo Markdown-syntaksis / opmaakmarkearring brûke?

MarkdownWat betsjut?

Hoe kinne jo Markdown-syntaksis / opmaakmarkearring brûke?

Oersicht

Markdown is in lichtgewicht markup-taal makke troch John Gruber.

It lit minsken "dokuminten skriuwe yn platte tekstformaat dat maklik te lêzen en te skriuwen is, en se dan omsette yn jildige XHTML (as HTML) dokuminten".

De taal omfettet in protte fan 'e funksjes fan platte tekstmarkearring dy't al fûn binne yn e-post.

John Gruber makke de Markdown-taal yn 2004, yn gearwurking mei Aaron Swartz foar in grut part oer de grammatika.It doel fan 'e taal is om "in platte tekstformaat te brûken dat maklik te lêzen is, maklik te skriuwen, en opsjoneel konvertearret nei jildich XHTML (as HTML)".

宗旨

It doel fan Markdown is om "maklik te lêzen en maklik te skriuwen" te wêzen.

lêsberens, doch it dochsInternet Marketing, brûkersûnderfining is tige wichtich.

In bestân skreaun yn Markdown moat direkt kinne wurde publisearre yn platte tekst, en moat net ferskine te bestean út in protte tags of opmaakrjochtlinen.

Markdown-syntaksis wurdt beynfloede troch guon besteande tekst-nei-HTML-formaten, ynklusyf Setext, atx, Textile, reStructuredText, Grutatext, en EtText, mar de grutste boarne fan ynspiraasje is it platte tekst-e-postformaat.

Koartsein, de syntaksis fan Markdown is allegear gearstald út symboalen, dy't mei soarch selektearre binne en har funksjes yn ien eachopslach dúdlik binne.Bygelyks: set asterisken om tekst om it derút te meitsjen as *klam*.

Listen yn Markdown lykje, goed, listen. Blockquotes yn Markdown lykje echt op it oanheljen fan in stik tekst, krekt lykas jo hawwe sjoen yn e-mails.

Kompatibel mei HTML

It doel fan de Markdown-grammatika is in skriuwtaal foar it web te wêzen.

Markdown is net bedoeld om HTML te ferfangen, of sels tichtby te kommen, it hat heul pear soarten syntaksis en komt oerien mei mar in lytse subset fan HTML-markup. Markdown waard net betocht om HTML-dokuminten makliker te meitsjen te skriuwen.

Neffens my is HTML al maklik te skriuwen. It idee fan Markdown is om dokuminten makliker te meitsjen om te lêzen, te skriuwen en te feroarjen nei wille. HTML is in publisearjen formaat, Markdown is inCopywritingskreaun formaat.As sadanich beslacht de opmaaksyntaksis fan Markdown allinich wat platte tekst kin.

Tags dy't net wurde behannele troch Markdown kinne direkt yn HTML skreaun wurde yn it dokumintWeb Promoasjekopy.D'r is gjin need om dit te markearjen as HTML of Markdown; foegje gewoan de markup direkt ta.

Allinich guon HTML-blokeleminten moatte wurde beheind - lykas <div>,<table>,<pre>,<p> en oare tags, se moatte wurde skieden fan oare ynhâld gebieten mei lege rigels foar en nei, en harren iepening en sluten tags meie net ynspringe mei ljeppers of spaasjes. De Markdown-generator is tûk genôch om gjin ûnnedige HTML-bloktags ta te foegjen <p> Etiket.

It foarbyld is as folget, it tafoegjen fan in HTML-tabel oan it Markdown-bestân:

这是一个普通段落。

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

这是另一个普通段落。

Tink derom dat Markdown-opmaaksyntaksis tusken HTML-bloktags net ferwurke wurde.As jo ​​​​bygelyks in Markdown-styl brûke yn in HTML-blok*强调*sil gjin effekt hawwe.

HTML-seksje (ynline) tags lykas <span>,<cite>,<del> Kin frij brûkt wurde yn Markdown-paragrafen, listen of kopteksten.Neffens persoanlike gewoanten kinne jo sels HTML-tags brûke om te formatteren sûnder Markdown-formaat te brûken.Foarbyld: As jo ​​leaver HTML <a> 或 <img> tags, dy't direkt kinne wurde brûkt sûnder de keppeling of ôfbyldingstagsyntaksis levere troch Markdown.

Oars as tusken HTML-bloktags, is Markdown-syntaksis jildich tusken HTML-seksjetags.

Automatyske konverzje fan spesjale tekens

Yn HTML-bestannen binne d'r twa tekens dy't spesjale ôfhanneling nedich binne: < en & . < symboalen wurde brûkt foar start tags,& Symboalen wurde brûkt om HTML-entiteiten te markearjen, as jo gewoan it prototype fan dizze karakters wolle werjaan, moatte jo it entiteitsformulier brûke, lykas < en &.

& Karakters binne foaral marteljend foar webdokumintskriuwers, as jo "AT&T", jo moatte skriuwe"AT&T".wylst yn 'e URL & Karakters wurde ek omsetten.As jo ​​bygelyks keppelje wolle nei:

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

Jo moatte de URL-konverzje skriuwe as:

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

wurde pleatst yn de link tag href yn eigenskippen.Unmooglik om te sizzen, dit is maklik te negearjen, en wierskynlik it grutste oantal flaters ûntdutsen troch HTML-standertsvalidaasje.

Markdown lit jo karakters natuerlik skriuwe, en it soarget foar wat moat wurde omboud.as jo brûke & In karakter is diel fan in HTML-karakterentiteit, it wurdt litten sa't it is, oars wurdt it omboud ta &;。

Dus as jo in copyrightsymboal yn it dokumint wolle ynfoegje ©, kinne jo skriuwe:

©

Markdown sil it ûnoantaaste litte.En as jo skriuwe:

AT&T

Markdown sil it konvertearje nei:

AT&T

In fergelykbere situaasje komt ek foar yn < notaasje, sûnt Markdown lit HTML komptabiliteit, as jo sette < Symboalen wurde brûkt as skiedingstekens foar HTML-tags, en Markdown sil der gjin konversaasjes op dwaan, mar as jo skriuwe:

4 < 5

Markdown sil it konvertearje nei:

4 < 5

It moat lykwols opmurken wurde dat binnen it berik fan koade, of it no ynline of blok is, < en & beide symboalenJawiswurde omboud ta HTML-entiteiten, in funksje wêrmei jo maklik HTML-koade kinne skriuwe yn Markdown (yn tsjinstelling ta HTML, wêr't jo alle < en & Alle wurde omset yn HTML-entiteiten, om HTML-koade te skriuwen yn it HTML-bestân. )

blok elemint

Paragrafen en line breaks

In Markdown-alinea is opboud út ien of mear opienfolgjende rigels tekst, foarôfgeand en folge troch mear dan ien lege rigel (de definysje fan in lege rigel is dat it op it skerm leech liket te wêzen en wurdt beskôge as in lege rigel. Foar foarbyld,, as in rigel befettet allinnich spaasjes en ljeppers, de line sil ek wurde behannele as in lege line).Normale alinea's moatte net ynspringe wurde mei spaasjes of ljeppers.

De útdrukking "bestaat út ien of mear opienfolgjende rigels tekst" ymplisearret feitlik dat Markdown twongen nije rigels (ynfoegje fan nije rigels) yn paragrafen mooglik makket, in funksje dy't oars is fan de measte oare tekst-nei-HTML-formaten (ynklusyf Movable Type "Convert Line Breaks" " opsje), sille oare formaten elke rigelôfbrekke konvertearje nei <br /> Etiket.

AstoyndiedWolle jo fertrouwe op Markdown om yn te foegjen <br /> Druk foar labels op twa of mear spaasjes by it ynfoegje plak en druk dan op Enter.

Yndied nimt it wat mear wurk (ekstra romten) om te generearjen <br /> , mar gewoan "elke nije rigel wurdt omboud ta <br />"De metoade is net geskikt yn Markdown, em yn MarkdownaiBlokquotes yn L-styl en listen mei meardere alinea's binne net allinich brûkber, mar ek makliker te lêzen by it ynstellen mei rigelbrekken.

Titel

Markdown stipet twa syntaksis foar kopteksten, Setext-like en atx-like.

De Settext-like foarm is de foarm mei de ûnderste rigel, mei help fan = (heechste titel) en - (kopteksten fan twadde folchoarder), bygelyks:

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

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

elk bedrach = en - kin effektyf wêze.

De Atx-like foarm foeget 1 oant 6 yn oan it begjin fan 'e rigel # , oerienkommende mei kopteksten 1 oant 6, bygelyks:

# 这是 H1

## 这是 H2

###### 这是 H6

Jo kinne opsjoneel atx-achtige kopteksten "slute", dit is puur foar estetyk, as jo jo op dizze manier noflik fiele, kinne jo it tafoegje oan 'e ein fan' e rigel #, wylst de rigel einiget # It nûmer hoecht net itselde te wêzen as it begjin (it oantal pûn tekens oan it begjin fan de rigel bepaalt de folchoarder fan de titel):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Markdown markup blockquotes wurde brûkt fergelykber mei dy brûkt yn e-post > fan sitaten.As jo ​​​​bekend binne mei sitaten yn e-postbrieven, wite jo hoe't jo in blokofferte kinne meitsje yn in Markdown-bestân, dat soe lykje as jo de rigels sels brekke, foegje dan ta > :

> 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 lit jo ek lui wêze en allinich de earste rigel fan 'e heule paragraaf tafoegje > :

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

Blokferwizings kinne wurde nestele (bygelyks: ferwizings binnen referinsjes) troch in oar oantal ta te foegjen > :

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

Oare Markdown-syntaksis kinne ek brûkt wurde binnen oanhelle blokken, ynklusyf kopteksten, listen, koadeblokken, ensfh.

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

Elke fatsoenlike tekstbewurker kin maklik sitaten yn e-poststyl oanmeitsje.Bygelyks yn BBEdit kinne jo tekst selektearje en dan kieze út it menufergrutsje citation hierargy.

列表

Markdown stipet oardere en net-oardere listen.

Net-oardere listen brûke asterisken, plustekens, of minustekens as listmarkers:

*   Red
*   Green
*   Blue

Gelyk oan:

+   Red
+   Green
+   Blue

Ek lykweardich oan:

-   Red
-   Green
-   Blue

Bestelde listen brûke nûmers folge troch in perioade:

1.  Bird
2.  McHale
3.  Parish

It is wichtich om te notearjen dat de nûmers dy't jo brûke op 'e listtag gjin ynfloed hawwe op de útfier HTML. De resultearjende HTML-markearring foar de boppesteande list soe wêze:

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

As jo ​​listmarkearring skreaun is as:

1.  Bird
1.  McHale
1.  Parish

as sels:

3. Bird
1. McHale
8. Parish

Jo sille beide krekt deselde HTML-útfier krije.It punt is dat jo de listnûmers yn 'e Markdown-bestân itselde kinne meitsje as de útfierresultaten, of as jo lui binne, hoege jo hielendal net te soargen oer de korrektheid fan' e nûmers.

As jo ​​​​lui skriuwen brûke, is it oan te rieden om te begjinnen mei 1. foar it earste item, om't Markdown yn 'e takomst it startattribút fan bestelde listen kin stypje.

It list item tag wurdt meastal pleatst op de uterste lofts, mar it kin ynspringe, oant 3 spaasjes, en it item tag moat wurde folge troch op syn minst ien spaasje of ljepper.

Om de list moaier te meitsjen, kinne jo de ynhâld organisearje mei in fêste ynspring:

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

Mar as jo lui binne, is dat ek goed:

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

As de listitems wurde skieden troch lege rigels, sil Markdown de itemynhâld brûke by it útfieren fan HTML. <p> Labels wurde ferpakt, bygelyks:

*   Bird
*   Magic

sil omset wurde yn:

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

Mar dit:

*   Bird

*   Magic

sil omset wurde yn:

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

Listitems kinne meardere paragrafen befetsje, en de paragrafen ûnder elk item moatte ynspringe wurde mei 4 spaasjes of 1 ljepper:

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.

It sjocht der folle better út as jo elke rigel yndrukke, fansels wer, as jo lui binne, lit Markdown ek:

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

As jo ​​​​in referinsje wolle pleatse yn in listitem, dan > It moat yndrukt wurde:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

As jo ​​​​in koadeblok pleatse wolle, moat it blok ynspringe wurdetwaris, dat is 8 spaasjes of 2 ljeppers:

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

        <代码写在这>

Fansels kin in list mei items by ûngelok generearre wurde, sa'n ding:

1986. What a great season.

Mei oare wurden, it ferskynt oan it begjin fan 'e rigelnûmer-perioade-blank, Om dit te foarkommen, kinne jo in backslash tafoegje foar de perioade.

1986\. What a great season.

koade blok

Programma-relatearre skriuw- of tagtaalboarnekoade hat normaal al typesetkoadeblokken. Gewoanlik wolle wy net dat dizze blokken ynsteld wurde op 'e manier fan algemiene alineabestannen, mar werjaan sa't se binne. Markdown sil brûke <pre> en <code> tags om koadeblokken te wrapjen.

Boublokken fan koade yn Markdown is sa ienfâldich as it ynspringen fan 4 spaasjes of 1 ljepper, Fier bygelyks it folgjende yn:

这是一个普通段落：

    这是一个代码区块。

Markdown sil konvertearje nei:

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

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

Dizze earste-order ynspringing per rigel (4 spaasjes of 1 ljepper) wurdt fuortsmiten, bygelyks:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

sil omset wurde yn:

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

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

In blok fan koade giet troch oant de net-ynspringende rigel (of ein fan bestân).

Binnen it koadeblok, & , < en > It wurdt automatysk omset yn HTML-entiteiten. Dizze metoade makket it hiel maklik foar jo om Markdown te brûken om de HTML-boarnekoade foar it foarbyld yn te foegjen, kopiearje en plakke it gewoan, foegje ynspringen ta, en de rest sil Markdown it foar jo behannelje foarbyld:

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

sil omset wurde yn:

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

Yn it koadeblok sil de algemiene Markdown-syntaksis net konvertearre wurde, lykas asterisken binne gewoan asterisken, wat betsjut dat jo maklik Markdown-syntaksis relatearre bestannen kinne skriuwe yn Markdown-syntaksis.

divider

Jo kinne meitsje in divider mei mear as trije asterisken, minus tekens, underscores yn in rigel, neat oars yn 'e rigel.Jo kinne ek spaasjes ynfoegje tusken asterisken of minustekens.Skiedingsrigels kinne wurde makke op elk fan 'e folgjende manieren fan skriuwen:

* * *

***

*****

- - -

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

seksje elemint

link

Markdown stipet twa foarmen fan keppelingsyntaksis: YnlineenReferinsjetwa foarmen.

Hoe dan ek, linktekst is markearre mei [fjouwerkante heakjes].

meitsje inYnlineAs jo ​​​​de titeltekst fan 'e keppeling taheakje wolle, wikkel dan gewoan de titeltekst mei dûbele oanhalingstekens nei de URL, bygelyks:

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

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

Sil produsearje:

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

As jo ​​​​keppelje mei boarnen op deselde host, kinne jo relative paden brûke:

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

ReferinsjeDe keppeling wurdt folge troch in oare fjouwerkante beugel nei de beugel fan 'e keppelingstekst, en it teken dat brûkt wurdt om de keppeling te identifisearjen moat yn 'e twadde fjouwerkante beugel ynfolle wurde:

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

Jo kinne ek opsjoneel in spaasje pleatse tusken de twa fjouwerkante heakjes:

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

Dan, oeral yn it bestân, kinne jo de keppeling ynhâld fan dizze tag definiearje:

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

Link ynhâld wurdt definiearre yn de foarm:

• Fjouwerkante heakjes (opsjoneel foarôfgien troch maksimaal trije spaasjes foar ynspringen) wêryn keppelingstekst wurdt ynfierd
• folge troch in kolon
• folge troch ien of mear spaasjes of ljeppers
• de URL fan de folgjende keppeling
• Folgje opsjoneel de titelynhâld, dy't kin wurde omsletten yn inkele oanhalings, dûbele oanhalings, of haakjes

De definysjes fan 'e folgjende trije keppelings binne itselde:

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

foarsichtigens:D'r is in bekend probleem wêr't Markdown.pl 1.0.1 keppeltitels negeart dy't yn inkele quotes ynsletten binne.

Link-URL's kinne ek wurde ynsletten yn hoekhaken:

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

Jo kinne ek it titel-attribút op 'e folgjende rigel pleatse, of wat ynspringing tafoegje, dy't better sil sjen as de URL te lang is:

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

URL-definysjes wurde allinnich brûkt by it generearjen fan keppelings, en ferskine net direkt yn it bestân.

Keppelingsidentifikaasjetags kinne letters, sifers, wite spaasjes en ynterpunksje befetsje, mar netNeeIt is haadlettergefoelich, dus de folgjende twa keppelings binne itselde:

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

Implisite keppeling tagfunksje lit jo it opjaan fan in keppeling tag weglitte. Yn dit gefal sil de keppeling tag wurde behannele as lykweardich oan de keppeling tekst. Om in ymplisite keppeling tag te brûken, foegje gewoan in lege fjouwerkante heak nei de keppeling tekst ta. As jo ​​wolle "Google " Keppeling nei google.com, kinne jo ferienfâldigje nei:

[Google][]

Definiearje dan de keppeling ynhâld:

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

Om't keppelingstekst wite romte kin befetsje, kin dizze ferienfâldige opmaak meardere wurden befetsje:

Visit [Daring Fireball][] for more information.

Gean dan troch om de keppeling te definiearjen:

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

De definysje fan 'e keppeling kin oeral yn 'e triem pleatst wurde. Ik set it leaver direkt nei de paragraaf wêr't de keppeling ferskynt. Jo kinne it ek oan 'e ein fan 'e triem pleatse, krekt as in opmerking.

Hjir is in foarbyld fan in referinsjekeppeling:

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"

As jo ​​​​it feroarje om de keppeling namme te brûken om te skriuwen:

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"

De boppesteande twa manieren fan skriuwen sille de folgjende HTML produsearje.

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

Hjirûnder is in Markdown-bestân fan deselde ynhâld skreaun ynline, foarsjoen foar fergeliking:

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

Yn feite is it punt fan keppelings yn referinsjestyl net dat se makliker binne om te skriuwen, mar dat se makliker te lêzen binne. Fergelykje it boppesteande foarbyld. It artikel yn referinsjestyl sels is mar 81 karakters, mar de ynline foarm sil tanimme nei 176 karakters. , as it yn suver HTML-formaat skreaun is, sille d'r 234 karakters wêze. Yn HTML-formaat binne d'r mear tags as tekst.

Mei de keppelings yn 'e referinsjestyl fan Markdown kinne jo it dokumint mear meitsje as it úteinlike resultaat fan' e browser, wêrtroch jo guon markup-relatearre metadata bûten de alineatekst kinne ferpleatse, en jo kinne keppelings tafoegje sûnder it lêsgefoel fan it artikel te meitsjen. interrupt .

Ûnderstreekje

Markdown brûkt asterisken (*) en de ûnderste rigel (_) as symboal om in ûnderstreke wurd te markearjen, is * 或 _ Omjûn wurden wurde omsetten ta <em> omjûn troch labels, mei twa * 或 _As it is ynpakt, wurdt it omboud ta <strong>,bgl:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

sil feroarje yn:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Jo kinne brûke hokker styl jo wolle, de ienige beheining is dat jo kinne iepenje de tag mei hokker symboal jo wolle einigje it mei.

De klam kin ek direkt yn 'e midden fan tekst ynfoege wurde:

un*frigging*believable

maras dyn * en _ As der whitespace oan beide kanten, se wurde krekt behannele as normale symboalen.

Om normale asterisken of ûnderstreken direkt foar en nei tekst yn te foegjen, kinne jo backslashes brûke:

\*this text is surrounded by literal asterisks\*

Koade

As jo ​​in lyts stikje ynline koade wolle markearje, kinne jo it yn backticks (`), bgl:

Use the `printf()` function.

Sil produsearje:

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

As jo ​​backticks yn in koade seksje wolle ynfoegje, kinne jo de koade seksje begjinne en einigje mei meardere backticks:

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

Dizze syntaksis produsearret:

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

Jo kinne in leech oan it begjin en ein fan in koade-seksje sette, ien nei it begjin en ien foar it ein, sadat jo backticks kinne ynfoegje oan it begjin fan 'e seksje:

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

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

Sil produsearje:

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

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

Binnen de koade seksje,& en hoeke heakjes都sil automatysk wurde omboud ta HTML-entiteiten, wat it maklik makket om HTML-boarnekoade yn te foegjen, sil Markdown de folgjende paragraaf pleatse:

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

nei:

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

Jo kinne dit ek skriuwe:

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

Meitsje:

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

图片

Fansels is it lestich om in "natuerlike" syntaksis te ûntwerpen foar it ynfoegjen fan ôfbyldings yn in applikaasje allinich foar tekst.

Markdown brûkt in syntaksis fergelykber mei keppelings om ôfbyldings te markearjen, en lit ek twa stilen ta: YnlineenReferinsje.

De ynline-ôfbyldingsyntaksis sjocht der sa út:

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

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

Details binne as folget:

• in útropteken !
• folge troch in fjouwerkante beugel mei alt tekst foar de ôfbylding
• Dit wurdt folge troch normale haakjes mei de URL fan 'e ôfbylding, en as lêste in opsjonele 'titel' tekst ynsletten yn oanhalingstekens.

De syntaksis foar referinsjeôfbylding sjocht der sa út:

![Alt text][id]

"id" is de namme fan 'e ôfbyldingsreferinsje, dy't op deselde manier definiearre is as in keppelingsreferinsje:

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

Oant no hat Markdown gjin manier om de breedte en hichte fan 'e ôfbylding op te jaan, as jo nedich binne, kinne jo de normale brûke <img> Etiket.

其它

auto keppeling

Markdown stipet it ferwurkjen fan URL's en e-mails yn 'e foarm fan koarte automatyske keppelings. Salang't se binne ynsletten yn hoekheakjes, sil Markdown it automatysk omsette yn in keppeling.De linktekst fan in algemiene URL is itselde as it linkadres, bygelyks:

<http://example.com/>

Markdown sil wurde omboud ta:

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

De automatyske keppeling fan e-adressen is ek tige ferlykber, útsein dat Markdown earst in kodearring-konverzjeproses sil útfiere, tekstkarakters omsette yn heksadesimale HTML-entiteiten.

<[email protected]>

Markdown sil feroarje yn:

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

Yn 'e browser is dizze tekenrige (eigentlik <a href="mailto:[email protected]">[email protected]</a>) wurdt in klikbare "[email protected]" keppeling.

(Hoewol't dizze oanpak in protte robots ferrifelje kin, kin it se net allegear stopje, mar it is better as neat. Yn alle gefallen sil it iepenjen fan jo brievebus úteinlik reklamebrieven lûke.)

backslash

Markdown kin backslashes brûke om symboalen yn te foegjen dy't oare betsjuttingen hawwe yn 'e grammatika, bygelyks: as jo in asterisk njonken de tekst taheakje wolle foar klam (mar net <em> tag), kinne jo de asterisk foarôfgean mei in backslash:

\*literal asterisks\*

Markdown stipet de folgjende symboalen foarôfgien troch in backslash om te helpen by it ynfoegjen fan gewoane symboalen:

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

Markdown fergese bewurker

Windows platfoarm

• MarkdownPad
• MarkPad

Mac platfoarm

• sêft

online bewurker

• MPEditor

browser plugin

• Markdown hjir plugin

*** As d'r in bettere fergese Markdown-bewurker is om oan te rieden, jouwe dan asjebleaft omtinken oan feedbackChen Weiliang,tank!