Čo znamená Markdown? Ako používať označenie syntaxe/formátu Markdown?

MarkdownČo znamená?

Ako používať označenie syntaxe/formátu Markdown?

Prehľad

Markdown je ľahký značkovací jazyk, ktorý vytvoril John Gruber.

Umožňuje ľuďom „písať dokumenty vo formáte obyčajného textu, ktorý sa dá ľahko čítať a písať, a potom ich previesť na platné dokumenty XHTML (alebo HTML).

Jazyk absorboval mnohé funkcie značenia obyčajného textu, ktoré sa už nachádzajú v e-mailoch.

John Gruber vytvoril jazyk Markdown v roku 2004 v spolupráci s Aaronom Swartzom z veľkej časti na gramatike.Účelom jazyka je použiť „formát obyčajného textu, ktorý sa ľahko číta, ľahko píše a voliteľne sa konvertuje na platný XHTML (alebo HTML)“.

účel

Cieľom Markdown je byť „ľahko čitateľný a ľahko písaný“.

čitateľnosť, urobte to aj takInternetový marketing, používateľská skúsenosť je veľmi dôležitá.

Dokument napísaný v Markdown by sa mal dať publikovať priamo v obyčajnom texte a nemalo by sa zdať, že je zložený z mnohých značiek alebo formátovacích príkazov.

Syntax Markdown je ovplyvnená niektorými existujúcimi formátmi prevodu textu do HTML, vrátane Setext, atx, Textile, reStructuredText, Grutatext a EtText, ale najväčším zdrojom inšpirácie je e-mailový formát s obyčajným textom.

Stručne povedané, syntax Markdown je zložená zo symbolov, ktoré sú starostlivo vybrané a ich funkcie sú jasné na prvý pohľad.Napríklad: umiestnite okolo textu hviezdičky, aby vyzeral ako *zvýraznenie*.

Zoznamy v Markdown vyzerajú ako zoznamy. Blockquotes v Markdown naozaj vyzerajú ako citovanie kúsku textu, ako ste videli v e-mailoch.

Kompatibilné s HTML

Cieľom gramatiky Markdown je byť jazykom na písanie pre web.

Markdown nie je určený na to, aby nahradil HTML, ani sa mu ani nepriblížil, má veľmi málo typov syntaxe a zodpovedá len malej podmnožine značiek HTML. Markdown nebol navrhnutý tak, aby zjednodušil písanie HTML dokumentov.

HTML sa podľa mňa už ľahko píše. Myšlienkou Markdown je uľahčiť čítanie, písanie a menenie dokumentov. HTML je publikačný formát, Markdown je acopywritingpísaný formát.Ako taká syntax formátovania Markdown pokrýva len to, čo dokáže obyčajný text.

Značky, na ktoré sa nevzťahuje Markdown, je možné zapísať v HTML priamo do dokumentuWeb Propagáciakopírovať.Nie je potrebné to označovať ako HTML alebo Markdown, stačí pridať označenie priamo.

Len niektoré HTML blokové prvky, ktoré majú byť obmedzené – ako napr <div>,<table>,<pre>,<p> a iné značky, musia byť oddelené od ostatných oblastí obsahu prázdnymi riadkami pred a za a ich otváracie a uzatváracie značky nesmú byť odsadené tabulátormi alebo medzerami. Generátor Markdown je dostatočne inteligentný na to, aby nepridával zbytočné značky bloku HTML <p> Označenie.

Príklad je nasledujúci, pridanie tabuľky HTML do súboru Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Upozorňujeme, že syntax formátovania Markdown medzi značkami bloku HTML sa nespracuje.Napríklad, ak použijete štýl Markdown vo vnútri bloku HTML*强调*nebude mať žiadny účinok.

HTML sekcie (inline) tagy ako napr <span>,<cite>,<del> Dá sa voľne použiť v odsekoch, zoznamoch alebo nadpisoch Markdown.Podľa osobných zvyklostí môžete dokonca použiť značky HTML na formátovanie bez použitia formátu Markdown.Príklad: Ak dávate prednosť HTML <a> alebo <img> tagy, ktoré možno použiť priamo bez syntaxe odkazu alebo tagu obrázka, ktorú poskytuje Markdown.

Na rozdiel od blokových značiek HTML je syntax Markdown platná medzi značkami sekcií HTML.

Automatická konverzia špeciálnych znakov

V súboroch HTML sú dva znaky, ktoré vyžadujú špeciálne zaobchádzanie: < A & . < symboly sa používajú pre štartovacie značky,& Symboly sa používajú na označenie entít HTML, ak chcete len zobraziť prototyp týchto znakov, musíte použiť formulár entity, napr. < A &.

& Postavy sú obzvlášť mučivé pre tvorcov webových dokumentov, ak sa chystáte napísať „AT&T"musíš napísať"AT&T".v adrese URL & Postavy sú tiež prevedené.Napríklad chcete odkazovať na:

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

Konverziu adresy URL musíte napísať ako:

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

umiestniť do značky odkazu href vo vlastnostiach.Netreba dodávať, že sa to dá ľahko ignorovať a pravdepodobne ide o najväčší počet chýb zistených validáciou štandardov HTML.

Markdown vám umožňuje písať znaky prirodzene a stará sa o to, čo je potrebné previesť.ak použijete & Znak je súčasťou entity znakov HTML, ponechá sa tak, ako je, inak sa skonvertuje na &;.

Ak teda chcete do dokumentu vložiť symbol autorských práv ©, môžeš písať:

©

Markdown ho ponechá nedotknutý.A ak napíšete:

AT&T

Markdown to prevedie na:

AT&T

Podobná situácia nastáva aj v < notáciu, keďže Markdown umožňuje HTML kompatibilitu, ak zadáte < Symboly sa používajú ako oddeľovače pre značky HTML a Markdown na nich nevykoná žiadne konverzie, ale ak napíšete:

4 < 5

Markdown to prevedie na:

4 < 5

Treba však poznamenať, že v rámci rozsahu kódu, či už je to vložený alebo blokový, < A & oba symbolypre istotusú konvertované na HTML entity, čo je funkcia, ktorá vám umožňuje jednoducho písať HTML kód v Markdowne (na rozdiel od HTML, kde vkladáte všetky < A & Všetky sú konvertované do HTML entít, aby bolo možné zapísať HTML kód do HTML súboru. )

blokový prvok

Odseky a zalomenia riadkov

Odsek Markdown pozostáva z jedného alebo viacerých po sebe idúcich riadkov textu, pred ktorým a za ktorými nasleduje viac ako jeden prázdny riadok (definícia prázdneho riadku je taká, že sa na obrazovke javí ako prázdny a považuje sa za prázdny riadok. Napríklad , ak riadok obsahuje iba medzery a tabulátory, riadok bude tiež považovaný za prázdny riadok).Normálne odseky by nemali byť odsadené medzerami alebo tabulátormi.

Fráza „pozostáva z jedného alebo viacerých po sebe idúcich riadkov textu“ v skutočnosti znamená, že Markdown umožňuje vynútené zalomenie riadkov (vkladanie nových riadkov) v odsekoch, čo je funkcia, ktorá sa líši od väčšiny ostatných formátov textu na HTML (vrátane pohyblivého typu „Previesť riadok Prestávky"), ostatné formáty skonvertujú každý zlom riadka na <br /> Označenie.

Ak tynaozajPri vkladaní sa chcete spoľahnúť na Markdown <br /> V prípade štítkov stlačte dve alebo viac medzier na mieste vloženia a potom stlačte kláves Enter.

V skutočnosti to vyžaduje trochu viac práce (ďalšie priestory) na vytvorenie <br /> , ale jednoducho „každý nový riadok sa prevedie na <br />"Táto metóda nie je vhodná v Markdown, em v MarkdownaiBlokové úvodzovky v štýle L a zoznamy s viacerými odsekmi sú nielen užitočnejšie, ale aj ľahšie čitateľné pri sadzbe so zalomením riadkov.

titulok

Markdown podporuje dve syntaxe pre nadpisy, Setext-like a atx-like.

Formulár podobný Settextu je formulár so spodným riadkom pomocou = (najvyšší titul) a - (nadpisy druhého rádu), napríklad:

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

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

akúkoľvek sumu = A - môžu byť účinné.

Formulár podobný Atx vkladá 1 až 6 na začiatok riadku # , zodpovedajúce položkám 1 až 6, napríklad:

# 这是 H1

## 这是 H2

###### 这是 H6

Môžete voliteľne "uzavrieť" hlavičky podobné atx, je to čisto pre estetiku, ak sa tak cítite pohodlne, môžete to pridať na koniec riadku #, pričom riadok končí # Číslo sa nemusí zhodovať so začiatkom (počet librových znakov na začiatku riadku určuje poradie nadpisu):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Blokové úvodzovky markdown sa používajú podobne ako v e-mailoch > citácií.Ak poznáte úvodzovky v e-mailových listoch, viete, ako vytvoriť blokovú citáciu v súbore Markdown, ktorá by vyzerala, akoby ste riadky prelomili sami, a potom pridajte > :

> 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ám tiež umožňuje byť lenivý a pridať len prvý riadok z celého odseku > :

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

Odkazy na bloky môžu byť vnorené (napr.: odkazy v rámci referencií) pridaním iného počtu > :

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

Ďalšie syntaxe Markdown možno použiť aj v rámci blokov v úvodzovkách, vrátane nadpisov, zoznamov, blokov kódu atď.:

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

Každý slušný textový editor môže ľahko vytvárať citácie v štýle e-mailu.Napríklad v BBEdit môžete vybrať text a potom vybrať z ponukyzvýšiť hierarchiu citácií.

Zoznam

Markdown podporuje usporiadané a neusporiadané zoznamy.

Nezoradené zoznamy používajú ako značky zoznamu hviezdičky, znamienka plus alebo mínus:

*   Red
*   Green
*   Blue

Ekvivalent k:

+   Red
+   Green
+   Blue

Rovnaké ako:

-   Red
-   Green
-   Blue

Zoradené zoznamy používajú čísla, za ktorými nasleduje bodka:

1.  Bird
2.  McHale
3.  Parish

Je dôležité si uvedomiť, že čísla, ktoré použijete v značke zoznamu, neovplyvňujú výstupný kód HTML. Výsledné označenie HTML pre vyššie uvedený zoznam bude:

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

Ak je vaše označenie zoznamu napísané takto:

1.  Bird
1.  McHale
1.  Parish

alebo dokonca:

3. Bird
1. McHale
8. Parish

Obaja získate presne rovnaký výstup HTML.Ide o to, že čísla zoznamu v súbore Markdown môžete urobiť rovnako ako výstupné výsledky, alebo ak ste leniví, nemusíte sa o správnosť čísel vôbec starať.

Ak používate lenivé písanie, odporúča sa začať od 1. pri prvej položke, pretože Markdown môže v budúcnosti podporovať štartový atribút zoradených zoznamov.

Značka položky zoznamu je zvyčajne umiestnená úplne vľavo, ale môže byť odsadená až o 3 medzery a za značkou položky musí nasledovať aspoň jedna medzera alebo tabulátor.

Ak chcete, aby zoznam vyzeral krajšie, môžete obsah usporiadať pevným odsadením:

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

Ale ak ste leniví, je to tiež v poriadku:

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

Ak sú položky zoznamu oddelené prázdnymi riadkami, Markdown použije obsah položky pri výstupe HTML. <p> Štítky sú zabalené, napríklad:

*   Bird
*   Magic

bude prevedené na:

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

Ale toto:

*   Bird

*   Magic

bude prevedené na:

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

Položky zoznamu môžu obsahovať viacero odsekov a odseky pod každou položkou musia byť odsadené o 4 medzery alebo 1 tabulátor:

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.

Vyzerá to oveľa lepšie, ak odsadíte každý riadok, samozrejme, opäť, ak ste leniví, Markdown tiež umožňuje:

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

Ak chcete vložiť odkaz do položky zoznamu, potom > Je potrebné odsadiť:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ak chcete vložiť blok kódu, blok musí byť odsadenýdvakrát, čo je 8 medzier alebo 2 tabulátory:

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

        <代码写在这>

Samozrejme, zoznam položiek sa môže vygenerovať náhodne, napríklad takto:

1986. What a great season.

Inými slovami, zobrazí sa na začiatku riadkučíslo-bodka-prázdne, aby ste tomu zabránili, môžete pred bodku pridať spätnú lomku.

1986\. What a great season.

blok kódu

Zdrojový kód programového písania alebo jazyka tagov má zvyčajne bloky kódu, ktoré už boli sázené. Zvyčajne nechceme, aby sa tieto bloky vysádzali spôsobom všeobecných súborov odsekov, ale zobrazujeme ich tak, ako sú. Markdown použije <pre> A <code> značky na zalomenie blokov kódu.

Vytváranie blokov kódu v Markdown je také jednoduché ako odsadenie 4 medzier alebo 1 tabulátora. Zadajte napríklad:

这是一个普通段落：

    这是一个代码区块。

Markdown sa prevedie na:

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

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

Toto odsadenie prvého poriadku na riadok (4 medzery alebo 1 tabulátor) sa odstráni, napríklad:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

bude prevedené na:

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

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

Blok kódu pokračuje až po neodsadený riadok (alebo koniec súboru).

Vo vnútri bloku kódu, & , < A > Automaticky sa skonvertuje na entity HTML. Táto metóda vám veľmi uľahčuje použitie Markdown na vloženie zdrojového kódu HTML pre príklad, stačí ho skopírovať a prilepiť, pridať odsadenie a zvyšok Markdown spraví za vás. príklad:

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

bude prevedené na:

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

V bloku kódu sa všeobecná syntax Markdown neprevedie, napríklad hviezdičky sú len hviezdičky, čo znamená, že súbory súvisiace so syntaxou Markdown môžete jednoducho zapisovať v syntaxi Markdown.

rozdeľovač

Na vytvorenie oddeľovača v riadku môžete použiť viac ako tri hviezdičky, znamienka mínus, podčiarkovníky, nič iné v riadku.Môžete tiež vložiť medzery medzi hviezdičky alebo znamienka mínus.Oddeľovacie čiary je možné vytvoriť každým z nasledujúcich spôsobov písania:

* * *

***

*****

- - -

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

oddielový prvok

odkaz

Markdown podporuje dve formy syntaxe odkazu: V radeAOdkazdve formy.

V každom prípade je text odkazu označený [hranaté zátvorky].

vytvoriť aV radeAk chcete pridať text nadpisu odkazu, stačí zabaliť text nadpisu do dvojitých úvodzoviek za adresu URL, napríklad:

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

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

Vyrobí:

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

Ak sa pripájate k zdrojom na rovnakom hostiteľovi, môžete použiť relatívne cesty:

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

OdkazZa odkazom nasleduje ďalšia hranatá zátvorka za zátvorkou textu odkazu a značka použitá na identifikáciu odkazu by mala byť vyplnená v druhej hranatej zátvorke:

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

Môžete tiež voliteľne vložiť medzeru medzi dve hranaté zátvorky:

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

Potom môžete kdekoľvek v súbore definovať obsah odkazu tejto značky:

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

Obsah odkazu je definovaný vo forme:

• Hranaté zátvorky (voliteľne pred nimi až tri medzery na odsadenie), do ktorých sa zadáva text odkazu
• nasleduje dvojbodka
• nasleduje jedna alebo viacero medzier alebo tabulátorov
• adresu URL nasledujúceho odkazu
• Voliteľne postupujte podľa obsahu názvu, ktorý môže byť uzavretý v jednoduchých úvodzovkách, dvojitých úvodzovkách alebo zátvorkách

Definície nasledujúcich troch odkazov sú rovnaké:

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

Upozornenie:Existuje známy problém, kedy Markdown.pl 1.0.1 ignoruje názvy odkazov v jednoduchých úvodzovkách.

Adresy URL odkazov môžu byť tiež uzavreté v lomených zátvorkách:

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

Môžete tiež umiestniť atribút title na ďalší riadok alebo pridať nejaké odsadenie, ktoré bude vyzerať lepšie, ak je adresa URL príliš dlhá:

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

Definícia URL sa používa iba pri generovaní odkazu a nezobrazuje sa priamo v súbore.

Identifikačné značky odkazu môžu obsahovať písmená, čísla, medzery a interpunkciu, ale nienieRozlišuje sa veľké a malé písmená, takže nasledujúce dva odkazy sú rovnaké:

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

Implicitná značka odkazufunkcia vám umožňuje vynechať špecifikovanie značky odkazu. V tomto prípade sa bude so značkou odkazu zaobchádzať ako s textom odkazu. Ak chcete použiť implicitnú značku odkazu, stačí za text odkazu pridať prázdnu hranatú zátvorku. Ak chcete „Google Prepojenie s google.com môžete zjednodušiť na:

[Google][]

Potom definujte obsah odkazu:

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

Keďže text odkazu môže obsahovať medzery, toto zjednodušené označenie môže obsahovať viacero slov:

Visit [Daring Fireball][] for more information.

Potom pokračujte v definovaní odkazu:

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

Definíciu odkazu je možné umiestniť kdekoľvek v súbore. Radšej ju dávam priamo za odsek, kde je odkaz, môžete ju dať aj na koniec súboru, ako komentár.

Tu je príklad referenčného odkazu:

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"

Ak ho zmeníte tak, aby na písanie používal názov odkazu:

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"

Vyššie uvedené dva spôsoby zápisu vytvoria nasledujúci 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>

Nižšie je uvedený súbor Markdown s rovnakým obsahom napísaným inline, ktorý je poskytnutý na porovnanie:

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

Pointa odkazov v štýle odkazov v skutočnosti nespočíva v tom, že sa ľahšie píšu, ale v tom, že sa ľahšie čítajú. Porovnajte vyššie uvedený príklad. Samotný článok v štýle odkazu má iba 81 znakov, ale vložený formulár sa zväčší na 176 znakov. , ak je napísaný v čistom formáte HTML, znakov bude 234. Vo formáte HTML je viac značiek ako textu.

Použitie odkazov v štýle odkazov v Markdown môže urobiť dokument viac podobným konečnému výsledku prehliadača, čo vám umožní presunúť niektoré metadáta súvisiace so značkami mimo textu odseku a môžete pridať odkazy bez toho, aby ste prerušili prečítanie článku.

强调

Markdown používa hviezdičky (*) a spodný riadok (_) ako symbol na označenie podčiarknutého slova je * alebo _ Okolité slová sa skonvertujú na <em> obklopený štítkami, s dvoma * alebo _Ak je zabalené, skonvertuje sa na <strong>,Napr.:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

sa zmení na:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Môžete použiť akýkoľvek štýl, ktorý sa vám páči, jediným obmedzením je, že môžete použiť symbol na otvorenie značky a symbol na jej ukončenie.

Dôraz je možné vložiť aj priamo do stredu textu:

un*frigging*believable

aleAk tvoj * A _ Ak sú na oboch stranách medzery, považujú sa za bežné symboly.

Ak chcete vložiť normálne hviezdičky alebo podčiarkovníky priamo pred a za text, môžete použiť spätné lomky:

\*this text is surrounded by literal asterisks\*

Zákonníka

Ak chcete označiť malý kúsok vloženého kódu, môžete ho zabaliť do spätných značiek (`),Napr.:

Use the `printf()` function.

Vyrobí:

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

Ak chcete vložiť spätné začiarknutia do sekcie kódu, môžete sekciu kódu začať a ukončiť viacerými spätnými začiarknutiami:

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

Táto syntax vytvára:

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

Na začiatok a koniec časti kódu môžete vložiť medzeru, jednu za začiatok a jednu pred koniec, takže na začiatok časti môžete vložiť spätné značky:

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

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

Vyrobí:

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

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

Vo vnútri sekcie kódu& a uhlové konzoly都sa automaticky skonvertujú na entity HTML, čo uľahčuje vkladanie zdrojového kódu HTML, Markdown vloží nasledujúci odsek:

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

komu:

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

Môžete napísať aj toto:

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

Na výrobu:

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

图片

Je zrejmé, že je ťažké navrhnúť „prirodzenú“ syntax na vkladanie obrázkov do textovej aplikácie.

Markdown používa na označenie obrázkov syntax podobnú syntaxi odkazov a tiež umožňuje dva štýly: V radeAOdkaz.

Syntax vloženého obrázka vyzerá takto:

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

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

Podrobnosti sú nasledovné:

• výkričník !
• nasleduje hranatá zátvorka s alternatívnym textom obrázka
• Potom nasledujú normálne zátvorky s URL obrázku a nakoniec voliteľný text „title“ uzavretý v úvodzovkách.

Syntax referenčného obrázka vyzerá takto:

![Alt text][id]

„id“ je názov odkazu na obrázok, ktorý je definovaný rovnakým spôsobom ako odkaz na odkaz:

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

Markdown zatiaľ nemá ako určiť šírku a výšku obrázku, ak potrebujete, môžete použiť normálne <img> Označenie.

其它

automatické prepojenie

Markdown podporuje spracovanie URL adries a e-mailových schránok vo forme relatívne krátkych automatických odkazov.Pokiaľ sú uzavreté v lomených zátvorkách, Markdown ich automaticky prevedie na odkaz.Text odkazu všeobecnej adresy URL je rovnaký ako adresa odkazu, napríklad:

<http://example.com/>

Markdown sa skonvertuje na:

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

Automatické prepojenie e-mailových adries je tiež podobné, až na to, že Markdown najskôr vykoná proces prevodu kódovania, pričom prevedie textové znaky na hexadecimálne entity HTML. Tento formát môže oklamať niektoré zlé roboty na zhromažďovanie e-mailových adries, ako napríklad:

<[email protected]>

Markdown sa zmení na:

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

V prehliadači tento reťazec (v skutočnosti <a href="mailto:[email protected]">[email protected]</a>) sa stane kliknutím na odkaz „[email protected]“.

(Tento prístup síce dokáže oklamať veľa roboty, nedokáže ich všetkých zastaviť, no je to lepšie ako nič. V každom prípade otvorenie poštovej schránky nakoniec priláka reklamné listy.)

spätné lomítko

Markdown môže použiť spätné lomky na vloženie symbolov, ktoré majú v gramatike iný význam, napríklad: ak chcete pridať hviezdičku vedľa textu na zvýraznenie (ale nie <em> tag), môžete pred hviezdičku uviesť opačnú lomku:

\*literal asterisks\*

Markdown podporuje nasledujúce symboly, pred ktorými je obrátená lomka, aby sa uľahčilo vkladanie bežných symbolov:

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

Bezplatný editor Markdown

platforma Windows

• MarkdownPad
• MarkPad

platforma Mac

• mäkký

online editor

• MPEditor

plugin prehliadača

• Markdown here plugin

*** Ak existuje lepší bezplatný editor Markdown, ktorý môžete odporučiť, venujte pozornosť spätnej väzbeChen Weiliang,Vďaka!