Què significa Markdown? Com utilitzar el marcatge de sintaxi/format de Markdown?

MarkdownQuè significa?

Com utilitzar el marcatge de sintaxi/format de Markdown?

Visió general

Markdown és un llenguatge de marques lleuger creat per John Gruber.

Permet "escriure documents en un format de text senzill que sigui fàcil de llegir i escriure, i després convertir-los en documents XHTML (o HTML) vàlids".

El llenguatge incorpora moltes de les característiques de l'etiquetatge de text pla que ja es troben al correu electrònic.

John Gruber va crear el llenguatge Markdown el 2004, en col·laboració amb Aaron Swartz en gran part sobre la sintaxi.El propòsit del llenguatge és utilitzar "un format de text senzill que sigui fàcil de llegir, fàcil d'escriure i, opcionalment, es converteixi en XHTML (o HTML) vàlid".

propòsit

L'objectiu de Markdown és que sigui "fàcil de llegir i fàcil d'escriure".

llegibilitat, fes-ho igualMàrqueting a Internet, l'experiència de l'usuari és molt important.

Un fitxer escrit a Markdown s'hauria de poder publicar directament en text pla i no hauria de semblar que consta de moltes etiquetes o directives de format.

La sintaxi de Markdown està influenciada per alguns formats de text a HTML existents, com ara Setext, atx, Textile, reStructuredText, Grutatext i EtText, però la principal font d'inspiració és el format de correu electrònic de text sense format.

En resum, la sintaxi de Markdown es compon de símbols, que es seleccionen acuradament i les seves funcions són clares d'un cop d'ull.Per exemple: poseu asteriscs al voltant del text perquè sembli *èmfasi*.

Les llistes a Markdown semblen, bé, llistes. Les cites en bloc a Markdown realment semblen citar un fragment de text, tal com heu vist als correus electrònics.

Compatible amb HTML

L'objectiu de la gramàtica de Markdown és ser un llenguatge d'escriptura per a la web.

Markdown no està pensat per substituir HTML, ni tan sols apropar-s'hi, té molt poca sintaxi i correspon a un petit subconjunt de marques HTML. Markdown no va ser concebut per fer que els documents HTML siguin més fàcils d'escriure.

Al meu entendre, HTML ja és fàcil d'escriure. La idea de Markdown és fer que els documents siguin més fàcils de llegir, escriure i canviar a voluntat. HTML és un format de publicació, Markdown és unRedaccióformat escrit.Com a tal, la sintaxi de format de Markdown només cobreix el que pot fer el text sense format.

Les etiquetes que no estan cobertes per Markdown es poden escriure en HTML directament al documentPromoció webcòpia.No cal marcar-ho com a HTML o Markdown; només cal que afegiu el marcatge directament.

Només cal restringir alguns elements del bloc HTML, com ara <div>,<table>,<pre>,<p> i altres etiquetes, s'han de separar d'altres àrees de contingut amb línies en blanc abans i després, i les seves etiquetes d'obertura i tancament no s'han de sagnar amb pestanyes o espais. El generador de Markdown és prou intel·ligent com per no afegir etiquetes de bloc HTML innecessàries <p> etiqueta.

L'exemple és el següent, afegint una taula HTML al fitxer Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Tingueu en compte que la sintaxi de format de Markdown entre les etiquetes de bloc HTML no es processarà.Per exemple, si utilitzeu un estil Markdown dins d'un bloc HTML*强调*no tindrà cap efecte.

Etiquetes de secció HTML (en línia), com ara <span>,<cite>,<del> Es pot utilitzar lliurement en paràgrafs, llistes o encapçalaments de Markdown.Segons els hàbits personals, fins i tot podeu utilitzar etiquetes HTML per formatar sense utilitzar el format Markdown.Exemple: si preferiu HTML <a> 或 <img> etiquetes, que es poden utilitzar directament sense l'enllaç o la sintaxi de l'etiqueta d'imatge proporcionada per Markdown.

A diferència de les etiquetes de bloc HTML, la sintaxi de Markdown és vàlida entre les etiquetes de secció HTML.

Conversió automàtica de caràcters especials

Als fitxers HTML, hi ha dos caràcters que requereixen un tractament especial: < 和 & . < els símbols s'utilitzen per a les etiquetes d'inici,& Els símbols s'utilitzen per marcar entitats HTML, si només voleu mostrar el prototip d'aquests caràcters, heu d'utilitzar el formulari d'entitat, com ara < 和 &.

& Els caràcters són especialment turmentosos per als escriptors de documents web, si voleu escriure "AT&T", has d'escriure"AT&T".mentre es troba a l'URL & Els personatges també es converteixen.Per exemple, voleu enllaçar a:

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

Heu d'escriure la conversió d'URL com:

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

que es col·locarà a l'etiqueta d'enllaç href en propietats.No cal dir que això és fàcil d'ignorar, i probablement el nombre més gran d'errors detectats per la validació dels estàndards HTML.

Markdown us permet escriure caràcters de manera natural i s'ocupa del que s'ha de convertir.si feu servir & Un caràcter forma part d'una entitat de caràcters HTML, es deixa tal com està, en cas contrari es converteix en &;.

Per tant, si voleu inserir un símbol de copyright al document ©, pots escriure:

©

Markdown ho deixarà intacte.I si escrius:

AT&T

Markdown el convertirà a:

AT&T

Una situació semblant també passa a < notació, ja que Markdown permet la compatibilitat HTML, si ho poseu < Els símbols s'utilitzen com a delimitadors per a les etiquetes HTML i Markdown no els farà cap conversió, però si escriviu:

4 < 5

Markdown el convertirà a:

4 < 5

Tanmateix, cal tenir en compte que dins de l'àmbit del codi, ja sigui en línia o en bloc, < 和 & tots dos símbolssegures converteixen a entitats HTML, una característica que us permet escriure codi HTML fàcilment a Markdown (a diferència d'HTML, on poseu tots els < 和 & Tots es converteixen en entitats HTML, per tal d'escriure codi HTML al fitxer HTML. )

element de bloc

Paràgrafs i salts de línia

Un paràgraf de Markdown consta d'una o més línies de text consecutives, precedides i seguides de més d'una línia en blanc (la definició d'una línia en blanc és que sembla que està buida a la pantalla i es considera una línia en blanc. Per exemple, , si una línia només conté espais i tabulacions, la línia també es tractarà com una línia en blanc).Els paràgrafs normals no s'han de sagnar amb espais o tabulacions.

La frase "consisteix en una o més línies de text consecutives" en realitat implica que Markdown permet noves línies forçades (inserció de línies noves) dins dels paràgrafs, una característica que és diferent de la majoria dels altres formats de text a HTML (incloent el tipus mòbil "Convertir salts de línia". ", altres formats convertiran cada salt de línia a <br /> etiqueta.

Si tuen efecteVoleu confiar en Markdown per inserir-lo <br /> Per a les etiquetes, premeu dos o més espais al lloc d'inserció i, a continuació, premeu Intro.

De fet, es necessita una mica més de treball (espais addicionals) per generar <br /> , sinó simplement "cada nova línia es converteix a <br />"El mètode no és adequat a Markdown, em a MarkdownaiLes cometes de bloc d'estil L i les llistes de diversos paràgrafs no només són més útils, sinó que també són més fàcils de llegir quan s'escriu amb salts de línia.

Títol

Markdown admet dues sintaxis per als encapçalaments, Setext-like i atx-like.

El formulari de tipus Settext és el formulari amb la línia inferior, utilitzant = (títol més alt) i - (Encapçalaments de segon ordre), per exemple:

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

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

qualsevol quantitat = 和 - pot ser eficaç.

La forma semblant a Atx insereix de l'1 al 6 al principi de la línia # , corresponents als títols 1 a 6, per exemple:

# 这是 H1

## 这是 H2

###### 这是 H6

Opcionalment, podeu "tancar" capçaleres semblants a atx, això és purament per estètica, si us sentiu còmode d'aquesta manera, podeu afegir-lo al final de la línia #, mentre que els finals de línia # El número no ha de ser el mateix que l'inici (el nombre de caràcters lletres al començament de la línia determina l'ordre del títol):

# 这是 H1 #

## 这是 H2 ##

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

Cites de bloc Cites de bloc

Les quotes blocades de marcatge de reducció s'utilitzen de manera similar a les que s'utilitzen al correu electrònic > de cites.Si esteu familiaritzat amb les cometes de les cartes de correu electrònic, ja sabeu com crear una cita de bloc en un fitxer Markdown, que semblaria que trenqueu les línies vosaltres mateixos i, a continuació, afegiu > :

> 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 també us permet ser mandrós i afegir només la primera línia de tot el paràgraf > :

> 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 referències de blocs es poden niar (per exemple: referències dins de referències) afegint un nombre diferent de > :

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

També es poden utilitzar altres sintaxis de Markdown dins de blocs entre cometes, com ara encapçalaments, llistes, blocs de codi, etc.:

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

Qualsevol editor de text decent pot crear fàcilment cites d'estil de correu electrònic.Per exemple, a BBEdit podeu seleccionar text i després triar-lo al menúaugmentar la jerarquia de citacions.

Llista

Markdown admet llistes ordenades i no ordenades.

Les llistes no ordenades utilitzen asteriscs, signes més o signes menys com a marcadors de llista:

*   Red
*   Green
*   Blue

Equivalent a:

+   Red
+   Green
+   Blue

També equival a:

-   Red
-   Green
-   Blue

Les llistes ordenades utilitzen números seguits d'un punt:

1.  Bird
2.  McHale
3.  Parish

És important tenir en compte que els números que utilitzeu a l'etiqueta de la llista no afecten l'HTML de sortida. L'etiquetatge HTML resultant per a la llista anterior seria:

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

Si el vostre marcatge de llista s'escriu com:

1.  Bird
1.  McHale
1.  Parish

o fins i tot:

3. Bird
1. McHale
8. Parish

Tots dos obtindreu exactament la mateixa sortida HTML.La qüestió és que podeu fer que els números de la llista del fitxer Markdown siguin iguals que els resultats de sortida, o si sou mandrós, no us cal que us preocupeu per la correcció dels números.

Si feu servir l'escriptura mandrosa, es recomana començar amb 1. per al primer element, perquè Markdown pot admetre l'atribut d'inici de llistes ordenades en el futur.

L'etiqueta d'element de la llista normalment es col·loca a l'extrem esquerre, però es pot sagnar, fins a 3 espais, i l'etiqueta d'element ha d'anar seguida d'almenys un espai o tabulació.

Per fer que la llista sembli més agradable, podeu organitzar el contingut amb un sagnat fix:

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

Però si ets mandrós, també està bé:

*   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 els elements de la llista estan separats per línies en blanc, Markdown utilitzarà el contingut de l'element quan emeti HTML. <p> Les etiquetes s'emboliquen, per exemple:

*   Bird
*   Magic

es convertirà en:

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

Però això:

*   Bird

*   Magic

es convertirà en:

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

Els elements de la llista poden contenir diversos paràgrafs i els paràgrafs de cada element s'han de sagnar amb 4 espais o 1 pestanya:

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 veu molt millor si sagneu cada línia, és clar, de nou, si sou mandrós, Markdown també permet:

*   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 voleu posar una referència dins d'un element de la llista, aleshores > Cal sagnar:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Si voleu posar un bloc de codi, cal que el bloc estigui sagnatdues vegades, que són 8 espais o 2 pestanyes:

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

        <代码写在这>

Per descomptat, una llista d'elements es podria generar accidentalment, una cosa així:

1986. What a great season.

En altres paraules, apareix al principi de la línianúmero-punt-en blanc, per evitar-ho, podeu afegir una barra invertida abans del punt.

1986\. What a great season.

bloc de codi

El codi font d'escriptura o de llenguatge d'etiquetes relacionat amb el programa acostuma a tenir blocs de codi formats. Normalment, no volem que aquests blocs estiguin formats com els fitxers de paràgrafs generals, sinó que els mostrem tal com són. Markdown utilitzarà <pre> 和 <code> etiquetes per embolicar blocs de codi.

Els blocs de codi de Markdown són tan senzills com sagnar 4 espais o 1 pestanya, per exemple, introduïu el següent:

这是一个普通段落：

    这是一个代码区块。

Markdown es convertirà en:

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

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

Aquest sagnat de primer ordre per línia (4 espais o 1 pestanya) s'elimina, per exemple:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

es convertirà en:

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

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

Un bloc de codi continua fins a la línia sense sagnar (o el final del fitxer).

Dins del bloc de codi, & , < 和 > Es convertirà automàticament en entitats HTML. Aquest mètode us facilita molt l'ús de Markdown per inserir el codi font HTML per a l'exemple; només cal que copieu-lo i enganxeu-lo, afegiu-hi sagnat i la resta Markdown s'encarregarà de gestionar-lo per vosaltres. exemple:

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

es convertirà en:

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

Al bloc de codi, la sintaxi general de Markdown no es convertirà, com ara els asteriscs són només asteriscs, la qual cosa significa que podeu escriure fàcilment fitxers relacionats amb la sintaxi de Markdown amb la sintaxi de Markdown.

divisor

Podeu crear un divisor amb més de tres asteriscs, signes menys, guions baixos en una línia, res més a la línia.També podeu inserir espais entre asteriscs o signes menys.Les línies de separació es poden crear en cadascuna de les maneres d'escriure següents:

* * *

***

*****

- - -

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

element de secció

enllaç

Markdown admet dues formes de sintaxi d'enllaç: En linia和Referènciadues formes.

De qualsevol manera, el text de l'enllaç està marcat amb [claussos quadrats].

per crear aEn liniaSi voleu afegir el text del títol de l'enllaç, només cal que emboliqueu el text del títol amb cometes dobles després de l'URL, per exemple:

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

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

Produirà:

<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 esteu enllaçant recursos al mateix amfitrió, podeu utilitzar camins relatius:

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

ReferènciaL'enllaç va seguit d'un altre claudàtor després del claudàtor del text de l'enllaç, i la marca utilitzada per identificar l'enllaç s'ha d'omplir al segon claudàtor:

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

També podeu posar un espai opcional entre els dos claudàtors:

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

A continuació, a qualsevol part del fitxer, podeu definir el contingut de l'enllaç d'aquesta etiqueta:

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

El contingut de l'enllaç es defineix de la forma següent:

• Parèntesis (opcionalment precedits de fins a tres espais per al sagnat) on s'introdueix el text de l'enllaç
• seguit de dos punts
• seguit d'un o més espais o pestanyes
• l'URL del següent enllaç
• Opcionalment, segueix el contingut del títol, que es pot incloure entre cometes simples, cometes dobles o parèntesis

Les definicions dels tres enllaços següents són les mateixes:

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

precaució:Hi ha un problema conegut en què Markdown.pl 1.0.1 ignora els títols dels enllaços entre cometes simples.

Els URL d'enllaç també es poden incloure entre claudàtors angulars:

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

També podeu posar l'atribut title a la línia següent, o afegir un sagnat, que es veurà millor si l'URL és massa llarg:

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

Les definicions d'URL només s'utilitzen quan es generen enllaços i no apareixen directament al fitxer.

Les etiquetes d'identificació d'enllaç poden contenir lletres, números, espais en blanc i signes de puntuació, però noNoDistingeix entre majúscules i minúscules, de manera que els dos enllaços següents són iguals:

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

Etiqueta d'enllaç implícitLa funció us permet ometre l'especificació d'una etiqueta d'enllaç. En aquest cas, l'etiqueta d'enllaç es tractarà com a equivalent al text de l'enllaç. Per utilitzar una etiqueta d'enllaç implícita, només heu d'afegir un claudàtor buit després del text de l'enllaç. Si voleu "Google " Enllaçant a google.com, podeu simplificar-ho per:

[Google][]

A continuació, definiu el contingut de l'enllaç:

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

Com que el text de l'enllaç pot contenir espais en blanc, aquest marcatge simplificat pot contenir diverses paraules:

Visit [Daring Fireball][] for more information.

A continuació, aneu a definir l'enllaç:

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

La definició de l'enllaç es pot col·locar a qualsevol lloc de l'arxiu, jo prefereixo posar-la directament després del paràgraf on apareix l'enllaç. També podeu posar-la al final de l'arxiu, com si fos un comentari.

Aquí teniu un exemple d'enllaç de referència:

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 el canvieu per utilitzar el nom de l'enllaç per escriure:

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 dues maneres anteriors d'escriure produiran el següent 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>

A continuació es mostra un fitxer Markdown del mateix contingut escrit en línia, proporcionat per a la comparació:

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

De fet, l'objectiu dels enllaços d'estil de referència no és que sigui més fàcil d'escriure, sinó que és més fàcil de llegir. Compareu l'exemple anterior. L'article d'estil de referència en si només té 81 caràcters, però el formulari en línia augmentarà a 176 caràcters. , si està escrit en format HTML pur, hi haurà 234 caràcters. En format HTML, hi ha més etiquetes que text.

L'ús dels enllaços d'estil de referència de Markdown pot fer que el document sigui més semblant al resultat final del navegador, cosa que us permetrà moure algunes metadades relacionades amb el marcatge fora del text del paràgraf i podeu afegir enllaços sense fer que l'article es llegeixi.

强调

Markdown utilitza asteriscs (*) i la línia de fons (_) com a símbol per marcar una paraula subratllada, és * 或 _ Les paraules envoltades es converteixen en <em> envoltat d'etiquetes, amb dos * 或 _Si s'embolica, es convertirà en <strong>,Per exemple:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

es convertirà en:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Podeu utilitzar l'estil que vulgueu, l'única limitació és que podeu utilitzar el símbol per obrir l'etiqueta i el símbol per acabar-la.

L'èmfasi també es pot inserir directament al mig del text:

un*frigging*believable

peròsi el teu * 和 _ Si hi ha espais en blanc als dos costats, només es tracten com a símbols normals.

Per inserir asteriscs o guions baixos normals directament abans i després del text, podeu utilitzar barres invertides:

\*this text is surrounded by literal asterisks\*

Codi

Si voleu marcar un petit tros de codi en línia, podeu embolicar-lo amb backticks (`),Per exemple:

Use the `printf()` function.

Produirà:

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

Si voleu inserir backticks dins d'una secció de codi, podeu iniciar i finalitzar la secció de codi amb diversos backticks:

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

Aquesta sintaxi produeix:

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

Podeu posar un espai en blanc al principi i al final d'una secció de codi, un després de l'inici i un abans del final, de manera que podeu inserir backticks al principi de la secció:

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

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

Produirà:

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

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

Dins de la secció de codi,& i parèntesis angulars都es convertirà automàticament a entitats HTML, cosa que facilita la inserció del codi font HTML, Markdown posarà el paràgraf següent:

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

a:

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

També pots escriure això:

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

Produïr:

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

图片

Òbviament, és difícil dissenyar una sintaxi "natural" per inserir imatges en una aplicació només de text.

Markdown utilitza una sintaxi similar als enllaços per marcar imatges i també permet dos estils: En linia和Referència.

La sintaxi de la imatge en línia és així:

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

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

Els detalls són els següents:

• un signe d'exclamació !
• seguit d'un claudàtor amb text alternatiu per a la imatge
• Això és seguit de parèntesis normals amb l'URL de la imatge i, finalment, un text opcional "títol" entre cometes.

La sintaxi de la imatge de referència té aquest aspecte:

![Alt text][id]

"id" és el nom de la referència de la imatge, que es defineix de la mateixa manera que una referència d'enllaç:

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

Fins ara, Markdown no té cap manera d'especificar l'amplada i l'alçada de la imatge, si ho necessiteu, podeu utilitzar el normal <img> etiqueta.

其它

enllaç automàtic

Markdown admet el processament d'URL i bústies de correu electrònic en forma d'enllaços automàtics relativament curts. Sempre que estiguin entre claudàtors angulars, Markdown els convertirà automàticament en un enllaç.El text de l'enllaç de l'URL general és el mateix que l'adreça de l'enllaç, per exemple:

<http://example.com/>

La reducció es convertirà a:

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

L'enllaç automàtic d'adreces de correu electrònic també és molt similar, excepte que Markdown primer realitzarà un procés de conversió de codificació, convertint caràcters de text en entitats HTML hexadecimals. Aquest format pot enganyar alguns robots de recollida d'adreces de correu electrònic dolents, com ara:

<[email protected]>

Markdown es convertirà en:

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

Al navegador, aquesta cadena (en realitat <a href="mailto:[email protected]">[email protected]</a>) es converteix en un enllaç "[email protected]" que es pot fer clic.

(Tot i que aquest enfocament pot enganyar molts robots, no els pot aturar a tots, però és millor que res. En qualsevol cas, obrir la vostra bústia acabarà atreure cartes publicitàries.)

barra invertida

Markdown pot utilitzar barres invertides per inserir símbols que tinguin altres significats a la gramàtica, per exemple: si voleu afegir un asterisc al costat del text per emfatitzar (però no <em> etiqueta), podeu precedir l'asterisc amb una barra invertida:

\*literal asterisks\*

Markdown admet els símbols següents precedits d'una barra invertida per ajudar a inserir símbols comuns:

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

Editor gratuït de Markdown

Plataforma Windows

• MarkdownPad
• MarkPad

Plataforma Mac

• suau

editor en línia

• MPEditor

connector del navegador

• Plugin Markdown aquí

*** Si hi ha un millor editor de Markdown gratuït per recomanar, presteu atenció als comentarisChen Weiliang, gràcies!