Que veut dire Markdown ? Comment utiliser le balisage de syntaxe/formatage Markdown ?

MarkdownQue signifie ?

Comment utiliser le balisage de syntaxe/formatage Markdown ?

概述

Markdown est un langage de balisage léger créé par John Gruber.

Il permet aux utilisateurs "d'écrire des documents dans un format de texte brut facile à lire et à écrire, puis de les convertir en documents XHTML (ou HTML) valides".

Le langage intègre de nombreuses fonctionnalités de balisage de texte brut que l'on trouve déjà dans les e-mails.

John Gruber a créé le langage Markdown en 2004, en collaboration avec Aaron Swartz en grande partie sur la syntaxe.Le but du langage est d'utiliser "un format de texte brut facile à lire, facile à écrire et éventuellement converti en XHTML (ou HTML) valide".

but

L'objectif de Markdown est d'être "facile à lire et facile à écrire".

lisibilité, faites-le quand mêmeMarketing en ligne, l'expérience utilisateur est très importante.

Un fichier écrit en Markdown doit pouvoir être publié directement en texte brut et ne doit pas apparaître comme composé de nombreuses balises ou directives de formatage.

La syntaxe Markdown est influencée par certains formats de texte en HTML existants, notamment Setext, atx, Textile, reStructuredText, Grutatext et EtText, mais la plus grande source d'inspiration est le format de courrier électronique en texte brut.

En bref, la syntaxe de Markdown est entièrement composée de symboles, qui sont soigneusement sélectionnés et dont les fonctions sont claires en un coup d'œil.Par exemple : mettez des astérisques autour du texte pour le faire ressembler à *emphase*.

Les listes dans Markdown ressemblent à des listes. Les blocs de citations dans Markdown ressemblent vraiment à citer un morceau de texte, tout comme vous l'avez vu dans les e-mails.

Compatibilité HTML

Le but de la grammaire Markdown est d'être un langage d'écriture pour le web.

Markdown n'est pas destiné à remplacer HTML, ni même à s'en approcher, il a très peu de types de syntaxe et ne correspond qu'à un petit sous-ensemble de balisage HTML. Markdown n'a pas été conçu pour rendre les documents HTML plus faciles à écrire.

À mon avis, HTML est déjà facile à écrire. L'idée de Markdown est de rendre les documents plus faciles à lire, à écrire et à modifier à volonté. HTML est un format de publication, Markdown est unRédactionforme écrite.En tant que telle, la syntaxe de formatage de Markdown ne couvre que ce que le texte brut peut faire.

Les balises qui ne sont pas couvertes par Markdown peuvent être écrites en HTML directement dans le documentPromotion Webcopie.Il n'est pas nécessaire de marquer ceci comme HTML ou Markdown ; ajoutez simplement le balisage directement.

Seuls certains éléments de bloc HTML sont restreints - tels que <div>,<table>,<pre>,<p> et d'autres balises, elles doivent être séparées des autres zones de contenu par des lignes vides avant et après, et leurs balises d'ouverture et de fermeture ne doivent pas être mises en retrait par des tabulations ou des espaces. Le générateur Markdown est suffisamment intelligent pour ne pas ajouter de balises de bloc HTML inutiles <p> étiquette.

L'exemple est le suivant, en ajoutant un tableau HTML au fichier Markdown :

这是一个普通段落。

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

这是另一个普通段落。

Notez que la syntaxe de formatage Markdown entre les balises de bloc HTML ne sera pas traitée.Par exemple, si vous utilisez un style Markdown dans un bloc HTML*强调*n'aura aucun effet.

Balises de section HTML (inline) telles que <span>,<cite>,<del> Peut être utilisé librement dans les paragraphes, les listes ou les en-têtes Markdown.Selon les habitudes personnelles, vous pouvez même utiliser des balises HTML pour formater sans utiliser le format Markdown.Exemple : Si vous préférez HTML <a> 或 <img> balises, qui peuvent être utilisées directement sans la syntaxe de lien ou de balise d'image fournie par Markdown.

Contrairement aux balises de bloc HTML, la syntaxe Markdown est valide entre les balises de section HTML.

Conversion automatique des caractères spéciaux

Dans les fichiers HTML, deux caractères nécessitent un traitement spécial : < et & . < les symboles sont utilisés pour les balises de début,& Les symboles sont utilisés pour marquer les entités HTML, si vous voulez juste afficher le prototype de ces caractères, vous devez utiliser le formulaire d'entité, comme < et &.

& Les caractères sont particulièrement pénibles pour les rédacteurs de documents Web, si vous allez taper "AT&T", vous devez écrire"AT&T".tandis que dans l'URL & Les caractères sont également convertis.Par exemple, vous souhaitez créer un lien vers :

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

Vous devez écrire la conversion d'URL comme :

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

à placer dans la balise de lien href dans les propriétés.Inutile de dire que c'est facile à ignorer, et probablement le plus grand nombre d'erreurs détectées par la validation des normes HTML.

Markdown vous permet d'écrire des caractères naturellement et s'occupe de ce qui doit être converti.si tu utilises & Un caractère fait partie d'une entité de caractère HTML, il est laissé tel quel, sinon il est converti en &;.

Ainsi, si vous souhaitez insérer un symbole de copyright dans le document ©, tu peux écrire:

©

Markdown le laissera intact.Et si vous écrivez :

AT&T

Markdown le convertira en :

AT&T

Une situation similaire se produit également dans < notation, puisque Markdown permet la compatibilité HTML, si vous mettez < Les symboles sont utilisés comme délimiteurs pour les balises HTML, et Markdown n'effectuera aucune conversion dessus, mais si vous écrivez :

4 < 5

Markdown le convertira en :

4 < 5

Cependant, il convient de noter que dans le cadre du code, qu'il soit en ligne ou en bloc, < et & les deux symbolesCertainementsont convertis en entités HTML, une fonctionnalité qui vous permet d'écrire facilement du code HTML dans Markdown (par opposition au HTML, où vous mettez tous les < et & Tous sont convertis en entités HTML, afin d'écrire du code HTML dans le fichier HTML. )

élément de bloc

Paragraphes et sauts de ligne

Un paragraphe Markdown se compose d'une ou plusieurs lignes de texte consécutives, précédées et suivies de plusieurs lignes vides (la définition d'une ligne vide est qu'elle apparaît vide à l'écran et est considérée comme une ligne vide. Par exemple, , si une ligne ne contient que des espaces et des tabulations, la ligne sera également traitée comme une ligne vide).Les paragraphes normaux ne doivent pas être en retrait avec des espaces ou des tabulations.

L'expression "se compose d'une ou plusieurs lignes de texte consécutives" implique en fait que Markdown autorise les retours à la ligne forcés (insertion de retours à la ligne) dans les paragraphes, une fonctionnalité différente de la plupart des autres formats de texte en HTML (y compris Movable Type "Convertir les sauts de ligne "), d'autres formats convertiront chaque saut de ligne en <br /> étiquette.

如果 你确实Vous voulez compter sur Markdown pour insérer <br /> Pour les étiquettes, appuyez sur deux espaces ou plus à l'emplacement d'insertion, puis appuyez sur Entrée.

En effet, il faut un peu plus de travail (espaces supplémentaires) pour générer <br /> , mais simplement "chaque saut de ligne est converti en <br />"La méthode n'est pas adaptée à Markdown, em à MarkdownaiLes blocs de citations de style L et les listes de plusieurs paragraphes sont non seulement plus utiles mais aussi plus faciles à lire lors de la composition avec des sauts de ligne.

标题

Markdown prend en charge deux syntaxes pour les en-têtes, de type Setext et de type atx.

Le formulaire de type Settext est le formulaire avec la ligne du bas, en utilisant = (titre le plus élevé) et - (Titres de second ordre), par exemple :

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

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

n'importe quel montant = et - peut être efficace.

La forme de type Atx insère 1 à 6 au début de la ligne # , correspondant aux rubriques 1 à 6, par exemple :

# 这是 H1

## 这是 H2

###### 这是 H6

Vous pouvez éventuellement "fermer" les en-têtes de type atx, ceci est purement esthétique, si vous vous sentez à l'aise de cette façon, vous pouvez l'ajouter à la fin de la ligne #, tandis que les fins de ligne # Le numéro ne doit pas nécessairement être le même que le début (le nombre de caractères dièse au début de la ligne détermine l'ordre du titre) :

# 这是 H1 #

## 这是 H2 ##

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

Citations en blocs Citations en blocs

Les blocs de citations de balisage Markdown sont utilisés de la même manière que ceux utilisés dans les e-mails > de citations.Si vous êtes familier avec les guillemets dans les courriers électroniques, vous savez comment créer un bloc de devis dans un fichier Markdown, qui donnerait l'impression que vous cassez les lignes vous-même, puis ajoutez > :

> 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 vous permet également d'être paresseux et d'ajouter uniquement la première ligne du paragraphe entier > :

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

Les références de blocs peuvent être imbriquées (par exemple : références dans des références) en ajoutant un nombre différent de > :

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

D'autres syntaxes Markdown peuvent également être utilisées dans les blocs entre guillemets, notamment les en-têtes, les listes, les blocs de code, etc. :

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

Tout éditeur de texte décent peut facilement créer des citations de type e-mail.Par exemple, dans BBEdit, vous pouvez sélectionner du texte, puis choisir dans le menuaugmenter la hiérarchie des citations.

Liste

Markdown prend en charge les listes ordonnées et non ordonnées.

Les listes non ordonnées utilisent des astérisques, des signes plus ou des signes moins comme marqueurs de liste :

*   Red
*   Green
*   Blue

Équivalent à:

+   Red
+   Green
+   Blue

Également équivalent à :

-   Red
-   Green
-   Blue

Les listes ordonnées utilisent des nombres suivis d'un point :

1.  Bird
2.  McHale
3.  Parish

Il est important de noter que les nombres que vous utilisez dans la balise de liste n'affectent pas le code HTML de sortie. Le balisage HTML résultant pour la liste ci-dessus serait :

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

Si le balisage de votre liste s'écrit :

1.  Bird
1.  McHale
1.  Parish

ou même:

3. Bird
1. McHale
8. Parish

Vous obtiendrez tous les deux exactement la même sortie HTML.Le fait est que vous pouvez faire en sorte que les numéros de liste dans le fichier Markdown soient identiques aux résultats de sortie, ou si vous êtes paresseux, vous n'avez pas du tout besoin de vous soucier de l'exactitude des numéros.

Si vous utilisez l'écriture paresseuse, il est recommandé de commencer par 1. pour le premier élément, car Markdown peut prendre en charge l'attribut start des listes ordonnées à l'avenir.

La balise d'élément de liste est généralement placée à l'extrême gauche, mais elle peut être en retrait, jusqu'à 3 espaces, et la balise d'élément doit être suivie d'au moins un espace ou une tabulation.

Pour rendre la liste plus agréable, vous pouvez organiser le contenu avec un retrait fixe :

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

Mais si vous êtes paresseux, c'est bien aussi :

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

Si les éléments de la liste sont séparés par des lignes vides, Markdown utilisera le contenu des éléments lors de la sortie HTML. <p> Les étiquettes sont emballées, par exemple :

*   Bird
*   Magic

sera converti en :

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

Mais ça:

*   Bird

*   Magic

sera converti en :

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

Les éléments de liste peuvent contenir plusieurs paragraphes, et les paragraphes sous chaque élément doivent être en retrait de 4 espaces ou d'une tabulation :

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.

Cela semble beaucoup mieux si vous indentez chaque ligne, bien sûr, encore une fois, si vous êtes paresseux, Markdown permet également :

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

Si vous voulez mettre une référence à l'intérieur d'un élément de liste, alors > Il doit être indenté :

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Si vous voulez mettre un bloc de code, le bloc doit être indentédeux fois, soit 8 espaces ou 2 tabulations :

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

        <代码写在这>

Bien sûr, une liste d'éléments pourrait être générée accidentellement, quelque chose comme ceci :

1986. What a great season.

En d'autres termes, il apparaît au début de la lignenombre-période-vide, pour éviter cela, vous pouvez ajouter une barre oblique inverse avant le point.

1986\. What a great season.

bloc de code

L'écriture liée au programme ou le code source du langage de balises ont généralement des blocs de code déjà composés. Habituellement, nous ne voulons pas que ces blocs soient composés à la manière des fichiers de paragraphe généraux, mais les affichent tels qu'ils sont. Markdown utilisera <pre> et <code> balises pour envelopper les blocs de code.

Construire des blocs de code dans Markdown est aussi simple que d'indenter 4 espaces ou 1 tabulation, par exemple, entrez ce qui suit :

这是一个普通段落：

    这是一个代码区块。

Markdown sera converti en :

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

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

Cette indentation de premier ordre par ligne (4 espaces ou 1 tabulation) est supprimée, par exemple :

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

sera converti en :

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

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

Un bloc de code continue jusqu'à la ligne non indentée (ou la fin du fichier).

À l'intérieur du bloc de code, & , < et > Il sera automatiquement converti en entités HTML. Cette méthode vous permet d'utiliser très facilement Markdown pour insérer le code source HTML de l'exemple, il vous suffit de le copier et de le coller, d'ajouter une indentation et le reste Markdown le gérera pour vous, pour Exemple:

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

sera converti en :

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

Dans le bloc de code, la syntaxe générale de Markdown ne sera pas convertie, par exemple les astérisques ne sont que des astérisques, ce qui signifie que vous pouvez facilement écrire des fichiers liés à la syntaxe Markdown dans la syntaxe Markdown.

diviseur

Vous pouvez créer un séparateur avec plus de trois astérisques, des signes moins, des traits de soulignement sur une ligne, rien d'autre sur la ligne.Vous pouvez également insérer des espaces entre les astérisques ou les signes moins.Les lignes de séparation peuvent être créées dans chacune des manières d'écrire suivantes :

* * *

***

*****

- - -

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

élément de coupe

链接

Markdown prend en charge deux formes de syntaxe de lien : En ligneetRéférencedeux formes.

Dans tous les cas, le texte du lien est marqué de [crochets].

créer unEn ligneSi vous souhaitez ajouter le texte du titre du lien, placez simplement le texte du titre entre guillemets doubles après l'URL, par exemple :

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

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

Produira:

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

Si vous créez un lien vers des ressources sur le même hôte, vous pouvez utiliser des chemins relatifs :

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

RéférenceLe lien est suivi d'un autre crochet après le crochet du texte du lien, et la marque utilisée pour identifier le lien doit être remplie dans le deuxième crochet :

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

Vous pouvez aussi éventuellement mettre un espace entre les deux crochets :

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

Ensuite, n'importe où dans le fichier, vous pouvez définir le contenu du lien de cette balise :

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

Le contenu du lien est défini sous la forme :

• Crochets (éventuellement précédés de trois espaces maximum pour l'indentation) dans lesquels le texte du lien est saisi
• suivi d'un deux-points
• suivi d'un ou plusieurs espaces ou tabulations
• l'URL du lien suivant
• Suivez éventuellement le contenu du titre, qui peut être entouré de guillemets simples, de guillemets doubles ou de parenthèses

Les définitions des trois liens suivants sont les mêmes :

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

请 注意:Il existe un problème connu où Markdown.pl 1.0.1 ignore les titres de liens entre guillemets simples.

Les URL de lien peuvent également être placées entre crochets :

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

Vous pouvez également mettre l'attribut title sur la ligne suivante, ou ajouter une indentation, ce qui sera mieux si l'URL est trop longue :

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

La définition de l'URL n'est utilisée que lors de la génération du lien et n'apparaît pas directement dans le fichier.

Les balises d'identification de lien peuvent contenir des lettres, des chiffres, des espaces et des signes de ponctuation, mais pas不Il est sensible à la casse, donc les deux liens suivants sont identiques :

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

Balise de lien implicitevous permet d'omettre de spécifier une balise de lien. Dans ce cas, la balise de lien sera traitée comme équivalente au texte du lien. Pour utiliser une balise de lien implicite, ajoutez simplement un crochet vide après le texte du lien. Si vous souhaitez que "Google " En créant un lien vers google.com, vous pouvez simplifier :

[Google][]

Définissez ensuite le contenu du lien :

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

Étant donné que le texte du lien peut contenir des espaces, ce balisage simplifié peut contenir plusieurs mots :

Visit [Daring Fireball][] for more information.

Passez ensuite à la définition du lien :

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

La définition du lien peut être placée n'importe où dans le fichier. Je préfère la mettre directement après le paragraphe où apparaît le lien. Vous pouvez aussi la mettre à la fin du fichier, comme un commentaire.

Voici un exemple de lien de référence :

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"

Si vous le modifiez pour utiliser le nom du lien pour écrire :

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"

Les deux façons d'écrire ci-dessus produiront le code HTML suivant.

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

Vous trouverez ci-dessous un fichier Markdown du même contenu écrit en ligne, fourni à titre de comparaison :

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

En fait, l'intérêt des liens de style référence n'est pas qu'ils soient plus faciles à écrire, mais qu'ils soient plus faciles à lire. Comparez l'exemple ci-dessus. L'article de style référence lui-même ne comporte que 81 caractères, mais le formulaire en ligne passera à 176 caractères. , s'il est écrit au format HTML pur, il y aura 234 caractères. Au format HTML, il y a plus de balises que de texte.

En utilisant les liens de style référence de Markdown, vous pouvez faire en sorte que le document ressemble davantage au résultat final du navigateur, vous permettant de déplacer certaines métadonnées liées au balisage en dehors du texte du paragraphe, et vous pouvez ajouter des liens sans donner l'impression de lecture de l'article. .

强调

Markdown utilise des astérisques (*) et la ligne du bas (_) comme symbole pour marquer un mot souligné, est * 或 _ Les mots entourés sont convertis en <em> entouré d'étiquettes, avec deux * 或 _S'il est emballé, il sera converti en <strong>,Par exemple:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

se transformera en :

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Vous pouvez utiliser le style de votre choix, la seule limitation est que vous pouvez utiliser le symbole pour ouvrir la balise et le symbole pour la terminer.

L'emphase peut également être insérée directement au milieu du texte :

un*frigging*believable

maissi votre * et _ S'il y a des espaces des deux côtés, ils sont simplement traités comme des symboles normaux.

Pour insérer des astérisques normaux ou des traits de soulignement directement avant et après le texte, vous pouvez utiliser des barres obliques inverses :

\*this text is surrounded by literal asterisks\*

Code

Si vous souhaitez marquer un petit morceau de code en ligne, vous pouvez l'envelopper de backticks (`),Par exemple:

Use the `printf()` function.

Produira:

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

Si vous souhaitez insérer des backticks dans une section de code, vous pouvez commencer et terminer la section de code avec plusieurs backticks :

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

Cette syntaxe produit :

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

Vous pouvez mettre un blanc au début et à la fin d'une section de code, un après le début et un avant la fin, afin de pouvoir insérer des backticks au début de la section :

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

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

Produira:

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

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

Dans la section code,& et équerres都seront automatiquement convertis en entités HTML, ce qui facilite l'insertion du code source HTML, Markdown mettra le paragraphe suivant :

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

à:

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

Vous pouvez aussi écrire ceci :

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

Produire:

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

图片

Évidemment, il est difficile de concevoir une syntaxe "naturelle" pour insérer des images dans une application textuelle.

Markdown utilise une syntaxe similaire à celle des liens pour baliser les images, et autorise également deux styles : En ligneetRéférence.

La syntaxe de l'image en ligne ressemble à :

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

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

Les détails sont les suivants:

• un point d'exclamation !
• suivi d'un crochet avec un texte alternatif pour l'image
• Ceci est suivi de parenthèses normales avec l'URL de l'image, et enfin d'un texte 'titre' facultatif entre guillemets.

La syntaxe de l'image de référence ressemble à ceci :

![Alt text][id]

"id" est le nom de la référence d'image, qui est défini de la même manière qu'une référence de lien :

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

Jusqu'à présent, Markdown n'a aucun moyen de spécifier la largeur et la hauteur de l'image, si vous en avez besoin, vous pouvez utiliser la normale <img> étiquette.

其它

lien automatique

Markdown prend en charge le traitement des URL et des e-mails sous la forme de liens automatiques courts. Tant qu'ils sont entre crochets, Markdown les convertira automatiquement en lien.Le texte du lien de l'URL générale est identique à l'adresse du lien, par exemple :

<http://example.com/>

Markdown sera converti en :

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

La liaison automatique des adresses e-mail est également très similaire, sauf que Markdown effectuera d'abord un processus de conversion d'encodage, convertissant les caractères du texte en entités HTML hexadécimales.Ce format peut tromper certains robots de collecte d'adresses e-mail malveillants, tels que :

<[email protected]>

Markdown se transformera en :

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

Dans le navigateur, cette chaîne (en fait <a href="mailto:[email protected]">[email protected]</a>) devient un lien "[email protected]" cliquable.

(Bien que cette approche puisse tromper beaucoup de robots, elle ne peut pas tous les arrêter, mais c'est mieux que rien. Dans tous les cas, ouvrir votre boîte aux lettres finira par attirer des lettres publicitaires.)

barre oblique inverse

Markdown peut utiliser des barres obliques inverses pour insérer des symboles qui ont d'autres significations dans la grammaire, par exemple : si vous souhaitez ajouter un astérisque à côté du texte pour le mettre en évidence (mais pas <em> tag), vous pouvez faire précéder l'astérisque d'une barre oblique inverse :

\*literal asterisks\*

Markdown prend en charge les symboles suivants précédés d'une barre oblique inverse pour faciliter l'insertion de symboles courants :

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

Éditeur gratuit Markdown

Plate-forme Windows

• Bloc de démarques
• MarkPad

Plate-forme Mac

• Mou

éditeur en ligne

• Éditeur MP

plug-in de navigateur

• Plugin Markdown ici

*** S'il existe un meilleur éditeur Markdown gratuit à recommander, veuillez prêter attention aux commentairesChen Weiliang,Merci!