Wat heescht Markdown heeschen? Wéi benotzen ech Markdown Syntax / Formatéierungsmarkup?

MarkdownWat heescht?

Wéi benotzen ech Markdown Syntax / Formatéierungsmarkup?

Iwwersiicht

Markdown ass eng liicht Markup Sprooch erstallt vum John Gruber.

Et erlaabt d'Leit "Dokumenter am einfachen Textformat ze schreiwen dat einfach ze liesen a schreiwen ass, an se dann a gëlteg XHTML (oder HTML) Dokumenter konvertéieren".

D'Sprooch enthält vill vun de Funktiounen vum Einfache Text Markup, déi schonn an der E-Mail fonnt goufen.

Den John Gruber huet d'Markdown Sprooch am Joer 2004 erstallt, an Zesummenaarbecht mam Aaron Swartz zu engem groussen Deel op der Grammatik.Den Zweck vun der Sprooch ass "e Einfachen Textformat ze benotzen dat einfach ass ze liesen, einfach ze schreiwen, an optional op gëlteg XHTML (oder HTML) konvertéiert".

Zweck

D'Zil vum Markdown ass "einfach ze liesen an einfach ze schreiwen".

Liesbarkeet, maacht et souwisouInternet Marketing, Benotzererfarung ass ganz wichteg.

En Dokument, dat am Markdown geschriwwe gëtt, soll fäeg sinn direkt am Kloertext publizéiert ze ginn, a sollt net aus villen Tags oder Formatéierungsdirektiven zesummegesat ginn.

Markdown Syntax ass beaflosst vun e puer existent Text-zu-HTML Formater, dorënner Setext, atx, Textile, reStructuredText, Grutatext, an EtText, awer déi gréisste Quell vun Inspiratioun ass de Einfache Text E-Mail Format.

Kuerz gesot, d'Syntax vu Markdown besteet all aus Symboler, déi suergfälteg ausgewielt ginn an hir Funktiounen op ee Bléck kloer sinn.Zum Beispill: setzt Asterisken ronderëm den Text fir datt et ausgesäit wéi *Betonung*.

Lëschten am Markdown kucken wéi, gutt, Lëschte. Blockquotes am Markdown kucken wierklech aus wéi e Stéck Text zitéiert, wéi Dir an E-Maile gesinn hutt.

Kompatibel mat HTML

D'Zil vun der Markdown Grammatik ass eng Schreifsprooch fir de Web ze sinn.

Markdown ass net geduecht fir HTML ze ersetzen, oder souguer no ze kommen, et huet ganz wéineg Aarte vu Syntax a entsprécht nëmmen e klengen Ënnerdeel vun HTML Markup. Markdown gouf net konzipéiert fir HTML Dokumenter méi einfach ze schreiwen.

Menger Meenung no ass HTML scho einfach ze schreiwen. D'Iddi vu Markdown ass d'Dokumenter méi einfach ze liesen, ze schreiwen an z'änneren no Wëllen. HTML ass e Verëffentlechungsformat, Markdown ass ecopywritinggeschriwen Format.Als esou deckt dem Markdown seng Formatéierungssyntax nëmmen dat wat Einfach Text kann.

Tags déi net vum Markdown ofgedeckt sinn, kënnen an HTML direkt am Dokument geschriwwe ginnWeb Promotiounkopéieren.Et ass net néideg dëst als HTML oder Markdown ze markéieren; füügt just d'Markup direkt un.

Nëmmen e puer HTML Blockelementer déi ageschränkt ginn - wéi z <div>,<table>,<pre>,<p> an aner Tags, si musse vun aneren Inhaltsberäicher mat eidel Zeilen virun an no getrennt ginn, an hir Ouvertures- an Ofschlosstags däerfen net mat Tabs oder Plazen agedréckt ginn. De Markdown Generator ass intelligent genuch fir net onnéideg HTML Block Tags ze addéieren <p> Etikett.

D'Beispill ass wéi follegt, andeems en HTML-Tabelle an d'Markdown-Datei bäidréit:

这是一个普通段落。

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

这是另一个普通段落。

Notéiert datt d'Markdown Formatéierungssyntax tëscht HTML Blocktags net veraarbecht ginn.Zum Beispill, wann Dir Markdown Stil bannent HTML Blocks benotzt*强调*wäert keen Effekt hunn.

HTML Sektioun (inline) Tags wéi <span>,<cite>,<del> Kann fräi a Markdown Abschnitter, Lëschten oder Rubriken benotzt ginn.Geméiss perséinleche Gewunnechten kënnt Dir souguer HTML Tags benotze fir ze formatéieren ouni Markdown Format ze benotzen.Beispill: Wann Dir HTML léiwer <a> Ëff <img> Tags, déi direkt ouni de Link oder Bild Tag Syntax benotzt kënne ginn, déi vum Markdown geliwwert gëtt.

Am Géigesaz zu HTML Block Tags ass Markdown Syntax valabel tëscht HTML Sektioun Tags.

Automatesch Konversioun vu speziellen Zeechen

An HTML Dateien ginn et zwee Zeechen déi speziell Handhabung erfuerderen: < an & . < Symboler gi fir Starttags benotzt,& Symboler gi benotzt fir HTML Entitéiten ze markéieren, wann Dir just de Prototyp vun dëse Charaktere wëllt weisen, musst Dir d'Entitéitsform benotzen, wéi < an &.

& Charaktere si besonnesch pine fir Webdokumenter Schrëftsteller, wann Dir "AT&T", Dir musst schreiwen"AT&T".während an der URL & Zeeche sinn och ëmgerechent.Zum Beispill wëllt Dir Link op:

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

Dir musst d'URL Konversioun schreiwen als:

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

am Link Tag gesat ginn href an Eegeschaften.Noutlosegkeet ze soen, dëst ass einfach ze ignoréieren, a wahrscheinlech déi gréisst Zuel vu Feeler, déi duerch HTML Standards Validatioun entdeckt goufen.

Markdown erlaabt Iech Charaktere natierlech ze schreiwen, an et këmmert sech ëm wat ëmgewandelt muss ginn.wann Dir benotzt & E Charakter ass en Deel vun enger HTML Charakter Entitéit, et ass lénks wéi ass, soss gëtt et ëmgewandelt &;.

Also wann Dir e Copyright Symbol an d'Dokument wëllt setzen ©, Dir kënnt schreiwen:

©

Markdown wäert et onberéiert loossen.A wann Dir schreift:

AT&T

Markdown konvertéiert et op:

AT&T

Eng ähnlech Situatioun geschitt och an < Notatioun, well Markdown erlaabt HTML Kompatibilitéit, wann Dir setzt < Symboler ginn als Ofgrenzer fir HTML Tags benotzt, a Markdown wäert keng Konversiounen op hinnen maachen, awer wann Dir schreift:

4 < 5

Markdown konvertéiert et op:

4 < 5

Wéi och ëmmer, et sollt bemierkt datt am Kader vum Code, egal ob et inline oder blockéiert ass, < an & souwuel Symbolerganz bestëmmtginn an HTML Entitéiten ëmgewandelt, eng Feature déi Iech erlaabt HTML Code am Markdown einfach ze schreiwen (am Géigesaz zu HTML, wou Dir all < an & All ginn an HTML Entitéiten ëmgewandelt, fir HTML Code an der HTML Datei ze schreiwen. )

Block Element

Paragrafen an Linn Break

E Markdown-Paragraf besteet aus enger oder méi opfolgend Zeilen vum Text, virun a gefollegt vu méi wéi eng eidel Zeil (d'Definitioun vun enger eidel Zeil ass datt se um Display eidel schéngt a gëtt als eidel Zeil ugesinn. Beispill,, wann eng Linn enthält nëmmen Plazen an Tabulatioun, der Linn wäert och als eidel Linn behandelt ginn).Normal Abschnitter däerfen net mat Spalten oder Tabs agedréckt ginn.

Den Ausdrock "besteet aus enger oder méi konsekutiv Zeilen vum Text" implizéiert tatsächlech datt Markdown gezwongen Neilinnen erlaabt (Insertion vun Neilinnen) bannent Paragrafen, eng Feature déi anescht ass wéi déi meescht aner Text-zu-HTML Formater (inklusiv Movable Type "Convert Line Breaks" " Optioun), aner Formater konvertéieren all Zeilpaus op <br /> Etikett.

Wanns dutatsächlechWëllt op Markdown vertrauen fir ze setzen <br /> Fir Etiketten, dréckt zwee oder méi Plazen op der Insertplaz an dréckt dann op Enter.

Tatsächlech brauch et e bësse méi Aarbecht (zousätzlech Plazen) fir ze generéieren <br /> , awer einfach "all Neilinn gëtt ëmgewandelt an <br />"D'Method ass net gëeegent am Markdown, em am MarkdownaiL-Stil Blockquotes a Multi-Paragraph Lëschte sinn net nëmme méi nëtzlech, awer och méi einfach ze liesen wann Dir mat Zeilpausen setzt.

Tittel

Markdown ënnerstëtzt zwou Syntaxe fir Rubriken, Setext-ähnlech an atx-ähnlech.

D'Settext-ähnlech Form ass d'Form mat der ënneschter Linn, benotzt = (héchsten Titel) an - (Rubriken vun der zweeter Uerdnung), zum Beispill:

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

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

all Betrag = an - kann effektiv sinn.

Déi Atx-ähnlech Form setzt 1 bis 6 am Ufank vun der Linn # , entspriechend Rubriken 1 bis 6, zum Beispill:

# 这是 H1

## 这是 H2

###### 这是 H6

Dir kënnt optional atx-ähnlech Header "zoumaachen", dëst ass reng fir Ästhetik, wann Dir Iech esou bequem fillt, kënnt Dir et um Enn vun der Linn derbäisetzen #, iwwerdeems d'Linn Enn # D'Zuel muss net d'selwecht sinn wéi den Ufank (d'Zuel vun de Pound Zeechen um Ufank vun der Zeil bestëmmt d'Uerdnung vum Titel):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Markdown Markup Blockquotes ginn ähnlech wéi déi an E-Mail benotzt > vun Zitater.Wann Dir nach ëmmer mat Zitater an E-Mail-Bréiwer vertraut sidd, wësst Dir wéi Dir e Blockzitat an enger Markdown-Datei erstellt, wat ausgesäit wéi wann Dir d'Linnen selwer brécht, da füügt > :

> 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 erlaabt Iech och faul ze sinn an nëmmen déi éischt Zeil vum ganze Paragraph bäizefügen > :

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

Block Referenze kënnen nestéiert ginn (zB: Referenze bannent Referenzen) andeems eng aner Zuel vun derbäigesat gëtt > :

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

Aner Markdown Syntaxe kënnen och an zitéierte Blocke benotzt ginn, dorënner Rubriken, Lëschten, Codeblocken, asw.:

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

All anstänneg Texteditor kann einfach E-Mail-Stil Zitater erstellen.Zum Beispill am BBEdit kënnt Dir Text auswielen an dann aus dem Menü wielenErhéijung Zitatioun Hierarchie.

Lëscht

Markdown ënnerstëtzt bestallt an net bestallt Lëschte.

Onbestallte Lëschte benotzen Asterisken, Pluszeechen oder Minuszeechen als Lëschtmarkéierer:

*   Red
*   Green
*   Blue

Äquivalent zu:

+   Red
+   Green
+   Blue

Och gläichwäerteg zu:

-   Red
-   Green
-   Blue

Bestallt Lëschte benotzen Zuelen gefollegt vun enger Period:

1.  Bird
2.  McHale
3.  Parish

Et ass wichteg ze bemierken datt d'Zuelen déi Dir um Lëschttag benotzt den Ausgang HTML net beaflossen. Déi resultéierend HTML Markup fir déi uewe genannte Lëscht wier:

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

Wann Är Lëscht Markup geschriwwe gëtt wéi:

1.  Bird
1.  McHale
1.  Parish

oder souguer:

3. Bird
1. McHale
8. Parish

Dir kritt allebéid genau déiselwecht HTML-Output.De Punkt ass, Dir kënnt d'Lëschtnummeren an der Markdown-Datei d'selwecht maachen wéi d'Ausgabresultater, oder wann Dir faul sidd, musst Dir guer net ëm d'Korrektheet vun den Zuelen këmmeren.

Wann Dir faul Schreifweis benotzt, ass et recommandéiert mat 1. fir den éischten Artikel unzefänken, well Markdown d'Startattribut vun bestallte Lëschten an Zukunft ënnerstëtzen kann.

D'Lëscht Element Tag ass normalerweis op der lénker Säit plazéiert, awer et kann indentéiert ginn, bis zu 3 Plazen, an den Element Tag muss op d'mannst ee Raum oder Tab gefollegt ginn.

Fir d'Lëscht méi schéin ze maachen, kënnt Dir d'Inhalter mat engem fixen Abriecher organiséieren:

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

Awer wann Dir faul sidd, ass dat och gutt:

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

Wann d'Lëscht Elementer duerch eidel Zeilen getrennt sinn, benotzt Markdown den Artikelinhalt beim Ausgab vun HTML. <p> Etiketten ginn gewéckelt, zum Beispill:

*   Bird
*   Magic

wäert ëmgewandelt ginn op:

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

Awer dëst:

*   Bird

*   Magic

wäert ëmgewandelt ginn op:

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

Lëscht Elementer kënnen e puer Abschnitter enthalen, an d'Paragrafen ënner all Element musse mat 4 Plazen oder 1 Tab agezeechent ginn:

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.

Et gesäit vill besser aus wann Dir all Zeil dréckt, natierlech nach eng Kéier, wann Dir faul sidd, erlaabt Markdown och:

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

Wann Dir eng Referenz an engem Lëschtepunkt wëllt setzen, dann > Et muss gedréckt ginn:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Wann Dir e Codeblock wëllt setzen, muss de Block agedréckt ginnzweemol, dat ass 8 Plazen oder 2 Tabs:

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

        <代码写在这>

Natierlech kann eng Lëscht vun Artikelen zoufälleg generéiert ginn, sou eppes:

1986. What a great season.

An anere Wierder, et schéngt um Ufank vun der LinnZuel-Period-Leer, Fir dëst ze vermeiden, kënnt Dir e Réckschlag virun der Period addéieren.

1986\. What a great season.

Code Block

Programm-verbonne Schreiwen oder Tag-Sprooch Quellcode huet normalerweis scho typesch Codeblocken. Normalerweis wëlle mir net datt dës Blocks op de Wee vun allgemenge Paragraphe-Dateien gesat ginn, awer weisen se wéi se sinn. Markdown wäert benotzen <pre> an <code> Tags fir Codeblocken ze wéckelen.

Bausteng vum Code am Markdown ass sou einfach wéi 4 Plazen oder 1 Tab z'entdecken, zum Beispill gitt déi folgend:

这是一个普通段落：

    这是一个代码区块。

Markdown konvertéiert op:

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

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

Dës éischt Uerdnung Indentatioun pro Zeil (4 Plazen oder 1 Tab) gëtt geläscht, zum Beispill:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

wäert ëmgewandelt ginn op:

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

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

E Block vu Code geet weider bis déi onindented Linn (oder Enn vum Fichier).

Am Code Block, & , < an > Et gëtt automatesch an HTML Entitéiten ëmgewandelt.Dës Method mécht et ganz einfach fir Iech Markdown ze benotzen fir den HTML Quellcode fir d'Beispill anzeginn, just kopéiert a paste et, füügt Indentatioun derbäi, an de Rescht handhabt de Markdown et fir Iech, fir Beispill:

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

wäert ëmgewandelt ginn op:

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

Am Codeblock gëtt d'allgemeng Markdown-Syntax net ëmgewandelt, sou wéi d'Asterisken nëmmen d'Asterisken sinn, dat heescht datt Dir einfach Markdown-Syntax-relatéiert Dateien an der Markdown-Syntax schreiwen kann.

deeler

Dir kënnt méi wéi dräi Asterisken benotzen, Minus Schëlder, ënnersträichen engem Trennung an enger Linn ze schafen, näischt anescht an der Linn.Dir kënnt och Plazen tëscht Asterisken oder Minuszeeche setzen.Trennungslinne kënnen op jiddereng vun de folgende Schreifweis erstallt ginn:

* * *

***

*****

- - -

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

Sektioun Element

Link

Markdown ënnerstëtzt zwou Forme vu Link Syntax: An der SchlaanganReferenzzwou Formen.

Egal wéi, Linktext ass markéiert mat [Klammern].

eng ze kreéierenAn der SchlaangWann Dir den Titeltext vum Link wëllt addéieren, wéckelt just den Titeltext mat duebelen Zitatzeechen no der URL, zum Beispill:

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

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

wäert produzéieren:

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

Wann Dir mat Ressourcen um selwechte Host verlinkt, kënnt Dir relativ Weeër benotzen:

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

ReferenzDe Link ass gefollegt vun engem anere véiereckege Klammer no der Klammer vum Linktext, an d'Mark, déi benotzt gëtt fir de Link z'identifizéieren, soll an der zweeter Quadrat Klammer gefëllt ginn:

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

Dir kënnt och optional e Raum tëscht den zwee Quadratklammern setzen:

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

Dann, iwwerall an der Datei, kënnt Dir de Link Inhalt vun dësem Tag definéieren:

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

Link Inhalt ass an der Form definéiert:

• Quadratklammern (optional viru bis zu dräi Plazen fir d'Abréckung) an déi de Linktext aginn ass
• gefollegt vun engem Colon
• gefollegt vun een oder méi Plazen oder Tabs
• d'URL vum nächste Link
• Optional befollegt den Titelinhalt, deen an eenzel Zitater, Duebelzitater oder Klammeren zougemaach ka ginn

D'Definitioune vun den folgenden dräi Linken sinn déiselwecht:

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

opgepasst:Et gëtt e bekannte Problem wou Markdown.pl 1.0.1 Linktitelen ignoréiert, déi an eenzel Zitater ageschloss sinn.

Link URLen kënnen och an Wénkel Klammeren zougemaach ginn:

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

Dir kënnt och den Titel Attribut op déi nächst Zeil setzen, oder e puer Indentatioun addéieren, wat besser ausgesäit wann d'URL ze laang ass:

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

D'URL Definitioun gëtt nëmme benotzt wann Dir de Link generéiert, a schéngt net direkt an der Datei.

Link Identifikatiounstags kënnen Buschtawen, Zuelen, Wäissraum a Punktuatioun enthalen, awer netNetEt ass Fall sensibel, sou datt déi folgend zwee Linken d'selwecht sinn:

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

Implizit Link TagFeature erlaabt Iech e Link-Tag ze spezifizéieren. An dësem Fall gëtt de Link-Tag als gläichwäerteg mam Link-Text behandelt. Fir en implizit Link-Tag ze benotzen, füügt just eng eidel Quadratklammer nom Linktext un. Wann Dir wëllt "Google "Verlinkt op google.com, Dir kënnt vereinfachen op:

[Google][]

Dann definéiert de Link Inhalt:

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

Zënter Linktext kann Whitespace enthalen, kann dës vereinfacht Markup verschidde Wierder enthalen:

Visit [Daring Fireball][] for more information.

Da gitt weider fir de Link ze definéieren:

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

D'Definitioun vum Link kann iwwerall an der Datei gesat ginn, ech setzen se léiwer direkt nom Paragraf wou de Link erschéngt. Dir kënnt et och um Enn vum Fichier setzen, grad wéi e Kommentar.

Hei ass e Beispill vun engem Referenzlink:

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"

Wann Dir et ännert fir de Linknumm ze benotzen fir ze schreiwen:

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"

Déi uewe genannte Schreifweis produzéieren déi folgend 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>

Drënner ass eng Markdown-Datei vum selwechten Inhalt geschriwwen inline, virgesinn fir de Verglach:

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

Tatsächlech ass de Punkt vu Referenzstil Linken net datt et méi einfach ass ze schreiwen, mee datt et méi einfach ass ze liesen.Vergläicht dat hei uewen Beispill.De Referenzstil Artikel selwer ass nëmmen 81 Zeechen, awer d'Inline Form wäert eropgoen 176 Zeechen., wann et am pure HTML-Format geschriwwe gëtt, ginn et 234 Zeechen. Am HTML-Format ginn et méi Tags wéi Text.

Mat Markdown's Referenzstil Linken, kënnt Dir d'Dokument méi wéi d'Finale Resultat vum Browser maachen, wat Iech erlaabt e puer Markup-relatéierte Metadaten ausserhalb vum Paragraftext ze réckelen, an Dir kënnt Links derbäisetzen ouni d'Liesgefill vum Artikel ze maachen. .

Betount

Markdown benotzt Asterisken (*) an déi ënnescht Linn (_) als Symbol fir en ënnersträicht Wuert ze markéieren, ass * Ëff _ Ëmginn Wierder ginn ëmgerechent <em> ëmgi vun Etiketten, mat zwee * Ëff _Wann et gewéckelt ass, gëtt et ëmgewandelt <strong>, z.B.:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

gëtt an:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Dir kënnt egal Stil benotzen Dir gären, déi eenzeg Beschränkung ass, datt Dir den Tag mat deem Symbol opzemaachen wëllt Dir et zu Enn wëllt.

Schwéierpunkt kann och direkt an der Mëtt vum Text agefouert ginn:

un*frigging*believable

awerwann Är * an _ Wann et whitespace op béide Säiten, si just als normal Symboler behandelt.

Fir normal Asterisken oder Ënnersträicher direkt virun an nom Text anzeginn, kënnt Dir Réckschnëtter benotzen:

\*this text is surrounded by literal asterisks\*

Code

Wann Dir e klengt Stéck Inline Code wëllt markéieren, kënnt Dir et an Backticks wéckelen (`), z.B.:

Use the `printf()` function.

wäert produzéieren:

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

Wann Dir Backticks an engem Code Sektioun wëllt setzen, kënnt Dir de Code Sektioun mat multiple Backticks starten an ophalen:

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

Dës Syntax produzéiert:

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

Dir kënnt eng eidel um Ufank an Enn vun engem Code Sektioun setzen, een nom Ufank an een virum Enn, sou datt Dir Backticks am Ufank vun der Rubrik asetzt:

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

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

wäert produzéieren:

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

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

An der Code Sektioun,& an Wénkel Klammeren都gëtt automatesch an HTML Entitéiten ëmgewandelt, wat et einfach mécht HTML Quellcode anzeginn, Markdown setzt de folgende Paragraf:

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

zu:

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

Dir kënnt och dëst schreiwen:

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

Fir ze produzéieren:

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

图片

Natierlech ass et schwéier eng "natierlech" Syntax ze designen fir Biller an enger Text-nëmmen Applikatioun ze setzen.

Markdown benotzt eng Syntax ähnlech wéi Links fir Biller ze markéieren, an erlaabt och zwee Stiler: An der SchlaanganReferenz.

D'Inline Bild Syntax gesäit aus wéi:

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

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

Detailer sinn wéi follegt:

• en Ausrufezeeche !
• gefollegt vun engem véiereckege Klammer mat Alt Text fir d'Bild
• Dëst ass gefollegt vun normalen Klammern mat der URL vum Bild, a schliisslech en optionalen 'Titel' Text mat Zitaten.

D'Referenzbildsyntax gesäit esou aus:

![Alt text][id]

"id" ass den Numm vun der Bildreferenz, déi op déiselwecht Manéier wéi eng Linkreferenz definéiert ass:

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

Bis elo huet Markdown kee Wee fir d'Breet an d'Héicht vum Bild ze spezifizéieren, wann Dir braucht, kënnt Dir déi normal benotzen <img> Etikett.

其它

Auto Link

Markdown ënnerstëtzt d'Veraarbechtung vun URLen an E-Mailen a Form vu kuerzen automatesche Linken. Soulaang se an de Wénkelklammern ageschloss sinn, konvertéiert Markdown se automatesch an e Link.De Linktext vun der allgemenger URL ass d'selwecht wéi d'Linkadress, zum Beispill:

<http://example.com/>

Markdown gëtt op:

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

D'automatesch Verknüpfung vun E-Mailadressen ass och ähnlech, ausser datt Markdown fir d'éischt e Kodéierungskonvertéierungsprozess ausféiert, Textzeechen an hexadezimal HTML-Entitéiten konvertéiert.

<[email protected]>

Markdown wäert an:

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

Am Browser ass dës String (tatsächlech <a href="mailto:[email protected]">[email protected]</a>) gëtt e klickbare "[email protected]" Link.

(Obwuel dës Approche vill Roboteren täuschen kann, kann se se net all stoppen, awer et ass besser wéi näischt. Op alle Fall, Är Mailbox opzemaachen wäert schlussendlech Werbebréiwer unzéien.)

Réckschlag

Markdown kann Réckschnëtter benotze fir Symboler anzeginn déi aner Bedeitungen an der Grammatik hunn, zum Beispill: wann Dir en Asterisk nieft dem Text wëllt addéieren fir ze betounen (awer net <em> Tag), kënnt Dir d'Asterisk mat engem Réckschnëtt virgoen:

\*literal asterisks\*

Markdown ënnerstëtzt déi folgend Symboler viraus vun engem Réckschnëtt fir ze hëllefen gemeinsam Symboler anzeginn:

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

Markdown fräi Redakter

Windows Plattform

• MarkdownPad
• MarkPad

Mac Plattform

• mëll

online Redakter

• MPE Editor

Browser Plugin

• Markdown hei Plugin

*** Wann et e bessere gratis Markdown Editor gëtt fir ze recommandéieren, gitt w.e.g. op de FeedbackChen Weiliang,merci!