Wat betekent Markdown? Hoe Markdown-syntaxis / opmaakmarkeringen te gebruiken?

MarkdownWat betekent?

Hoe gebruik ik Markdown-syntaxis/opmaak opmaak?

Overzicht

Markdown is een lichtgewicht opmaaktaal gemaakt door John Gruber.

Het stelt mensen in staat om "documenten te schrijven in platte tekst die gemakkelijk te lezen en te schrijven is, en deze vervolgens om te zetten in geldige XHTML (of HTML) documenten".

De taal heeft veel van de kenmerken van platte tekstopmaak overgenomen die al in e-mail te vinden zijn.

John Gruber creëerde de Markdown-taal in 2004, in samenwerking met Aaron Swartz voor een groot deel aan de syntaxis.Het doel van de taal is om "een platte tekstindeling te gebruiken die gemakkelijk te lezen en te schrijven is en optioneel kan worden geconverteerd naar geldige XHTML (of HTML)".

doel

Het doel van Markdown is om "gemakkelijk te lezen en gemakkelijk te schrijven" te zijn.

leesbaarheid, doe het toch网络 营销, gebruikerservaring is erg belangrijk.

Een document dat in Markdown is geschreven, moet rechtstreeks in platte tekst kunnen worden gepubliceerd en mag niet lijken te zijn samengesteld uit veel tags of opmaakrichtlijnen.

Markdown-syntaxis wordt beïnvloed door enkele bestaande tekst-naar-HTML-indelingen, waaronder Setext, atx, Textile, reStructuredText, Grutatext en EtText, maar de grootste inspiratiebron is het e-mailformaat in platte tekst.

Kortom, de syntaxis van Markdown bestaat allemaal uit symbolen, die zorgvuldig zijn geselecteerd en hun functies in één oogopslag duidelijk zijn.Bijvoorbeeld: plaats sterretjes rond tekst om het eruit te laten zien als *nadruk*.

Lijsten in Markdown zien eruit als, nou ja, lijsten. Blockquotes in Markdown lijken echt op het citeren van een stuk tekst, net zoals je hebt gezien in e-mails.

Compatibel met HTML

Het doel van de Markdown-grammatica is om een ​​schrijftaal voor het web te zijn.

Markdown is niet bedoeld om HTML te vervangen, of komt er zelfs maar in de buurt, het heeft heel weinig syntaxis en komt overeen met slechts een kleine subset van HTML-markup. Markdown is niet ontworpen om HTML-documenten gemakkelijker te schrijven te maken.

Naar mijn mening is HTML al gemakkelijk te schrijven. Het idee van Markdown is om documenten naar believen gemakkelijker te kunnen lezen, schrijven en wijzigen. HTML is een publicatieformaat, Markdown is eenCopywritinggeschreven formaat.Als zodanig dekt de opmaaksyntaxis van Markdown alleen wat platte tekst kan.

Tags die niet onder Markdown vallen, kunnen rechtstreeks in HTML in het document worden geschrevenWebpromotiekopiëren.Het is niet nodig om dit te markeren als HTML of Markdown; voeg de markup gewoon direct toe.

Slechts enkele HTML-blokelementen die moeten worden beperkt, zoals <div>,<table>,<pre>,<p> en andere tags, moeten ze worden gescheiden van andere inhoudsgebieden met lege regels ervoor en erna, en hun openings- en sluitingstags mogen niet worden ingesprongen met tabs of spaties. De Markdown-generator is slim genoeg om geen onnodige HTML-bloktags toe te voegen <p> etiket.

Het voorbeeld is als volgt, het toevoegen van een HTML-tabel aan het Markdown-bestand:

这是一个普通段落。

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

这是另一个普通段落。

Merk op dat Markdown-opmaaksyntaxis tussen HTML-bloktags niet wordt verwerkt.Als u bijvoorbeeld de Markdown-stijl in HTML-blokken gebruikt*强调*zal geen effect hebben.

HTML-sectie (inline) tags zoals <span>,<cite>,<del> Kan vrij worden gebruikt in Markdown-paragrafen, lijsten of koppen.Volgens persoonlijke gewoonten kunt u zelfs HTML-tags gebruiken om op te maken zonder Markdown-indeling te gebruiken.Voorbeeld: Als u de voorkeur geeft aan HTML <a> 或 <img> tags, die direct kunnen worden gebruikt zonder de syntaxis van de link of afbeeldingstag die door Markdown wordt geleverd.

In tegenstelling tot tussen HTML-bloktags, is de Markdown-syntaxis geldig tussen HTML-sectietags.

Automatische conversie van speciale tekens

In HTML-bestanden zijn er twee tekens die een speciale behandeling vereisen: < 和 & . < symbolen worden gebruikt voor starttags,& Symbolen worden gebruikt om HTML-entiteiten te markeren, als u alleen het prototype van deze tekens wilt weergeven, moet u het entiteitsformulier gebruiken, zoals < 和 &.

& Tekens zijn vooral kwellend voor schrijvers van webdocumenten, als je gaat typen "AT&T", je moet schrijven"AT&T".terwijl in de URL & Tekens worden ook omgezet.U wilt bijvoorbeeld linken naar:

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

U moet de URL-conversie schrijven als:

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

te plaatsen in de link-tag href bij eigenschappen.Onnodig te zeggen dat dit gemakkelijk te negeren is en waarschijnlijk het grootste aantal fouten dat wordt gedetecteerd door validatie van HTML-standaarden.

Markdown stelt je in staat om karakters op een natuurlijke manier te schrijven, en het zorgt voor wat er moet worden geconverteerd.als je gebruikt & Een teken maakt deel uit van een HTML-tekeneenheid, het blijft zoals het is, anders wordt het geconverteerd naar &;.

Dus als u een copyright-symbool in het document wilt invoegen ©, je kan schrijven:

©

Markdown laat het onaangeroerd.En als je schrijft:

AT&T

Markdown zal het converteren naar:

AT&T

Een soortgelijke situatie doet zich ook voor in < notatie, aangezien Markdown HTML-compatibiliteit toestaat, als u < Symbolen worden gebruikt als scheidingstekens voor HTML-tags en Markdown zal er geen conversies op uitvoeren, maar als u schrijft:

4 < 5

Markdown zal het converteren naar:

4 < 5

Er moet echter worden opgemerkt dat binnen de reikwijdte van de code, of deze nu inline of blok is, < 和 & beide symbolenAbsoluutworden geconverteerd naar HTML-entiteiten, een functie waarmee u eenvoudig HTML-code kunt schrijven in Markdown (in tegenstelling tot HTML, waar u alle < 和 & Ze worden allemaal geconverteerd naar HTML-entiteiten om HTML-code in het HTML-bestand te schrijven. )

blokelement

Alinea's en regeleinden

Een Markdown-alinea bestaat uit een of meer opeenvolgende regels tekst, voorafgegaan en gevolgd door meer dan één lege regel (de definitie van een lege regel is dat deze op het display leeg lijkt en als een lege regel wordt beschouwd). , als een regel alleen spaties en tabs bevat, wordt de regel ook als een lege regel behandeld).Normale alinea's mogen niet worden ingesprongen met spaties of tabs.

De uitdrukking "bestaat uit een of meer opeenvolgende regels tekst" houdt in feite in dat Markdown geforceerde nieuwe regels (invoeging van nieuwe regels) binnen alinea's toestaat, een functie die verschilt van de meeste andere tekst-naar-HTML-indelingen (inclusief Movable Type "Convert Line Breaks " optie), zullen andere formaten elke regeleinde converteren naar <br /> etiket.

als jijInderdaadWilt u op Markdown vertrouwen om in te voegen <br /> Druk voor labels op twee of meer spaties op de invoegplaats en druk vervolgens op Enter.

Het kost inderdaad wat meer werk (extra spaties) om te genereren <br /> , maar gewoon "elke nieuwe regel wordt geconverteerd naar <br />"De methode is niet geschikt in Markdown, em in MarkdownaiBlokcitaten in L-stijl en lijsten met meerdere alinea's zijn niet alleen nuttiger, maar ook gemakkelijker te lezen bij het zetten met regeleinden.

opschrift

Markdown ondersteunt twee syntaxis voor koppen, Setext-achtig en atx-achtig.

De Settext-achtige vorm is de vorm met de onderste regel, met behulp van = (hoogste titel) en - (Koppen van de tweede orde), bijvoorbeeld:

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

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

elk aantal = 和 - effectief kan zijn.

De Atx-achtige vorm voegt 1 tot 6 in aan het begin van de regel # , overeenkomend met de rubrieken 1 tot 6, bijvoorbeeld:

# 这是 H1

## 这是 H2

###### 这是 H6

Je kunt optioneel atx-achtige headers "sluiten", dit is puur voor de esthetiek, als je je op deze manier prettig voelt, kun je het aan het einde van de regel toevoegen #, terwijl de regel eindigt # Het nummer hoeft niet hetzelfde te zijn als het begin (het aantal hekjes aan het begin van de regel bepaalt de volgorde van de titel):

# 这是 H1 #

## 这是 H2 ##

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

Blokcitaten Blokcitaten

Markdown markup blockquotes worden gebruikt vergelijkbaar met die in e-mail > van citaten.Als u bekend bent met aanhalingstekens in e-mailbrieven, weet u hoe u een blokcitaat in een Markdown-bestand maakt, dat eruitziet alsof u de regels zelf breekt en vervolgens toevoegt > :

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

Met Markdown kun je ook lui zijn en alleen de eerste regel van de hele alinea toevoegen > :

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

Blokreferenties kunnen worden genest (bijv. referenties binnen referenties) door een ander aantal . toe te voegen > :

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

Andere Markdown-syntaxis kunnen ook worden gebruikt binnen blokken tussen aanhalingstekens, inclusief koppen, lijsten, codeblokken, enz.:

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

Elke fatsoenlijke teksteditor kan gemakkelijk citaten in e-mailstijl maken.In BBEdit kun je bijvoorbeeld tekst selecteren en vervolgens uit het menu kiezencitatiehiërarchie verhogen.

列表

Markdown ondersteunt zowel geordende als ongeordende lijsten.

Ongeordende lijsten gebruiken sterretjes, plustekens of mintekens als lijstmarkeringen:

*   Red
*   Green
*   Blue

Gelijk aan:

+   Red
+   Green
+   Blue

Ook gelijk aan:

-   Red
-   Green
-   Blue

Geordende lijsten gebruiken nummers gevolgd door een punt:

1.  Bird
2.  McHale
3.  Parish

Het is belangrijk op te merken dat de getallen die u gebruikt in de lijsttag geen invloed hebben op de HTML-uitvoer. De resulterende HTML-opmaak voor de bovenstaande lijst zou zijn:

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

Als uw lijstopmaak is geschreven als:

1.  Bird
1.  McHale
1.  Parish

of zelfs:

3. Bird
1. McHale
8. Parish

U krijgt allebei precies dezelfde HTML-uitvoer.Het punt is, je kunt de lijstnummers in het Markdown-bestand hetzelfde maken als de uitvoerresultaten, of als je lui bent, hoef je je helemaal geen zorgen te maken over de juistheid van de nummers.

Als je lui schrijft, is het aan te raden om te beginnen met 1. voor het eerste item, omdat Markdown in de toekomst het start-attribuut van geordende lijsten kan ondersteunen.

De item-tag in de lijst wordt meestal helemaal links geplaatst, maar kan worden ingesprongen, maximaal 3 spaties, en de item-tag moet worden gevolgd door ten minste één spatie of tab.

Om de lijst er mooier uit te laten zien, kunt u de inhoud ordenen met een vaste inspringing:

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

Maar als je lui bent, is dat ook goed:

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

Als de lijstitems worden gescheiden door lege regels, gebruikt Markdown de iteminhoud bij het uitvoeren van HTML. <p> Etiketten zijn verpakt, bijvoorbeeld:

*   Bird
*   Magic

wordt omgezet in:

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

Maar dit:

*   Bird

*   Magic

wordt omgezet in:

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

Lijstitems kunnen meerdere alinea's bevatten en de alinea's onder elk item moeten worden ingesprongen met 4 spaties of 1 tab:

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.

Het ziet er een stuk beter uit als je elke regel inspringt, natuurlijk, nogmaals, als je lui bent, staat Markdown ook toe:

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

Als u een verwijzing in een lijstitem wilt plaatsen, dan: > Het moet worden ingesprongen:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Als u een codeblok wilt plaatsen, moet het blok worden ingesprongen两次, dat is 8 spaties of 2 tabbladen:

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

        <代码写在这>

Natuurlijk kan er per ongeluk een lijst met items worden gegenereerd, ongeveer als volgt:

1986. What a great season.

Met andere woorden, het verschijnt aan het begin van de regelnummer-periode-leeg, om dit te voorkomen, kunt u een backslash vóór de punt toevoegen.

1986\. What a great season.

code blok

Programmagerelateerde schrijf- of tagtaalbroncode heeft meestal al gezette codeblokken. Gewoonlijk willen we niet dat deze blokken worden gezet op de manier van algemene paragraafbestanden, maar ze weergeven zoals ze zijn. Markdown zal gebruik maken van <pre> 和 <code> tags om codeblokken in te pakken.

Bouwstenen van code in Markdown is net zo eenvoudig als het inspringen van 4 spaties of 1 tabblad, voer bijvoorbeeld het volgende in:

这是一个普通段落：

    这是一个代码区块。

Markdown wordt geconverteerd naar:

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

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

Deze eerste-orde inspringing per regel (4 spaties of 1 tab) wordt verwijderd, bijvoorbeeld:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

wordt omgezet in:

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

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

Een codeblok gaat door tot de niet-ingesprongen regel (of het einde van het bestand).

Binnen het codeblok, & , < 和 > Het wordt automatisch geconverteerd naar HTML-entiteiten. Deze methode maakt het voor u heel gemakkelijk om Markdown te gebruiken om de HTML-broncode voor het voorbeeld in te voegen, gewoon kopiëren en plakken, inspringen toevoegen, en de rest zal Markdown het voor u afhandelen, voor voorbeeld:

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

wordt omgezet in:

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

In het codeblok wordt de algemene Markdown-syntaxis niet geconverteerd, zoals sterretjes zijn gewoon sterretjes, wat betekent dat u eenvoudig Markdown-syntaxisgerelateerde bestanden in Markdown-syntaxis kunt schrijven.

scheidingslijn

U kunt meer dan drie sterretjes, mintekens, onderstrepingstekens op een regel gebruiken om een ​​scheidingslijn te maken, niets anders in de regel.U kunt ook spaties tussen sterretjes of mintekens invoegen.Elk van de volgende notaties kan een deler creëren:

* * *

***

*****

- - -

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

sectie-element

链接

Markdown ondersteunt twee vormen van linksyntaxis: In lijn和Referentietwee vormen.

Hoe dan ook, linktekst is gemarkeerd met [vierkante haken].

een makenIn lijnAls u de titeltekst van de link wilt toevoegen, plaatst u de titeltekst gewoon tussen dubbele aanhalingstekens na de URL, bijvoorbeeld:

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

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

Zal produceren:

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

Als u naar bronnen op dezelfde host linkt, kunt u relatieve paden gebruiken:

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

ReferentieDe link wordt gevolgd door nog een vierkante haak na de haak van de linktekst, en het teken dat wordt gebruikt om de link te identificeren, moet in de tweede vierkante haak worden ingevuld:

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

U kunt optioneel ook een spatie tussen de twee vierkante haken plaatsen:

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

Vervolgens kunt u overal in het bestand de linkinhoud van deze tag definiëren:

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

Link inhoud wordt gedefinieerd in de vorm:

• Vierkante haken (optioneel voorafgegaan door maximaal drie spaties voor inspringing) waarin linktekst wordt ingevoerd
• gevolgd door een dubbele punt
• gevolgd door een of meer spaties of tabs
• de URL van de volgende link
• Volg optioneel de titelinhoud, die tussen enkele aanhalingstekens, dubbele aanhalingstekens of haakjes kan worden geplaatst

De definities van de volgende drie links zijn hetzelfde:

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

voorzichtigheid:Er is een bekend probleem waarbij Markdown.pl 1.0.1 linktitels negeert die tussen enkele aanhalingstekens staan.

Link-URL's kunnen ook tussen punthaken worden geplaatst:

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

Je kunt ook het title-attribuut op de volgende regel plaatsen, of wat inspringing toevoegen, wat er beter uitziet als de URL te lang is:

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

De URL-definitie wordt alleen gebruikt bij het genereren van de link en verschijnt niet direct in het bestand.

Identificatietags voor links kunnen letters, cijfers, spaties en leestekens bevatten, maar dat is niet het gevalnietHet is hoofdlettergevoelig, dus de volgende twee links zijn hetzelfde:

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

Impliciete linktagMet deze functie kunt u het specificeren van een linktag weglaten. In dit geval wordt de linktag behandeld als equivalent aan de linktekst. Als u een impliciete linktag wilt gebruiken, voegt u een leeg vierkant haakje toe na de linktekst. Als u wilt dat "Google " Als u naar google.com linkt, kunt u vereenvoudigen tot:

[Google][]

Definieer vervolgens de inhoud van de link:

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

Aangezien linktekst witruimte kan bevatten, kan deze vereenvoudigde opmaak meerdere woorden bevatten:

Visit [Daring Fireball][] for more information.

Ga dan verder met het definiëren van de link:

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

De definitie van de link kan overal in het bestand worden geplaatst. Ik plaats deze het liefst direct na de alinea waar de link verschijnt. Je kunt hem ook aan het einde van het bestand plaatsen, net als een opmerking.

Hier is een voorbeeld van een referentielink:

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"

Als u het wijzigt om de linknaam te gebruiken om te schrijven:

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"

De bovenstaande twee manieren van schrijven zullen de volgende HTML opleveren.

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

Hieronder staat een Markdown-bestand met dezelfde inhoud die inline is geschreven, ter vergelijking:

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

In feite is het punt van links in referentiestijl niet dat het gemakkelijker te schrijven is, maar dat het gemakkelijker te lezen is. Vergelijk het bovenstaande voorbeeld. Het artikel in referentiestijl zelf is slechts 81 tekens, maar de inline-vorm zal toenemen tot 176 tekens. , als het in pure HTML-indeling is geschreven, zijn er 234 tekens. In HTML-indeling zijn er meer tags dan tekst.

Door Markdown's referentie-achtige links te gebruiken, kunt u het document meer op het uiteindelijke resultaat van de browser laten lijken, waardoor u enkele opmaakgerelateerde metadata buiten de alineatekst kunt verplaatsen, en u kunt links toevoegen zonder het leesgevoel van het artikel te maken. .

强调

Markdown gebruikt sterretjes (*) en de onderste regel (_) als symbool om een ​​onderstreept woord te markeren, is * 或 _ Omringde woorden worden geconverteerd naar <em> omgeven door labels, met twee * 或 _Als het is ingepakt, wordt het omgezet in <strong>,Bijvoorbeeld:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

zal veranderen in:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Je kunt elke stijl gebruiken die je leuk vindt, de enige beperking is dat je het symbool kunt gebruiken om de tag te openen en het symbool om het te beëindigen.

De nadruk kan ook direct in het midden van de tekst worden ingevoegd:

un*frigging*believable

maarals jouw * 和 _ Als er aan beide zijden witruimte is, worden ze gewoon als normale symbolen behandeld.

Om normale sterretjes of onderstrepingstekens direct voor en na tekst in te voegen, kunt u backslashes gebruiken:

\*this text is surrounded by literal asterisks\*

code

Als je een klein stukje inline code wilt markeren, kun je het in backticks plaatsen (`),Bijv.:

Use the `printf()` function.

Zal produceren:

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

Als u backticks in een codesectie wilt invoegen, kunt u de codesectie beginnen en eindigen met meerdere backticks:

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

Deze syntaxis levert:

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

U kunt een spatie aan het begin en einde van een codesectie plaatsen, één na het begin en één voor het einde, zodat u backticks aan het begin van de sectie kunt invoegen:

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

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

Zal produceren:

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

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

Binnen de codesectie,& en punthaken都automatisch wordt geconverteerd naar HTML-entiteiten, wat het gemakkelijk maakt om HTML-broncode in te voegen, Markdown zal de volgende paragraaf plaatsen:

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

tot:

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

Je kunt dit ook schrijven:

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

Produceren:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

图片

Het is duidelijk dat het moeilijk is om een ​​"natuurlijke" syntaxis te ontwerpen voor het invoegen van afbeeldingen in een teksttoepassing.

Markdown gebruikt een syntaxis die lijkt op koppelingen om afbeeldingen te markeren, en staat ook twee stijlen toe: In lijn和Referentie.

De inline-beeldsyntaxis ziet er als volgt uit:

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

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

De details zijn als volgt:

• een uitroepteken !
• gevolgd door vierkante haken met de alt-tekst voor de afbeelding
• Vervolgens een normale haak, plaats de URL van de afbeelding erin en plaats deze ten slotte tussen aanhalingstekens en voeg een optionele 'titel'-tekst toe.

De syntaxis van de referentieafbeelding ziet er als volgt uit:

![Alt text][id]

"id" is de naam van de afbeeldingsreferentie, die op dezelfde manier wordt gedefinieerd als een linkreferentie:

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

Tot nu toe heeft Markdown geen manier om de breedte en hoogte van de afbeelding te specificeren, als je dat nodig hebt, kun je de normale gebruiken <img> etiket.

其它

automatische koppeling

Markdown ondersteunt het verwerken van URL's en e-mailboxen in de vorm van relatief korte automatische links.Zolang ze tussen punthaken staan, zal Markdown deze automatisch omzetten in een link.De linktekst van de algemene URL is gelijk aan het linkadres, bijvoorbeeld:

<http://example.com/>

Markdown wordt geconverteerd naar:

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

Het automatisch koppelen van e-mailadressen is ook vergelijkbaar, behalve dat Markdown eerst een conversieproces voor codering uitvoert, waarbij teksttekens worden omgezet in hexadecimale HTML-entiteiten.Dit formaat kan sommige robots voor het verzamelen van slechte e-mailadressen voor de gek houden, zoals:

<[email protected]>

Markdown wordt:

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

In de browser is deze string (eigenlijk <a href="mailto:[email protected]">[email protected]</a>) wordt een klikbare "[email protected]"-link.

(Hoewel deze aanpak veel robots voor de gek kan houden, kan het ze niet allemaal stoppen, maar het is beter dan niets. In ieder geval zal het openen van je mailbox uiteindelijk reclamebrieven aantrekken.)

schuine streep

Markdown kan backslashes gebruiken om symbolen met een andere betekenis in de grammatica in te voegen, bijvoorbeeld: als u een asterisk naast de tekst wilt toevoegen om de nadruk te leggen (maar niet <em> tag), kunt u het sterretje voorafgaan met een backslash:

\*literal asterisks\*

Markdown ondersteunt de volgende symbolen voorafgegaan door een backslash om algemene symbolen in te voegen:

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

Markdown gratis editor

Windows-platform

• Markdown Pad
• MarkPad

Mac-platform

• Mou

online redacteur

• MPeditor

browser plug-in

• Markdown hier plug-in

*** Als er een betere gratis Markdown-editor is om aan te bevelen, let dan op feedbackChen Weiliang,Met dank!