Was bedeutet Markdown? Wie verwende ich Markdown-Syntax/Formatierungs-Markup?

MarkdownWas bedeutet?

Wie verwende ich Markdown-Syntax/Formatierungs-Markup?

概述

Markdown ist eine leichtgewichtige Auszeichnungssprache, die von John Gruber entwickelt wurde.

Es erlaubt Menschen, "Dokumente im einfachen Textformat zu schreiben, die leicht zu lesen und zu schreiben sind, und sie dann in gültige XHTML- (oder HTML-) Dokumente umzuwandeln".

Die Sprache hat viele der Funktionen von Klartext-Markup übernommen, die bereits in E-Mails zu finden sind.

John Gruber hat die Markdown-Sprache im Jahr 2004 in Zusammenarbeit mit Aaron Swartz zum großen Teil an der Syntax erstellt.Der Zweck der Sprache besteht darin, "ein einfaches Textformat zu verwenden, das leicht zu lesen und zu schreiben ist und optional in gültiges XHTML (oder HTML) konvertiert werden kann".

Zweck

Das Ziel von Markdown ist es, „leicht zu lesen und einfach zu schreiben“ zu sein.

Lesbarkeit, tun Sie es trotzdem网络 网络, die Benutzererfahrung ist sehr wichtig.

Ein in Markdown geschriebenes Dokument sollte direkt im Klartext veröffentlicht werden können und nicht den Anschein erwecken, aus vielen Tags oder Formatierungsanweisungen zusammengesetzt zu sein.

Die Markdown-Syntax wird von einigen bestehenden Text-zu-HTML-Formaten beeinflusst, darunter Setext, atx, Textile, reStructuredText, Grutatext und EtText, aber die größte Inspirationsquelle ist das reine Text-E-Mail-Format.

Kurz gesagt, die Syntax von Markdown besteht ausschließlich aus Symbolen, die sorgfältig ausgewählt wurden und deren Funktionen auf einen Blick klar sind.Zum Beispiel: Setzen Sie Sternchen um den Text, damit er wie *Hervorhebung* aussieht.

Listen in Markdown sehen aus wie Listen. Blockzitate in Markdown sehen wirklich so aus, als würden Sie einen Text zitieren, genau wie Sie es in E-Mails gesehen haben.

Kompatibel mit HTML

Das Ziel der Markdown-Grammatik ist es, eine Schreibsprache für das Web zu sein.

Markdown soll HTML nicht ersetzen oder ihm auch nur nahe kommen, es hat nur sehr wenige Syntaxvariationen und entspricht nur einer kleinen Teilmenge von HTML-Markup. Markdown wurde nicht konzipiert, um das Schreiben von HTML-Dokumenten zu vereinfachen.

Meiner Meinung nach ist HTML bereits einfach zu schreiben. Die Idee von Markdown ist es, Dokumente leichter lesbar, schreibbar und beliebig änderbar zu machen. HTML ist ein Veröffentlichungsformat, Markdown ist einWerbetextengeschriebenes Format.Daher deckt die Formatierungssyntax von Markdown nur das ab, was Klartext kann.

Tags, die nicht von Markdown abgedeckt werden, können in HTML direkt in das Dokument geschrieben werdenWeb-PromotionKopieren.Es ist nicht erforderlich, dies als HTML oder Markdown zu markieren; fügen Sie das Markup einfach direkt hinzu.

Es müssen nur einige HTML-Blockelemente eingeschränkt werden - wie z <div>,<table>,<pre>,<p> und andere Tags, müssen sie von anderen Inhaltsbereichen durch Leerzeilen davor und danach getrennt werden, und ihre öffnenden und schließenden Tags dürfen nicht durch Tabulatoren oder Leerzeichen eingerückt werden. Der Markdown-Generator ist intelligent genug, um keine unnötigen HTML-Block-Tags hinzuzufügen <p> Etikette.

Das Beispiel sieht wie folgt aus und fügt der Markdown-Datei eine HTML-Tabelle hinzu:

这是一个普通段落。

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

这是另一个普通段落。

Beachten Sie, dass die Markdown-Formatierungssyntax zwischen HTML-Block-Tags nicht verarbeitet wird.Zum Beispiel, wenn Sie einen Markdown-Stil innerhalb eines HTML-Blocks verwenden*强调*wird keine Wirkung haben.

HTML-Abschnitt (Inline)-Tags wie z <span>,<cite>,<del> Kann frei in Markdown-Absätzen, Listen oder Überschriften verwendet werden.Je nach persönlichen Gewohnheiten können Sie sogar HTML-Tags zum Formatieren verwenden, ohne das Markdown-Format zu verwenden.Beispiel: Wenn Sie HTML bevorzugen <a> 或 <img> -Tags, die direkt ohne die von Markdown bereitgestellte Link- oder Bild-Tag-Syntax verwendet werden können.

Anders als zwischen HTML-Block-Tags ist die Markdown-Syntax zwischen HTML-Abschnitts-Tags gültig.

Automatische Konvertierung von Sonderzeichen

In HTML-Dateien gibt es zwei Zeichen, die eine besondere Behandlung erfordern: < 和 & . < Symbole werden für Start-Tags verwendet,& Symbole werden verwendet, um HTML-Entitäten zu markieren. Wenn Sie nur den Prototyp dieser Zeichen anzeigen möchten, müssen Sie das Entitätsformular verwenden, z < 和 &.

& Zeichen sind für Autoren von Webdokumenten besonders quälend, wenn Sie "AT&T"Sie müssen schreiben"AT&T".während in der URL & Zeichen werden ebenfalls konvertiert.Zum Beispiel möchten Sie verlinken auf:

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

Sie müssen die URL-Konvertierung wie folgt schreiben:

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

im Link-Tag platziert werden href bei Eigenschaften.Unnötig zu erwähnen, dass dies leicht zu ignorieren ist und wahrscheinlich die größte Anzahl von Fehlern aufweist, die von der HTML-Standardvalidierung erkannt werden.

Markdown ermöglicht es Ihnen, Zeichen auf natürliche Weise zu schreiben, und kümmert sich um das, was konvertiert werden muss.wenn du benutzt & Ein Zeichen ist Teil einer HTML-Zeichenentität, es bleibt unverändert, ansonsten wird es umgewandelt &;.

Wenn Sie also ein Copyright-Symbol in das Dokument einfügen möchten ©, Du kannst schreiben:

©

Markdown lässt es unberührt.Und wenn du schreibst:

AT&T

Markdown konvertiert es in:

AT&T

Eine ähnliche Situation tritt auch in auf < Notation, da Markdown HTML-Kompatibilität ermöglicht, wenn Sie setzen < Symbole werden als Trennzeichen für HTML-Tags verwendet, und Markdown führt keine Konvertierungen an ihnen durch, aber wenn Sie schreiben:

4 < 5

Markdown konvertiert es in:

4 < 5

Es sollte jedoch beachtet werden, dass im Bereich des Codes, ob Inline oder Block, < 和 & beide SymboleAuf jeden Fallwerden in HTML-Entitäten konvertiert, eine Funktion, mit der Sie HTML-Code einfach in Markdown schreiben können (im Gegensatz zu HTML, wo Sie alle < 和 & Alle werden in HTML-Entitäten umgewandelt, um HTML-Code in die HTML-Datei zu schreiben. )

Blockelement

Absätze und Zeilenumbrüche

Ein Markdown-Absatz besteht aus einer oder mehreren aufeinanderfolgenden Textzeilen, denen mehr als eine Leerzeile vorangeht und folgt (die Definition einer Leerzeile ist, dass sie auf dem Display leer zu sein scheint und als Leerzeile betrachtet wird. Beispiel: , wenn eine Zeile nur Leerzeichen und Tabulatoren enthält, wird die Zeile auch als Leerzeile behandelt).Normale Absätze sollten nicht mit Leerzeichen oder Tabulatoren eingerückt werden.

Der Ausdruck „besteht aus einer oder mehreren aufeinanderfolgenden Textzeilen“ impliziert eigentlich, dass Markdown erzwungene Zeilenumbrüche (Einfügen von Zeilenumbrüchen) innerhalb von Absätzen zulässt, eine Funktion, die sich von den meisten anderen Text-zu-HTML-Formaten unterscheidet (einschließlich Movable Type „Convert Line Breaks"-Option), andere Formate konvertieren jeden Zeilenumbruch in <br /> Etikette.

如果 如果确实Sie möchten sich beim Einfügen auf Markdown verlassen <br /> Drücken Sie für Beschriftungen zwei oder mehr Leerzeichen an der Einfügestelle und drücken Sie dann die Eingabetaste.

Tatsächlich erfordert die Generierung etwas mehr Arbeit (zusätzliche Leerzeichen). <br /> , sondern einfach "jeder Zeilenumbruch wird umgewandelt in <br />"Die Methode ist nicht geeignet in Markdown, em in MarkdownaiBlockzitate im L-Stil und Listen mit mehreren Absätzen sind nicht nur nützlicher, sondern auch besser lesbar, wenn Sie mit Zeilenumbrüchen setzen.

Titel

Markdown unterstützt zwei Syntaxen für Überschriften, Setext-like und ATX-like.

Das Settext-ähnliche Formular ist das Formular mit der unteren Zeile, using = (höchster Titel) und - (Überschriften zweiter Ordnung), zum Beispiel:

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

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

jeder Betrag = 和 - kann wirksam sein.

Das Atx-ähnliche Formular fügt 1 bis 6 am Anfang der Zeile ein # , entsprechend den Rubriken 1 bis 6, zum Beispiel:

# 这是 H1

## 这是 H2

###### 这是 H6

Sie können optional ATX-ähnliche Header "schließen", dies dient lediglich der Ästhetik. Wenn Sie sich auf diese Weise wohl fühlen, können Sie sie am Ende der Zeile hinzufügen #, während die Zeile endet # Die Nummer muss nicht gleich dem Anfang sein (die Anzahl der Rautenzeichen am Zeilenanfang bestimmt die Reihenfolge des Titels):

# 这是 H1 #

## 这是 H2 ##

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

Blockzitate Blockzitate

Markdown-Markup-Blockquotes werden ähnlich wie in E-Mails verwendet > von Zitaten.Wenn Sie mit Anführungszeichen in E-Mail-Briefen vertraut sind, wissen Sie, wie Sie in einer Markdown-Datei ein Blockzitat erstellen, das so aussieht, als ob Sie die Zeilen selbst umbrechen und dann hinzufü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.

Mit Markdown können Sie auch faul sein und nur die erste Zeile des gesamten Absatzes hinzufü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.

Blockreferenzen können verschachtelt werden (z. B.: Referenzen innerhalb von Referenzen), indem eine unterschiedliche Anzahl von hinzugefügt wird > :

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

Andere Markdown-Syntaxen können auch innerhalb von Blöcken in Anführungszeichen verwendet werden, einschließlich Überschriften, Listen, Codeblöcken usw.:

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

Jeder anständige Texteditor kann leicht Zitate im E-Mail-Stil erstellen.Beispielsweise können Sie in BBEdit Text auswählen und dann aus dem Menü auswählenZitierhierarchie erhöhen.

Liste

Markdown unterstützt sowohl geordnete als auch ungeordnete Listen.

Ungeordnete Listen verwenden Sternchen, Pluszeichen oder Minuszeichen als Listenmarkierungen:

*   Red
*   Green
*   Blue

Gleichwertig:

+   Red
+   Green
+   Blue

Auch äquivalent zu:

-   Red
-   Green
-   Blue

Geordnete Listen verwenden Zahlen gefolgt von einem Punkt:

1.  Bird
2.  McHale
3.  Parish

Es ist wichtig zu beachten, dass die Zahlen, die Sie im Listen-Tag verwenden, keinen Einfluss auf den ausgegebenen HTML-Code haben. Das resultierende HTML-Markup für die obige Liste wäre:

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

Wenn Ihr Listen-Markup wie folgt geschrieben ist:

1.  Bird
1.  McHale
1.  Parish

oder auch:

3. Bird
1. McHale
8. Parish

Sie erhalten beide genau die gleiche HTML-Ausgabe.Der Punkt ist, dass Sie die Listennummern in der Markdown-Datei mit den Ausgabeergebnissen identisch machen können, oder wenn Sie faul sind, müssen Sie sich überhaupt nicht um die Korrektheit der Zahlen kümmern.

Wenn Sie Lazy Writing verwenden, empfiehlt es sich, beim ersten Element mit 1. zu beginnen, da Markdown möglicherweise in Zukunft das Startattribut von geordneten Listen unterstützt.

Das Listenelement-Tag wird normalerweise ganz links platziert, kann jedoch um bis zu 3 Leerzeichen eingerückt werden, und auf das Element-Tag muss mindestens ein Leerzeichen oder ein Tabulator folgen.

Um die Liste schöner aussehen zu lassen, können Sie den Inhalt mit einem festen Einzug organisieren:

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

Aber wenn Sie faul sind, ist das auch in Ordnung:

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

Wenn die Listenelemente durch Leerzeilen getrennt sind, verwendet Markdown den Elementinhalt bei der HTML-Ausgabe. <p> Etiketten werden zum Beispiel gewickelt:

*   Bird
*   Magic

würde umgewandelt werden in:

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

Aber dieses:

*   Bird

*   Magic

würde umgewandelt werden in:

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

Listenelemente können mehrere Absätze enthalten, und die Absätze unter jedem Element müssen um 4 Leerzeichen oder 1 Tabulator eingerückt sein:

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.

Es sieht viel besser aus, wenn Sie jede Zeile natürlich wieder einrücken, wenn Sie faul sind, Markdown erlaubt auch:

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

Wenn Sie eine Referenz in ein Listenelement einfügen möchten, dann > Es muss eingerückt werden:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Wenn Sie einen Codeblock einfügen möchten, muss der Block eingerückt werdenzweimal, also 8 Leerzeichen oder 2 Tabulatoren:

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

        <代码写在这>

Natürlich könnte versehentlich eine Liste von Elementen erstellt werden, etwa so:

1986. What a great season.

Mit anderen Worten, es erscheint am Anfang der ZeileNummer-Punkt-leer, um dies zu vermeiden, können Sie vor dem Punkt einen umgekehrten Schrägstrich einfügen.

1986\. What a great season.

Codeblock

Programmbezogene Schreib- oder Tag-Language-Quellcodes haben in der Regel bereits gesetzte Codeblöcke, die wir in der Regel nicht wie allgemeine Absatzdateien setzen wollen, sondern so darstellen, wie sie Markdown verwendet <pre> 和 <code> -Tags zum Umschließen von Codeblöcken.

Codebausteine ​​in Markdown sind so einfach wie das Einrücken von 4 Leerzeichen oder 1 Tabulator. Geben Sie beispielsweise Folgendes ein:

这是一个普通段落：

    这是一个代码区块。

Markdown wird umgewandelt in:

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

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

Dieser Einzug erster Ordnung pro Zeile (4 Leerzeichen oder 1 Tabulator) wird entfernt, zum Beispiel:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

würde umgewandelt werden in:

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

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

Ein Codeblock wird bis zur nicht eingerückten Zeile (oder dem Dateiende) fortgesetzt.

Innerhalb des Codeblocks, & , < 和 > Es wird automatisch in HTML-Entitäten konvertiert, was es Ihnen sehr einfach macht, Markdown zum Einfügen des HTML-Quellcodes für das Beispiel zu verwenden. Kopieren Sie ihn einfach und fügen Sie ihn ein, fügen Sie Einzüge hinzu, und der Rest von Markdown erledigt dies für Sie. zum Beispiel:

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

würde umgewandelt werden in:

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

Im Codeblock wird die allgemeine Markdown-Syntax nicht konvertiert, z. B. sind Sternchen nur Sternchen, was bedeutet, dass Sie Markdown-Syntax-bezogene Dateien problemlos in Markdown-Syntax schreiben können.

Trennlinie

Sie können mehr als drei Sternchen, Minuszeichen und Unterstriche in einer Zeile verwenden, um eine Trennlinie zu erstellen, sonst nichts in der Zeile.Sie können zwischen Sternchen oder Minuszeichen auch Leerzeichen einfügen.Jede der folgenden Notationen kann einen Teiler erstellen:

* * *

***

*****

- - -

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

Abschnittselement

Link

Markdown unterstützt zwei Formen der Link-Syntax: In der Reihe和Bezugzwei Formen.

In beiden Fällen wird der Linktext mit [eckigen Klammern] gekennzeichnet.

ein zu erstellenIn der ReiheWenn Sie den Titeltext des Links hinzufügen möchten, schließen Sie den Titeltext einfach in doppelte Anführungszeichen nach der URL ein, zum Beispiel:

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

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

Wird herstellen:

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

Wenn Sie auf Ressourcen auf demselben Host verlinken, können Sie relative Pfade verwenden:

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

BezugAuf den Link folgt nach der Klammer des Linktextes eine weitere eckige Klammer und in der zweiten eckigen Klammer ist das Kennzeichen zur Kennzeichnung des Links zu setzen:

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

Optional können Sie auch ein Leerzeichen zwischen die beiden eckigen Klammern setzen:

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

Dann können Sie an einer beliebigen Stelle in der Datei den Linkinhalt dieses Tags definieren:

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

Der Linkinhalt wird in der Form definiert:

• Eckige Klammern (wahlweise mit bis zu drei vorangestellten Leerzeichen zur Einrückung), in die der Linktext eingetragen wird
• gefolgt von einem Doppelpunkt
• gefolgt von einem oder mehreren Leerzeichen oder Tabulatoren
• die URL des nächsten Links
• Folgen Sie optional dem Titelinhalt, der in einfache Anführungszeichen, doppelte Anführungszeichen oder Klammern eingeschlossen werden kann

Die Definitionen der folgenden drei Links sind gleich:

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

请 注意 ：Es gibt ein bekanntes Problem, bei dem Markdown.pl 1.0.1 Linktitel in einfachen Anführungszeichen ignoriert.

Link-URLs können auch in spitze Klammern eingeschlossen werden:

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

Sie können das Titelattribut auch in die nächste Zeile setzen oder eine Einrückung hinzufügen, die besser aussieht, wenn die URL zu lang ist:

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

URL-Definitionen werden nur beim Generieren von Links verwendet und erscheinen nicht direkt in der Datei.

Link-Identifikations-Tags können Buchstaben, Zahlen, Leerzeichen und Satzzeichen enthalten, müssen es aber nicht不Es wird zwischen Groß- und Kleinschreibung unterschieden, daher sind die folgenden beiden Links identisch:

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

Implizites Link-TagMit dieser Funktion können Sie auf die Angabe eines Link-Tags verzichten. In diesem Fall wird das Link-Tag als Äquivalent zum Linktext behandelt. Um ein implizites Link-Tag zu verwenden, fügen Sie einfach eine leere eckige Klammer nach dem Linktext ein. Wenn Sie möchten, dass "Google " Durch die Verknüpfung mit google.com können Sie Folgendes vereinfachen:

[Google][]

Definieren Sie dann den Linkinhalt:

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

Da Linktext Leerzeichen enthalten kann, kann dieses vereinfachte Markup mehrere Wörter enthalten:

Visit [Daring Fireball][] for more information.

Fahren Sie dann fort, um den Link zu definieren:

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

Die Definition des Links kann an beliebiger Stelle in der Datei platziert werden, am liebsten direkt nach dem Absatz, in dem der Link erscheint, oder am Ende der Datei, genau wie ein Kommentar.

Hier ist ein Beispiel für einen 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"

Wenn Sie es ändern, um den Linknamen zu verwenden, um Folgendes zu schreiben:

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"

Die beiden obigen Schreibweisen erzeugen den folgenden HTML-Code.

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

Nachfolgend finden Sie eine Markdown-Datei mit demselben Inhalt, die inline geschrieben wurde und zum Vergleich bereitgestellt wird:

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ächlich ist der Sinn von Links im Referenzstil nicht, dass sie einfacher zu schreiben sind, sondern dass sie leichter zu lesen sind.Vergleichen Sie das obige Beispiel.Der Artikel im Referenzstil selbst hat nur 81 Zeichen, aber das Inline-Formular wird auf zunehmen 176 Zeichen. Wenn es im reinen HTML-Format geschrieben ist, sind es 234 Zeichen. Im HTML-Format gibt es mehr Tags als Text.

Die Verwendung von Links im Referenzstil von Markdown kann das Dokument dem Endergebnis des Browsers ähnlicher machen, sodass Sie einige Markup-bezogene Metadaten außerhalb des Absatztexts verschieben und Links hinzufügen können, ohne dass der Artikel gelesen wird.

强调

Markdown verwendet Sternchen (*) und die untere Zeile (_) als Symbol zur Kennzeichnung eines unterstrichenen Wortes, ist * 或 _ Umschlossene Wörter werden umgewandelt in <em> umgeben von Etiketten, mit zwei * 或 _Wenn es umschlossen ist, wird es umgewandelt in <strong>,Zum Beispiel:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

wird zu:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Sie können einen beliebigen Stil verwenden, die einzige Einschränkung besteht darin, dass Sie das Symbol zum Öffnen des Tags und das Symbol zum Beenden verwenden können.

Hervorhebungen können auch direkt mitten im Text eingefügt werden:

un*frigging*believable

aberwenn dein * 和 _ Wenn auf beiden Seiten Leerzeichen vorhanden sind, werden sie einfach wie normale Symbole behandelt.

Um normale Sternchen oder Unterstriche direkt vor und nach Text einzufügen, können Sie Backslashes verwenden:

\*this text is surrounded by literal asterisks\*

Code

Wenn Sie ein kleines Stück Inline-Code markieren möchten, können Sie es in Backticks (`),Zum Beispiel:

Use the `printf()` function.

Wird herstellen:

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

Wenn Sie Backticks in einen Codeabschnitt einfügen möchten, können Sie den Codeabschnitt mit mehreren Backticks beginnen und beenden:

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

Diese Syntax erzeugt:

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

Sie können am Anfang und am Ende eines Codeabschnitts ein Leerzeichen setzen, eines nach dem Anfang und eines vor dem Ende, sodass Sie am Anfang des Abschnitts Backticks einfügen können:

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

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

Wird herstellen:

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

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

Innerhalb des Codeabschnitts& und spitze Klammern都automatisch in HTML-Entities konvertiert werden, was das Einfügen von HTML-Quellcode erleichtert, Markdown fügt den folgenden Absatz ein:

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

zu:

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

Du kannst auch das schreiben:

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

Produzieren:

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

图片

Offensichtlich ist es schwierig, eine "natürliche" Syntax zum Einfügen von Bildern in eine Nur-Text-Anwendung zu entwerfen.

Markdown verwendet eine ähnliche Syntax wie Links, um Bilder zu markieren, und erlaubt außerdem zwei Stile: In der Reihe和Bezug.

Die Inline-Bildsyntax sieht folgendermaßen aus:

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

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

Die Details sind wie folgt:

• ein Ausrufezeichen !
• gefolgt von eckigen Klammern mit dem Alternativtext für das Bild
• Darauf folgen normale Klammern mit der URL des Bildes und schließlich ein optionaler „Titel“-Text, der in Anführungszeichen eingeschlossen ist.

Die Referenzbildsyntax sieht folgendermaßen aus:

![Alt text][id]

„id“ ist der Name des Bildverweises, der wie ein Linkverweis definiert ist:

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

Bisher hat Markdown keine Möglichkeit, die Breite und Höhe des Bildes anzugeben, bei Bedarf können Sie die normale verwenden <img> Etikette.

其它

Auto-Link

Markdown unterstützt die Verarbeitung von URLs und E-Mail-Postfächern in Form von relativ kurzen automatischen Links.Solange sie in spitze Klammern eingeschlossen sind, wandelt Markdown sie automatisch in einen Link um.Der Linktext der allgemeinen URL entspricht der Linkadresse, zum Beispiel:

<http://example.com/>

Markdown wird umgewandelt in:

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

Die automatische Verknüpfung von E-Mail-Adressen ist ebenfalls sehr ähnlich, außer dass Markdown zuerst einen Kodierungskonvertierungsprozess durchführt, bei dem Textzeichen in hexadezimale HTML-Einheiten konvertiert werden. Dieses Format kann einige Roboter zum Sammeln schlechter E-Mail-Adressen täuschen, wie zum Beispiel:

<[email protected]>

Markdown wird zu:

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

Im Browser wird diese Zeichenfolge (eigentlich <a href="mailto:[email protected]">[email protected]</a>) wird zu einem anklickbaren "[email protected]"-Link.

(Obwohl dieser Ansatz viele Roboter täuschen kann, kann er sie nicht alle aufhalten, aber es ist besser als nichts. In jedem Fall wird das Öffnen Ihres Briefkastens schließlich Werbebriefe anziehen.)

Backslash

Markdown kann Backslashes verwenden, um Symbole einzufügen, die andere Bedeutungen in der Grammatik haben, zum Beispiel: wenn Sie ein Sternchen neben dem Text zur Hervorhebung hinzufügen möchten (aber nicht <em> -Tag), können Sie dem Sternchen einen Backslash voranstellen:

\*literal asterisks\*

Markdown unterstützt die folgenden Symbole mit vorangestelltem Backslash, um das Einfügen gängiger Symbole zu erleichtern:

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

Markdown-freier Editor

Windows-Plattform

• MarkdownPad
• MarkPad

Mac-Plattform

• weich

Online-Editor

• MPEditor

Browser-Plugin

• Markdown-hier-Plugin

*** Wenn es einen besseren kostenlosen Markdown-Editor zu empfehlen gibt, achten Sie bitte auf FeedbackChen Weiliang,Vielen Dank!