Ce înseamnă Markdown? Cum se utilizează sintaxa Markdown/marcarea formatului?

ReduceriCe înseamnă?

Cum se utilizează sintaxa Markdown/marcarea de formatare?

Prezentare generală

Markdown este un limbaj de marcare ușor creat de John Gruber.

Le permite oamenilor să „scrie documente în format text simplu, ușor de citit și scris, apoi să le convertească în documente XHTML (sau HTML) valide”.

Limbajul a absorbit multe dintre caracteristicile de marcare a textului simplu găsite deja în e-mail.

John Gruber a creat limbajul Markdown în 2004, în colaborare cu Aaron Swartz în mare parte pe sintaxă.Scopul limbajului este de a folosi „un format de text simplu care este ușor de citit, ușor de scris și, opțional, care se convertește în XHTML (sau HTML) valid”.

scop

Scopul Markdown este să fie „ușor de citit și ușor de scris”.

lizibilitate, fă-o oricumInternet Marketing, experiența utilizatorului este foarte importantă.

Un document scris în Markdown ar trebui să poată fi publicat direct în text simplu și nu ar trebui să pară a fi compus din multe etichete sau directive de formatare.

Sintaxa Markdown este influențată de unele formate existente text-to-HTML, inclusiv Setext, atx, Textile, reStructuredText, Grutatext și EtText, dar cea mai mare sursă de inspirație este formatul de e-mail cu text simplu.

Pe scurt, sintaxa Markdown este compusă din simboluri, care sunt atent selectate, iar funcțiile lor sunt clare dintr-o privire.De exemplu: pune asteriscuri în jurul textului pentru ca acesta să arate ca *accent*.

Listele din Markdown arată ca, ei bine, liste. Citatele blocate din Markdown chiar arată ca citarea unui text, așa cum ați văzut în e-mailuri.

Compatibil cu HTML

Scopul gramaticii Markdown este de a fi un limbaj de scriere pentru web.

Markdown nu este menit să înlocuiască HTML sau chiar să se apropie de el, are foarte puține tipuri de sintaxă și corespunde doar unui mic subset de markup HTML. Markdown nu a fost conceput pentru a face documentele HTML mai ușor de scris.

După părerea mea, HTML este deja ușor de scris. Ideea Markdown este de a face documentele mai ușor de citit, scris și schimbat după bunul plac. HTML este un format de publicare, Markdown este unRedactareformat scris.Ca atare, sintaxa de formatare a lui Markdown acoperă doar ceea ce poate textul simplu.

Etichetele care nu sunt acoperite de Markdown pot fi scrise în HTML direct în documentPromovare Webcopie.Nu este nevoie să marcați acest lucru ca HTML sau Markdown; trebuie doar să adăugați marcajul direct.

Numai unele elemente de bloc HTML trebuie constrânse - cum ar fi <div>,<table>,<pre>,<p> și alte etichete, acestea trebuie separate de alte zone de conținut cu linii goale înainte și după, iar etichetele lor de deschidere și de închidere nu trebuie să fie indentate cu file sau spații. Generatorul Markdown este suficient de inteligent pentru a nu adăuga etichete HTML inutile <p> eticheta.

Exemplul este următorul, adăugarea unui tabel HTML la fișierul Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Rețineți că sintaxa de formatare Markdown între etichetele bloc HTML nu va fi procesată.De exemplu, dacă utilizați un stil Markdown în interiorul unui bloc HTML*强调*nu va avea niciun efect.

Etichete de secțiune HTML (inline), cum ar fi <span>,<cite>,<del> Poate fi folosit în mod liber în paragrafele, listele sau titlurile Markdown.Conform obiceiurilor personale, puteți chiar să utilizați etichete HTML pentru a formata fără a utiliza formatul Markdown.Exemplu: dacă preferați HTML <a> 或 <img> etichete, care pot fi utilizate direct fără link-ul sau sintaxa etichetei de imagine furnizate de Markdown.

Spre deosebire de etichetele bloc HTML, sintaxa Markdown este valabilă între etichetele de secțiune HTML.

Conversia automată a caracterelor speciale

În fișierele HTML, există două caractere care necesită o manipulare specială: < 和 & . < simbolurile sunt folosite pentru etichetele de pornire,& Simbolurile sunt folosite pentru a marca entitățile HTML, dacă doriți doar să afișați prototipul acestor caractere, trebuie să utilizați formularul de entitate, cum ar fi < 和 &.

& Caracterele sunt mai ales chinuitoare pentru scriitorii de documente web, dacă ai de gând să tastați „AT&T", trebuie sa scrii "AT&T".în timp ce se află în URL & Caracterele sunt, de asemenea, convertite.De exemplu, doriți să conectați la:

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

Trebuie să scrieți conversia URL ca:

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

pentru a fi plasat în eticheta de link href în proprietăți.Inutil să spun că acest lucru este ușor de ignorat și, probabil, cel mai mare număr de erori detectate de validarea standardelor HTML.

Markdown vă permite să scrieți caractere în mod natural și are grijă de ceea ce trebuie convertit.daca folosesti & Un caracter face parte dintr-o entitate de caracter HTML, este lăsat ca atare, altfel este convertit în &;.

Deci, dacă doriți să inserați un simbol de drept de autor în document ©, poti sa scrii:

©

Markdown îl va lăsa neatins.Si daca scrii:

AT&T

Markdown îl va converti în:

AT&T

O situație similară apare și în < notație, deoarece Markdown permite compatibilitatea HTML, dacă puneți < Simbolurile sunt folosite ca delimitatori pentru etichetele HTML, iar Markdown nu va face nicio conversie asupra lor, dar dacă scrieți:

4 < 5

Markdown îl va converti în:

4 < 5

Cu toate acestea, trebuie remarcat faptul că în domeniul de aplicare a codului, indiferent dacă este inline sau bloc, < 和 & ambele simboluritrebuie sasunt convertite în entități HTML, o caracteristică care vă permite să scrieți cu ușurință cod HTML în Markdown (spre deosebire de HTML, unde puneți toate < 和 & Toate sunt convertite în entități HTML, pentru a scrie cod HTML în fișierul HTML. )


element bloc

Paragrafe și întreruperi de rând

Un paragraf Markdown constă din una sau mai multe rânduri consecutive de text, precedate și urmate de mai multe rânduri goale (definiția unei linii goale este aceea că pare a fi goală pe afișaj și este considerată a fi o linie goală. De exemplu, , dacă o linie conține doar spații și tab-uri, linia va fi, de asemenea, tratată ca o linie goală).Paragrafele normale nu trebuie să fie indentate cu spații sau file.

Expresia „constă dintr-una sau mai multe rânduri consecutive de text” implică de fapt că Markdown permite liniile noi forțate (inserarea de linii noi) în paragrafe, o caracteristică care este diferită de majoritatea celorlalte formate text în HTML (inclusiv Tipul mobil „Conversia întreruperi de linie”. „, alte formate vor converti fiecare întrerupere de linie în <br /> eticheta.

daca tuintr-adevarDoriți să vă bazați pe Markdown pentru a introduce <br /> Pentru etichete, apăsați două sau mai multe spații la locul de inserare, apoi apăsați Enter.

Într-adevăr, este nevoie de puțin mai multă muncă (spații suplimentare) pentru a genera <br /> , ci pur și simplu „fiecare linie nouă este convertită în <br />„Metoda nu este potrivită în Markdown, em în MarkdownaiCitatele bloc în stil L și listele cu mai multe paragrafe sunt nu numai mai utile, ci și mai ușor de citit atunci când scrieți cu întreruperi de linie.

Markdown acceptă două sintaxe pentru titluri, asemănător Setext și asemănător atx.

Forma Settext-like este forma cu linia de jos, folosind = (cel mai înalt titlu) și - (titluri de ordinul doi), de exemplu:

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

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

orice sumă = 和 - poate fi eficient.

Forma de tip Atx inserează de la 1 la 6 la începutul liniei # , corespunzătoare rubricilor de la 1 la 6, de exemplu:

# 这是 H1

## 这是 H2

###### 这是 H6

Opțional puteți „închide” anteturi asemănătoare atx, acest lucru este pur pentru estetică, dacă vă simțiți confortabil astfel, îl puteți adăuga la sfârșitul liniei #, în timp ce linia se termină # Numărul nu trebuie să fie același cu începutul (numărul de litere de la începutul rândului determină ordinea titlului):

# 这是 H1 #

## 这是 H2 ##

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

Citate bloc Citate bloc

Citatele blocate de marcare Markdown sunt folosite similar cu cele folosite în e-mail > a citărilor.Dacă sunteți familiarizat cu ghilimele din scrisorile de e-mail, știți cum să creați un citat bloc într-un fișier Markdown, care ar părea ca și cum ați rupe singur rândurile, apoi adăugați > :

> 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 vă permite, de asemenea, să fiți leneș și să adăugați doar primul rând din întregul paragraf > :

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

Referințele bloc pot fi imbricate (de exemplu: referințe în cadrul referințelor) prin adăugarea unui număr diferit de > :

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

Alte sintaxe Markdown pot fi, de asemenea, utilizate în blocurile citate, inclusiv titluri, liste, blocuri de cod etc.:

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

Orice editor de text decent poate crea cu ușurință citate în stilul e-mailului.De exemplu, în BBEdit puteți selecta text și apoi alege din meniucreșterea ierarhiei citărilor.

listă

Markdown acceptă liste ordonate și neordonate.

Listele neordonate folosesc asteriscuri, semne plus sau semne minus ca marcatori de listă:

*   Red
*   Green
*   Blue

Echivalentă cu:

+   Red
+   Green
+   Blue

De asemenea, echivalent cu:

-   Red
-   Green
-   Blue

Listele ordonate folosesc numere urmate de un punct:

1.  Bird
2.  McHale
3.  Parish

Este important să rețineți că numerele pe care le utilizați în eticheta listă nu afectează HTML-ul de ieșire. Marcajul HTML rezultat pentru lista de mai sus ar fi:

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

Dacă marcarea listei este scrisă ca:

1.  Bird
1.  McHale
1.  Parish

sau chiar:

3. Bird
1. McHale
8. Parish

Amândoi veți obține exact aceeași ieșire HTML.Ideea este că puteți face ca numerele listei din fișierul Markdown să fie identice cu rezultatele de ieșire sau, dacă sunteți leneș, nu trebuie să vă pese deloc de corectitudinea numerelor.

Dacă utilizați scriere leneșă, este recomandat să începeți cu 1. pentru primul articol, deoarece Markdown poate accepta atributul de început al listelor ordonate în viitor.

Eticheta articolului din listă este de obicei plasată în extrema stângă, dar poate fi indentată, până la 3 spații, iar eticheta articolului trebuie să fie urmată de cel puțin un spațiu sau tab.

Pentru a face lista să arate mai frumos, puteți organiza conținutul cu o indentare 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.

Dar dacă ești leneș, e bine și asta:

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

Dacă elementele din listă sunt separate prin linii goale, Markdown va folosi conținutul elementelor atunci când scoate HTML. <p> Etichetele sunt împachetate, de exemplu:

*   Bird
*   Magic

va fi convertit în:

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

Dar asta:

*   Bird

*   Magic

va fi convertit în:

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

Elementele din listă pot conține mai multe paragrafe, iar paragrafele de sub fiecare articol trebuie să fie indentate cu 4 spații sau cu 1 filă:

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.

Arată mult mai bine dacă indentați fiecare linie, bineînțeles, din nou, dacă sunteți leneș, Markdown permite și:

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

Dacă doriți să puneți o referință într-un articol din listă, atunci > Trebuie să fie indentat:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Dacă doriți să puneți un bloc de cod, blocul trebuie să fie indentatde două ori, care este de 8 spații sau 2 file:

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

        <代码写在这>

Desigur, o listă de articole ar putea fi generată accidental, ceva de genul acesta:

1986. What a great season.

Cu alte cuvinte, apare la începutul linieinumăr-punct-alb, pentru a evita acest lucru, puteți adăuga o bară oblică inversă înainte de punct.

1986\. What a great season.

bloc de cod

Codul sursă pentru scrierea programelor sau limbajul de etichetă are de obicei deja blocuri de cod tipărite. De obicei, nu dorim ca aceste blocuri să fie tipărite ca fișiere cu paragrafe generale, ci să le afișăm așa cum sunt. Markdown va folosi <pre> 和 <code> etichete pentru a împacheta blocurile de cod.

Blocurile de bază ale codului în Markdown sunt la fel de simple ca indentarea a 4 spații sau a unei file, de exemplu, introduceți următoarele:

这是一个普通段落:

    这是一个代码区块。

Markdown se va converti în:

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

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

Această indentație de ordinul întâi pe rând (4 spații sau 1 filă) este eliminată, de exemplu:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

va fi convertit în:

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

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

Un bloc de cod continuă până la linia neindentată (sau la sfârșitul fișierului).

În interiorul blocului de cod, & , < 和 > Acesta va fi convertit automat în entități HTML. Această metodă vă face foarte ușor să utilizați Markdown pentru a introduce codul sursă HTML pentru exemplu, doar copiați și lipiți-l, adăugați indentare, iar restul Markdown se va ocupa de asta pentru dvs. exemplu:

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

va fi convertit în:

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

În blocul de cod, sintaxa generală Markdown nu va fi convertită, cum ar fi asteriscurile sunt doar asteriscuri, ceea ce înseamnă că puteți scrie cu ușurință fișierele legate de sintaxa Markdown în sintaxa Markdown.

separator

Puteți crea un divizor cu mai mult de trei asteriscuri, semne minus, subliniere într-o linie, nimic altceva în linie.De asemenea, puteți introduce spații între asteriscuri sau semnele minus.Liniile de separare pot fi create în fiecare dintre următoarele moduri de scriere:

* * *

***

*****

- - -

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

element de secțiune

Markdown acceptă două forme de sintaxă a linkurilor: In linieReferinţădoua forme.

În orice caz, textul linkului este marcat cu [paranteze pătrate].

a crea oIn linieDacă doriți să adăugați textul titlului linkului, trebuie doar să includeți textul titlului cu ghilimele duble după adresa URL, de exemplu:

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

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

Va produce:

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

Dacă vă conectați la resurse de pe aceeași gazdă, puteți utiliza căi relative:

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

ReferinţăLegătura este urmată de o altă paranteză pătrată după paranteza textului linkului, iar semnul utilizat pentru a identifica legătura trebuie completat în a doua paranteză pătrată:

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

Opțional, puteți pune un spațiu între cele două paranteze pătrate:

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

Apoi, oriunde în fișier, puteți defini conținutul link-ului acestei etichete:

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

Conținutul linkului este definit sub forma:

  • Paranteze pătrate (precedate opțional de până la trei spații pentru indentare) în care este introdus textul linkului
  • urmată de două puncte
  • urmat de unul sau mai multe spații sau file
  • URL-ul următorului link
  • Opțional, urmăriți conținutul titlului, care poate fi inclus între ghilimele simple, ghilimele duble sau paranteze

Definițiile următoarelor trei legături sunt aceleași:

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

prudență:Există o problemă cunoscută în care Markdown.pl 1.0.1 ignoră titlurile linkurilor cuprinse între ghilimele simple.

Adresele URL ale linkurilor pot fi incluse și între paranteze unghiulare:

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

De asemenea, puteți pune atributul titlu pe rândul următor sau puteți adăuga o indentație, care va arăta mai bine dacă adresa URL este prea lungă:

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

Definiția URL este utilizată numai la generarea link-ului și nu apare direct în fișier.

Etichetele de identificare a linkurilor pot conține litere, cifre, spații albe și semne de punctuație, dar nuNu faceEste sensibil la majuscule și minuscule, deci următoarele două link-uri sunt aceleași:

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

Etichetă de link implicitcaracteristica vă permite să omiteți specificarea unei etichete de link. În acest caz, eticheta de link va fi tratată ca echivalent cu textul linkului. Pentru a utiliza o etichetă de link implicită, trebuie doar să adăugați o paranteză pătrată goală după textul linkului. Dacă doriți „Google „ Prin conectarea la google.com, puteți simplifica la:

[Google][]

Apoi definiți conținutul linkului:

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

Deoarece textul linkului poate conține spații albe, acest marcaj simplificat poate conține mai multe cuvinte:

Visit [Daring Fireball][] for more information.

Apoi continuați să definiți linkul:

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

Definitia linkului poate fi plasata oriunde in fisier.Prefer sa o pun direct dupa paragraful in care apare linkul.Poti sa o pui si la sfarsitul fisierului, la fel ca un comentariu.

Iată un exemplu de link de referință:

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"

Dacă îl schimbați, utilizați numele linkului pentru a scrie:

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"

Cele două moduri de scriere de mai sus vor produce următorul 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>

Mai jos este un fișier Markdown cu același conținut scris inline, furnizat pentru comparație:

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 fapt, scopul link-urilor în stil de referință nu este că sunt mai ușor de scris, ci că sunt mai ușor de citit. Comparați exemplul de mai sus. Articolul în stil de referință în sine are doar 81 de caractere, dar forma inline va crește la 176 de caractere. , dacă este scris în format HTML pur, vor fi 234 de caractere. În format HTML, există mai multe etichete decât text.

Folosind linkurile în stilul de referință ale Markdown, puteți face documentul mai mult ca rezultatul final al browserului, permițându-vă să mutați unele metadate legate de marcaj în afara textului paragrafului și puteți adăuga linkuri fără a face senzația de citire a articolului. .

强调

Markdown folosește asteriscuri (*) și linia de jos (_) ca simbol pentru a marca un cuvânt subliniat, este * 或 _ Cuvintele înconjurate sunt convertite în <em> înconjurat de etichete, cu două * 或 _Dacă este împachetat, va fi transformat în <strong>,De exemplu:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

se va transforma in:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Puteți folosi orice stil doriți, singura limitare este că puteți folosi simbolul pentru a deschide eticheta și simbolul pentru a o termina.

Accentul poate fi de asemenea inserat direct în mijlocul textului:

un*frigging*believable

dardacă ale tale * 和 _ Dacă există spații albe pe ambele părți, acestea sunt doar tratate ca simboluri normale.

Pentru a insera asteriscuri normale sau subliniere direct înainte și după text, puteți utiliza barele oblice inverse:

\*this text is surrounded by literal asterisks\*

Cod

Dacă doriți să marcați o mică bucată de cod inline, o puteți înfășura în backticks (`),De exemplu:

Use the `printf()` function.

Va produce:

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

Dacă doriți să inserați backtick-uri într-o secțiune de cod, puteți începe și încheia secțiunea de cod cu mai multe backtick-uri:

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

Această sintaxă produce:

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

Puteți pune un spațiu liber la începutul și la sfârșitul unei secțiuni de cod, unul după început și unul înainte de sfârșit, astfel încât să puteți introduce backtick-uri la începutul secțiunii:

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

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

Va produce:

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

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

În secțiunea de cod,& și paranteze unghiulareva fi convertit automat în entități HTML, ceea ce facilitează inserarea codului sursă HTML, Markdown va pune următorul paragraf:

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

la:

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

Puteți scrie și asta:

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

A produce:

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

图片

Evident, este dificil să proiectați o sintaxă „naturală” pentru inserarea imaginilor într-o aplicație doar text.

Markdown folosește o sintaxă similară cu cea a linkurilor pentru a marca imaginile și, de asemenea, permite două stiluri: In linieReferinţă.

Sintaxa imaginii inline arată astfel:

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

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

Detaliile sunt după cum urmează:

  • un semn de exclamare !
  • urmat de o paranteză pătrată cu text alternativ pentru imagine
  • Apoi, o paranteză normală, introduceți adresa URL a imaginii în interior și, în final, înfășurați-o între ghilimele și adăugați un text opțional „titlu”.

Sintaxa imaginii de referință arată astfel:

![Alt text][id]

„id” este numele referinței de imagine, care este definită în același mod ca o referință de link:

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

Până acum, Markdown nu are nicio modalitate de a specifica lățimea și înălțimea imaginii, dacă aveți nevoie, puteți utiliza <img> eticheta.


其它

Markdown acceptă procesarea adreselor URL și a căsuțelor poștale de e-mail sub formă de link-uri automate relativ scurte. Atâta timp cât sunt incluse între paranteze unghiulare, Markdown le va converti automat într-un link.Textul linkului de la adresa URL generală este același cu adresa linkului, de exemplu:

<http://example.com/>

Markdown va fi convertit în:

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

Conectarea automată a adreselor de e-mail este, de asemenea, foarte asemănătoare, cu excepția faptului că Markdown va efectua mai întâi un proces de conversie de codificare, conversia caracterelor text în entități HTML hexazecimale. Acest format poate păcăli unii roboți de colectare a adreselor de e-mail proaste, cum ar fi:

<[email protected]>

Markdown se va transforma în:

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

În browser, acest șir (de fapt <a href="mailto:[email protected]">[email protected]</a>) devine un link „[email protected]” pe care se poate face clic.

(Deși această abordare poate păcăli mulți roboți, nu îi poate opri pe toți, dar este mai bine decât nimic. În orice caz, deschiderea căsuței poștale va atrage în cele din urmă scrisori publicitare.)

backslash

Markdown poate folosi barele oblice inverse pentru a insera simboluri care au alte semnificații în gramatică, de exemplu: dacă doriți să adăugați un asterisc lângă text pentru accentuare (dar nu <em> etichetă), puteți precede asteriscul cu o bară oblică inversă:

\*literal asterisks\*

Markdown acceptă următoarele simboluri precedate de o bară oblică inversă pentru a ajuta la inserarea simbolurilor comune:

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

Editor gratuit Markdown

Platforma Windows

    Platforma Mac

    editor online

    plugin pentru browser

    *** Dacă există un editor Markdown gratuit mai bun de recomandat, vă rugăm să acordați atenție feedback-uluiChen Weiliang,Mulțumesc!

    Hope Chen Weiliang Blog ( https://www.chenweiliang.com/ ) a distribuit „Ce înseamnă Markdown? Cum se utilizează sintaxa Markdown/marcarea de formatare? , sa te ajut.

    Bine ați venit să distribuiți linkul acestui articol:https://www.chenweiliang.com/cwl-482.html

    Bun venit pe canalul Telegram al blogului lui Chen Weiliang pentru a primi cele mai recente actualizări!

    🔔 Fii primul care primește valorosul „Ghid de utilizare a instrumentului AI pentru marketing de conținut ChatGPT” în directorul de top al canalului! 🌟
    📚 Acest ghid conține o valoare uriașă, 🌟Aceasta este o oportunitate rară, nu o ratați! ⏰⌛💨
    Distribuie si da like daca iti place!
    Partajarea și like-urile tale sunt motivația noastră continuă!

     

    发表 评论

    Adresa ta de email nu va fi publicată. Sunt utilizate câmpurile obligatorii * Eticheta

    derulați în sus