Wat beteken Markdown? Hoe om Markdown-sintaksis/formateringopmaak te gebruik?

MarkdownWat beteken?

Hoe om Markdown-sintaksis/formateringopmaak te gebruik?

oorsig

Markdown is 'n liggewig-opmaaktaal wat deur John Gruber geskep is.

Dit laat mense toe om "dokumente in gewone teksformaat te skryf wat maklik is om te lees en te skryf, en dit dan in geldige XHTML (of HTML) dokumente om te skakel".

Die taal het baie van die kenmerke van gewone teksopmerking wat reeds in e-pos gevind word, geabsorbeer.

John Gruber het die Markdown-taal in 2004 geskep, in samewerking met Aaron Swartz, grootliks oor die sintaksis.Die doel van die taal is om "'n gewone teksformaat te gebruik wat maklik is om te lees, maklik om te skryf, en opsioneel omskakel na geldige XHTML (of HTML)".

doel

Die doel van Markdown is om "maklik om te lees en maklik om te skryf" te wees.

leesbaarheid, doen dit in elk geval网络 营销, gebruikerservaring is baie belangrik.

'n Dokument wat in Markdown geskryf is, behoort direk in gewone teks gepubliseer te kan word, en moet nie lyk asof dit uit baie merkers of formateringsaanwysings bestaan ​​nie.

Markdown-sintaksis word beïnvloed deur sommige bestaande teks-na-HTML-formate, insluitend Setext, atx, Textile, reStructuredText, Grutatext en EtText, maar die grootste bron van inspirasie is die gewone teks-e-posformaat.

Kortom, die sintaksis van Markdown is alles saamgestel uit simbole, wat noukeurig gekies is en hul funksies is met 'n oogopslag duidelik.Byvoorbeeld: plaas sterretjies om teks om dit soos *beklemtoning* te laat lyk.

Lyste in Markdown lyk soos, wel, lyste. Blokaanhalings in Markdown lyk regtig soos om 'n stukkie teks aan te haal, soos jy in e-posse gesien het.

Versoenbaar met HTML

Die doel van die Markdown-grammatika is om 'n skryftaal vir die web te wees.

Markdown is nie bedoel om HTML te vervang nie, of selfs naby daaraan te kom, dit het baie min tipes sintaksis en stem ooreen met slegs 'n klein subset van HTML-opmerk. Markdown is nie ontwerp om HTML-dokumente makliker te maak om te skryf nie.

Na my mening is HTML reeds maklik om te skryf. Die idee van Markdown is om dokumente makliker te maak om te lees, skryf en verander na goeddunke. HTML is 'n publikasie-formaat, Markdown is 'nKopieskryfwerkgeskrewe formaat.As sodanig dek Markdown se formateringssintaksis slegs wat gewone teks kan.

Merkers wat nie deur Markdown gedek word nie, kan direk in die dokument in HTML geskryf wordWebpromosiekopieer.Dit is nie nodig om dit as HTML of Markdown te merk nie; voeg net die opmaak direk by.

Slegs sommige HTML-blokelemente moet beperk word - soos <div>,<table>,<pre>,<p> en ander etikette, moet hulle geskei word van ander inhoudsareas met leë reëls voor en na, en hul openings- en sluitingsetikette moet nie met tabs of spasies ingekeep word nie. Die Markdown-generator is slim genoeg om nie onnodige HTML-blokmerkers by te voeg nie <p> etiket.

Die voorbeeld is soos volg, en voeg 'n HTML-tabel by die Markdown-lêer:

这是一个普通段落。

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

这是另一个普通段落。

Let daarop dat Markdown-formateringssintaksis tussen HTML-blokmerkers nie verwerk sal word nie.Byvoorbeeld, as jy 'n Markdown-styl binne 'n HTML-blok gebruik*强调*geen effek sal hê nie.

HTML-afdeling (inline) tags soos <span>,<cite>,<del> Kan vrylik in Markdown-paragrawe, lyste of opskrifte gebruik word.Volgens persoonlike gewoontes kan jy selfs HTML-etikette gebruik om te formateer sonder om Markdown-formaat te gebruik.Voorbeeld: As jy HTML verkies <a> 或 <img> merkers, wat direk gebruik kan word sonder die skakel- of beeldmerker-sintaksis wat deur Markdown verskaf word.

Anders as tussen HTML-blokmerkers, is Markdown-sintaksis geldig tussen HTML-afdelingmerkers.

Outomatiese omskakeling van spesiale karakters

In HTML-lêers is daar twee karakters wat spesiale hantering vereis: < 和 & . < simbole word gebruik vir beginmerkers,& Simbole word gebruik om HTML-entiteite te merk, as jy net die prototipe van hierdie karakters wil vertoon, moet jy die entiteitsvorm gebruik, soos < 和 &.

& Karakters is veral pynlik vir webdokumentskrywers, as jy " gaan tikAT&T", jy moet skryf"AT&T".terwyl dit in die URL is & Karakters word ook omgeskakel.Jy wil byvoorbeeld skakel na:

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

Jy moet die URL-omskakeling skryf as:

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

om in die skakelmerker geplaas te word href in eiendomme.Nodeloos om te sê, dit is maklik om te ignoreer, en waarskynlik die grootste aantal foute wat deur HTML-standaarde-validering opgespoor word.

Markdown laat jou toe om karakters natuurlik te skryf, en dit sorg vir wat omgeskakel moet word.as jy gebruik & 'n Karakter is deel van 'n HTML-karakterentiteit, dit word gelaat soos dit is, anders word dit omgeskakel na &;.

So as jy 'n kopieregsimbool in die dokument wil invoeg ©, jy kan skryf:

©

Markdown sal dit onaangeraak laat.En as jy skryf:

AT&T

Markdown sal dit omskakel na:

AT&T

'n Soortgelyke situasie kom ook voor in < notasie, aangesien Markdown HTML-versoenbaarheid toelaat, as jy dit stel < Simbole word as skeidingstekens vir HTML-etikette gebruik, en Markdown sal nie enige omskakelings daarop doen nie, maar as jy skryf:

4 < 5

Markdown sal dit omskakel na:

4 < 5

Daar moet egter op gelet word dat binne die bestek van kode, of dit inlyn of blok is, < 和 & beide simbolevir sekerword omgeskakel na HTML-entiteite, 'n kenmerk waarmee jy maklik HTML-kode in Markdown kan skryf (in teenstelling met HTML, waar jy al die < 和 & Almal word in HTML-entiteite omgeskakel om HTML-kode in die HTML-lêer te skryf. )

blok element

Paragrawe en lynbreuke

'n Markdown-paragraaf bestaan ​​uit een of meer opeenvolgende reëls teks, voorafgegaan en gevolg deur meer as een leë reël (die definisie van 'n leë reël is dat dit lyk asof dit leeg is op vertoon en as 'n leë reël beskou word. Bv. , as 'n reël slegs spasies en oortjies bevat, sal die reël ook as 'n leë reël hanteer word).Normale paragrawe moet nie met spasies of oortjies ingekeep word nie.

Die frase "bestaan ​​uit een of meer opeenvolgende reëls teks" impliseer eintlik dat Markdown gedwonge nuwe lyne (invoeging van nuwe reëls) binne paragrawe toelaat, 'n kenmerk wat verskil van die meeste ander teks-na-HTML-formate (insluitend Movable Type "Skakel lynbrekings om" " opsie), sal ander formate elke reëlbreuk omskakel na <br /> etiket.

如果 你inderdaadWil staatmaak op Markdown om in te voeg <br /> Vir etikette, druk twee of meer spasies by die invoegplek en druk dan Enter.

Inderdaad, dit verg 'n bietjie meer werk (bykomende spasies) om te genereer <br /> , maar eenvoudig "elke nuwe reël word omgeskakel na <br />"Die metode is nie geskik in Markdown nie, em in MarkdownaiL-styl blokaanhalings en multi-paragraaf lyste is nie net meer bruikbaar nie, maar ook makliker om te lees wanneer getik met reëlbreuke.

Headline

Markdown ondersteun twee sintakse vir opskrifte, Setext-agtige en atx-agtige.

Die Settext-agtige vorm is die vorm met die onderste lyn, met behulp van = (hoogste titel) en - (Tweede orde opskrifte), byvoorbeeld:

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

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

enige bedrag = 和 - effektief kan wees.

Die Atx-agtige vorm voeg 1 tot 6 aan die begin van die reël in # , wat ooreenstem met opskrifte 1 tot 6, byvoorbeeld:

# 这是 H1

## 这是 H2

###### 这是 H6

Jy kan opsioneel atx-agtige opskrifte "toemaak", dit is suiwer vir estetika, as jy gemaklik voel op hierdie manier, kan jy dit aan die einde van die reël byvoeg #, terwyl die reël eindig # Die nommer hoef nie dieselfde te wees as die begin nie (die aantal pondkarakters aan die begin van die reël bepaal die volgorde van die titel):

# 这是 H1 #

## 这是 H2 ##

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

Blokaanhalings Blokaanhalings

Markdown-opmerk-blokaanhalings word soortgelyk aan dié wat in e-pos gebruik word, gebruik > van aanhalings.As jy vertroud is met aanhalings in e-posbriewe, weet jy hoe om 'n blokaanhaling in 'n Markdown-lêer te skep, wat sal lyk asof jy self die lyne breek en dan byvoeg > :

> 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 laat jou ook toe om lui te wees en net die eerste reël van die hele paragraaf by te voeg > :

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

Blokverwysings kan geneste word (bv. verwysings binne verwysings) deur 'n ander aantal by te voeg > :

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

Ander Markdown-sintakse kan ook binne aangehaalde blokke gebruik word, insluitend opskrifte, lyste, kodeblokke, ens.:

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

Enige ordentlike teksredigeerder kan maklik e-pos-styl aanhalings skep.Byvoorbeeld in BBEdit kan jy teks kies en dan uit die kieslys kiesverhoog aanhalingshiërargie.

lys

Markdown ondersteun geordende en ongeordende lyste.

Ongeordende lyste gebruik sterretjies, plustekens of minustekens as lysmerkers:

*   Red
*   Green
*   Blue

Ekwivalent aan:

+   Red
+   Green
+   Blue

Ook gelykstaande aan:

-   Red
-   Green
-   Blue

Geordende lyste gebruik nommers gevolg deur 'n punt:

1.  Bird
2.  McHale
3.  Parish

Dit is belangrik om daarop te let dat die nommers wat jy op die lysmerker gebruik nie die uitvoer HTML beïnvloed nie. Die gevolglike HTML-opmerk vir die lys hierbo sal wees:

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

As jou lysopmerk geskryf is as:

1.  Bird
1.  McHale
1.  Parish

of selfs:

3. Bird
1. McHale
8. Parish

Julle sal albei presies dieselfde HTML-uitvoer kry.Die punt is, jy kan die lysnommers in die Markdown-lêer dieselfde maak as die uitvoerresultate, of as jy lui is, hoef jy glad nie omgee vir die korrektheid van die nommers nie.

As jy lui skryfwerk gebruik, word dit aanbeveel om met 1. vir die eerste item te begin, want Markdown kan in die toekoms die beginkenmerk van geordende lyste ondersteun.

Die lysitemmerker word gewoonlik heel links geplaas, maar dit kan tot 3 spasies ingekeep word, en die itemmerker moet deur ten minste een spasie of oortjie gevolg word.

Om die lys mooier te laat lyk, kan jy die inhoud met 'n vaste inspringing organiseer:

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

Maar as jy lui is, is dit ook 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 die lysitems deur leë lyne geskei word, sal Markdown die iteminhoud gebruik wanneer HTML uitgestuur word. <p> Etikette word toegedraai, byvoorbeeld:

*   Bird
*   Magic

sal omgeskakel word na:

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

Maar hierdie:

*   Bird

*   Magic

sal omgeskakel word na:

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

Lysitems kan veelvuldige paragrawe bevat, en die paragrawe onder elke item moet met 4 spasies of 1 oortjie ingekeep word:

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.

Dit lyk baie beter as jy elke reël inkeep, natuurlik, weer, as jy lui is, laat Markdown ook toe:

*   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 jy 'n verwysing in 'n lysitem wil plaas, dan > Dit moet ingekeep word:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

As jy 'n kodeblok wil plaas, moet die blok ingekeep wordtwee keer, wat 8 spasies of 2 oortjies is:

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

        <代码写在这>

Natuurlik kan 'n lys items per ongeluk gegenereer word, iets soos hierdie:

1986. What a great season.

Met ander woorde, dit verskyn aan die begin van die reëlnommer-periode-leë, om dit te vermy, kan jy 'n terugskuinsstreep voor die tydperk byvoeg.

1986\. What a great season.

kode blok

Programverwante skrif- of merkertaalbronkode het gewoonlik reeds tipekodeblokke. Gewoonlik wil ons nie hê dat hierdie blokke op die manier van algemene paragraaflêers getipeer moet word nie, maar vertoon hulle soos dit is. Markdown sal gebruik <pre> 和 <code> etikette om kodeblokke toe te draai.

Boublokke van kode in Markdown is so eenvoudig soos om 4 spasies of 1 oortjie in te tik, voer byvoorbeeld die volgende in:

这是一个普通段落：

    这是一个代码区块。

Markdown sal omskakel na:

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

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

Hierdie eerste-orde inkeping per reël (4 spasies of 1 oortjie) word verwyder, byvoorbeeld:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

sal omgeskakel word na:

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

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

'n Blok kode gaan voort tot die reël wat nie ingekeep is nie (of die einde van die lêer).

Binne die kodeblok, & , < 和 > Dit sal outomaties in HTML-entiteite omgeskakel word. Hierdie metode maak dit vir jou baie maklik om Markdown te gebruik om die HTML-bronkode vir die voorbeeld in te voeg. Kopieer en plak dit net, voeg inkeping by, en die res van die Markdown sal vir jou hanteer word , byvoorbeeld:

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

sal omgeskakel word na:

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

In die kodeblok sal die algemene Markdown-sintaksis nie omgeskakel word nie, soos sterretjies is net sterretjies, wat beteken dat jy maklik Markdown-sintaksisverwante lêers in Markdown-sintaksis kan skryf.

verdeler

Jy kan 'n verdeler skep met meer as drie sterretjies, minustekens, onderstrepings in 'n lyn, niks anders in die lyn nie.Jy kan ook spasies tussen sterretjies of minustekens invoeg.Skeidingslyne kan op elk van die volgende maniere van skryf geskep word:

* * *

***

*****

- - -

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

afdeling element

skakel

Markdown ondersteun twee vorme van skakelsintaksis: In lyn和Verwysingtwee vorme.

Hoe dit ook al sy, skakelteks is gemerk met [vierkantige hakies].

om 'n te skepIn lynAs jy die titelteks van die skakel wil byvoeg, draai net die titelteks met dubbele aanhalingstekens na die URL toe, byvoorbeeld:

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

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

Sal produseer:

<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 jy na hulpbronne op dieselfde gasheer koppel, kan jy relatiewe paaie gebruik:

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

VerwysingDie skakel word gevolg deur nog 'n vierkantige hakie na die hakies van die skakelteks, en die merk wat gebruik word om die skakel te identifiseer moet in die tweede vierkantige hakie gevul word:

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

Jy kan ook opsioneel 'n spasie tussen die twee vierkantige hakies plaas:

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

Dan, enige plek in die lêer, kan jy die skakelinhoud van hierdie merker definieer:

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

Skakelinhoud word gedefinieer in die vorm:

• Vierkante hakies (opsioneel voorafgegaan deur tot drie spasies vir inkeping) waarin skakelteks ingevoer word
• gevolg deur 'n dubbelpunt
• gevolg deur een of meer spasies of oortjies
• die URL van die volgende skakel
• Volg opsioneel die titelinhoud, wat in enkele aanhalingstekens, dubbele aanhalingstekens of hakies ingesluit kan word

Die definisies van die volgende drie skakels is dieselfde:

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

Let op:Daar is 'n bekende probleem waar Markdown.pl 1.0.1 skakeltitels wat in enkele aanhalings ingesluit is, ignoreer.

Skakel-URL'e kan ook in hoekhakies ingesluit word:

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

Jy kan ook die titel-kenmerk op die volgende reël plaas, of 'n inkeping byvoeg, wat beter sal lyk as die URL te lank is:

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

Die URL-definisie word slegs gebruik wanneer die skakel gegenereer word, en verskyn nie direk in die lêer nie.

Skakelidentifikasiemerkers kan letters, syfers, witspasies en leestekens bevat, maar moenienieDit is hooflettersensitief, so die volgende twee skakels is dieselfde:

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

Implisiete skakelmerkerfunksie laat jou toe om uit te laat om 'n skakelmerker te spesifiseer. In hierdie geval sal die skakelmerker as gelykstaande aan die skakelteks hanteer word. Om 'n implisiete skakelmerker te gebruik, voeg net 'n leë vierkantige hakie na die skakelteks by. As jy wil "Google " As u na google.com skakel, kan u dit vereenvoudig na:

[Google][]

Definieer dan die skakelinhoud:

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

Aangesien skakelteks witspasie kan bevat, kan hierdie vereenvoudigde opmaak veelvuldige woorde bevat:

Visit [Daring Fireball][] for more information.

Gaan dan voort om die skakel te definieer:

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

Die definisie van die skakel kan enige plek in die lêer geplaas word Ek verkies om dit direk na die paragraaf te plaas waar die skakel verskyn. Jy kan dit ook aan die einde van die lêer plaas, net soos 'n opmerking.

Hier is 'n voorbeeld van 'n verwysingsskakel:

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 jy dit verander om die skakelnaam te gebruik om te skryf:

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"

Bogenoemde twee maniere van skryf sal die volgende HTML produseer.

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

Hieronder is 'n Markdown-lêer van dieselfde inhoud wat inlyn geskryf is, voorsien vir vergelyking:

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

Trouens, die punt van verwysingstylskakels is nie dat dit makliker is om te skryf nie, maar dat dit makliker is om te lees.Vergelyk bogenoemde voorbeeld.Die verwysingstylartikel self is slegs 81 karakters, maar die inlynvorm sal vermeerder tot 176 karakters. , as dit in suiwer HTML-formaat geskryf is, sal daar 234 karakters wees. In HTML-formaat is daar meer merkers as teks.

Deur Markdown se verwysingstylskakels te gebruik, kan jy die dokument meer soos die finale resultaat van die blaaier maak, wat jou in staat stel om sekere opmerkverwante metadata buite die paragraafteks te skuif, en jy kan skakels byvoeg sonder om die leesgevoel van die artikel te maak. interrupt .

强调

Markdown gebruik sterretjies (*) en die onderste lyn (_) as 'n simbool om 'n onderstreepte woord te merk, is * 或 _ Omringde woorde word omgeskakel na <em> omring deur etikette, met twee * 或 _As dit toegedraai word, sal dit omskep word in <strong>, Byvoorbeeld:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

sal verander in:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Jy kan enige styl gebruik wat jy wil, die enigste beperking is dat jy die simbool kan gebruik om die merker oop te maak en die simbool om dit te beëindig.

Klem kan ook direk in die middel van teks ingevoeg word:

un*frigging*believable

maaras jou * 和 _ As daar wit spasies aan beide kante is, word dit net as normale simbole behandel.

Om normale sterretjies of onderstrepe direk voor en na teks in te voeg, kan jy agterste skuinsstreepies gebruik:

\*this text is surrounded by literal asterisks\*

Kode

As jy 'n klein stukkie inline kode wil merk, kan jy dit in backticks toedraai (`), bv:

Use the `printf()` function.

Sal produseer:

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

As jy backticks binne 'n kode-afdeling wil invoeg, kan jy die kode-afdeling met veelvuldige backticks begin en beëindig:

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

Hierdie sintaksis produseer:

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

Jy kan 'n spasie aan die begin en einde van 'n kode-afdeling plaas, een na die begin en een voor die einde, sodat jy backticks aan die begin van die afdeling kan invoeg:

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

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

Sal produseer:

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

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

Binne die kode afdeling,& en hoekhakies都outomaties omgeskakel word na HTML-entiteite, wat dit maklik maak om HTML-bronkode in te voeg, sal Markdown die volgende paragraaf plaas:

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

aan:

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

Jy kan ook hierdie skryf:

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

Te produseer:

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

图片

Dit is duidelik dat dit moeilik is om 'n "natuurlike" sintaksis te ontwerp vir die invoeging van beelde in 'n teks-alleen toepassing.

Markdown gebruik 'n sintaksis soortgelyk aan skakels om beelde op te merk, en laat ook twee style toe: In lyn和Verwysing.

Die inlyn beeldsintaksis lyk soos volg:

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

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

Besonderhede is soos volg:

• 'n uitroepteken !
• gevolg deur 'n vierkantige hakie met alt-teks vir die prent
• Dit word gevolg deur normale hakies met die URL van die prent, en laastens 'n opsionele 'titel' teks tussen aanhalingstekens.

Die verwysingsbeeldsintaksis lyk soos volg:

![Alt text][id]

"id" is die naam van die beeldverwysing, wat op dieselfde manier as 'n skakelverwysing gedefinieer word:

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

Tot dusver het Markdown geen manier om die breedte en hoogte van die beeld te spesifiseer nie, as jy nodig het, kan jy die normale gebruik <img> etiket.

其它

outomatiese skakel

Markdown ondersteun die verwerking van URL's en e-posse in die vorm van kort outomatiese skakels. Solank hulle in hoekhakies ingesluit is, sal Markdown dit outomaties in 'n skakel omskakel.Die skakelteks van die algemene URL is dieselfde as die skakeladres, byvoorbeeld:

<http://example.com/>

Markdown sal omgeskakel word na:

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

Die outomatiese koppeling van e-posadresse is ook baie soortgelyk, behalwe dat Markdown eers 'n enkodering-omskakelingsproses sal uitvoer, wat tekskarakters in heksadesimale HTML-entiteite omskakel. Hierdie formaat kan 'n paar slegte e-posadresversamelingsrobotte mislei, soos:

<[email protected]>

Markdown sal verander in:

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

In die blaaier, hierdie string (eintlik <a href="mailto:[email protected]">[email protected]</a>) word 'n klikbare "[email protected]"-skakel.

(Hoewel hierdie benadering baie robotte kan flous, kan dit hulle nie almal keer nie, maar dit is beter as niks. In elk geval, om jou posbus oop te maak sal uiteindelik advertensiebriewe lok.)

terugskuif

Markdown kan agterste skuinsstreepies gebruik om simbole wat ander betekenisse in die grammatika het, in te voeg, byvoorbeeld: as jy 'n asterisk langs die teks wil byvoeg vir beklemtoning (maar nie <em> merker), kan jy die sterretjie met 'n terugskuinsstreep voorafgaan:

\*literal asterisks\*

Markdown ondersteun die volgende simbole wat voorafgegaan word deur 'n skuinsstreep om algemene simbole in te voeg:

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

Markdown gratis redakteur

Windows platform

• MarkdownPad
• MarkPad

Mac platform

• sagte

aanlyn redakteur

• MPE-redakteur

blaaier-inprop

• Markdown hier-inprop

*** As daar 'n beter gratis Markdown-redigeerder is om aan te beveel, let asseblief op terugvoerChen Weiliang,Dankie!