Ko nozīmē Markdown? Kā lietot Markdown sintaksi/formatēšanas marķējumu?

MarkdownKo nozīmē?

Kā lietot Markdown sintakses/formatēšanas marķējumu?

Pārskats

Markdown ir viegla iezīmēšanas valoda, ko izveidojis Džons Grūbers.

Tas ļauj cilvēkiem "rakstīt dokumentus vienkārša teksta formātā, ko ir viegli lasīt un rakstīt, un pēc tam pārvērst tos derīgos XHTML (vai HTML) dokumentos".

Valoda ietver daudzas vienkārša teksta iezīmēšanas funkcijas, kas jau ir atrodamas e-pastā.

Džons Grūbers Markdown valodu izveidoja 2004. gadā, sadarbojoties ar Āronu Svarcu, lielākoties sintakses jomā.Valodas mērķis ir izmantot "vienkāršā teksta formātu, kas ir viegli lasāms, viegli rakstāms un pēc izvēles tiek pārveidots par derīgu XHTML (vai HTML)".

mērķis

Markdown mērķis ir būt "viegli lasāmam un viegli rakstāmam".

lasāmība, dariet to jebkurā gadījumāInterneta mārketings, lietotāja pieredze ir ļoti svarīga.

Dokumentu, kas rakstīts programmā Markdown, vajadzētu būt iespējai publicēt tieši vienkāršā tekstā, un tam nevajadzētu izskatīties sastāvam no daudziem tagiem vai formatēšanas direktīvām.

Markdown sintaksi ietekmē daži esošie teksta-HTML formāti, tostarp Setext, atx, Textile, reStructuredText, Grutatext un EtText, taču lielākais iedvesmas avots ir vienkārša teksta e-pasta formāts.

Īsāk sakot, Markdown sintakse sastāv no simboliem, kas ir rūpīgi atlasīti un to funkcijas ir skaidras vienā mirklī.Piemēram: ievietojiet zvaigznītes ap tekstu, lai tas izskatītos kā *uzsvars*.

Markdown saraksti izskatās kā saraksti. Bloķētie citāti pakalpojumā Markdown patiešām izskatās kā teksta daļas citēšana, kā jūs esat redzējis e-pastos.

Savietojams ar HTML

Markdown gramatikas mērķis ir būt par rakstīšanas valodu tīmeklim.

Markdown nav paredzēts, lai aizstātu HTML vai pat tuvotos tam, tam ir ļoti maz sintakses veidu un tas atbilst tikai nelielai HTML iezīmēšanas apakškopai. Markdown nebija paredzēts, lai atvieglotu HTML dokumentu rakstīšanu.

Manuprāt, HTML jau ir viegli rakstīt. Markdown ideja ir atvieglot dokumentu lasīšanu, rakstīšanu un mainīšanu pēc vēlēšanās. HTML ir publicēšanas formāts, Markdown ir atekstu rakstīšanarakstisks formāts.Tādējādi Markdown formatēšanas sintakse aptver tikai to, ko spēj vienkāršs teksts.

Tagus, uz kuriem neattiecas Markdown, var ierakstīt HTML valodā tieši dokumentāTīmekļa veicināšanakopiju.Nav nepieciešams to atzīmēt kā HTML vai Markdown; vienkārši pievienojiet marķējumu tieši.

Ierobežojami tikai daži HTML bloka elementi - piemēram, <div>,<table>,<pre>,<p> un citi tagi, tie ir jāatdala no citiem satura apgabaliem ar tukšām rindiņām pirms un pēc, un to sākuma un aizvēršanas atzīmes nedrīkst būt ievilktas ar tabulēšanas zīmēm vai atstarpēm. Markdown ģenerators ir pietiekami gudrs, lai nepievienotu nevajadzīgus HTML bloku tagus <p> Etiķete.

Piemērs ir šāds, Markdown failam pievienojot HTML tabulu:

这是一个普通段落。

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

这是另一个普通段落。

Ņemiet vērā, ka Markdown formatēšanas sintakse starp HTML bloka tagiem netiks apstrādāta.Piemēram, ja HTML blokos izmantojat Markdown stilu*强调*nebūs nekādas ietekmes.

HTML sadaļas (iekļautās) tagus, piemēram, <span>,<cite>,<del> Var brīvi izmantot Markdown rindkopās, sarakstos vai virsrakstos.Saskaņā ar personīgajiem ieradumiem jūs pat varat izmantot HTML tagus, lai formatētu, neizmantojot Markdown formātu.Piemērs: ja vēlaties HTML <a> Vai <img> tagus, kurus var izmantot tieši bez saites vai attēla tagu sintakses, ko nodrošina Markdown.

Atšķirībā no HTML bloka tagiem, Markdown sintakse ir derīga starp HTML sadaļu tagiem.

Speciālo rakstzīmju automātiska konvertēšana

HTML failos ir divas rakstzīmes, kurām nepieciešama īpaša apstrāde: < 和 & . < sākuma tagiem tiek izmantoti simboli,& Simboli tiek izmantoti, lai atzīmētu HTML entītijas, ja vēlaties tikai parādīt šo rakstzīmju prototipu, jums ir jāizmanto entītijas forma, piemēram, < 和 &.

& Rakstzīmes ir īpaši mokošas tīmekļa dokumentu rakstītājiem, ja vēlaties rakstīt "AT&T"Jums jāraksta"AT&T".atrodoties URL & Tiek pārveidotas arī rakstzīmes.Piemēram, vēlaties izveidot saiti uz:

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

URL konvertēšana ir jāraksta šādi:

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

jāievieto saites tagā href īpašumos.Lieki piebilst, ka to ir viegli ignorēt un, iespējams, lielākais kļūdu skaits, ko atklāj HTML standartu validācija.

Markdown ļauj rakstīt rakstzīmes dabiski, un tā rūpējas par to, kas ir jāpārvērš.ja lietojat & Rakstzīme ir daļa no HTML rakstzīmju entītijas, tā tiek atstāta tāda, kāda tā ir, pretējā gadījumā tā tiek pārveidota par &;.

Tātad, ja vēlaties dokumentā ievietot autortiesību simbolu ©, varat rakstīt:

©

Markdown to atstās neskartu.Un ja tu raksti:

AT&T

Markdown to pārveidos par:

AT&T

Līdzīga situācija rodas arī < apzīmējums, jo Markdown pieļauj HTML saderību, ja ievietojat < Simboli tiek izmantoti kā HTML tagu atdalītāji, un Markdown neveic nekādus reklāmguvumus uz tiem, taču, ja rakstāt:

4 < 5

Markdown to pārveidos par:

4 < 5

Tomēr jāņem vērā, ka koda ietvaros neatkarīgi no tā, vai tas ir iekļauts vai bloks, < 和 & abi simbolinoteiktitiek pārveidoti par HTML entītijām — līdzekli, kas ļauj ērti ierakstīt HTML kodu programmā Markdown (pretstatā HTML, kur jūs ievietojat visus < 和 & Visi tiek pārveidoti par HTML entītijām, lai HTML failā ierakstītu HTML kodu. )

bloka elements

Rindkopas un rindu pārtraukumi

Markdown rindkopa sastāv no vienas vai vairākām secīgām teksta rindiņām, pirms un pēc tām ir vairāk nekā viena tukša rindiņa (tukšas rindiņas definīcija ir tāda, ka displejā tā šķiet tukša un tiek uzskatīta par tukšu rindiņu. Piemēram, , ja rindā ir tikai atstarpes un tabulēšanas zīmes, rindiņa arī tiks uzskatīta par tukšu rindu).Parastās rindkopās nedrīkst būt atkāpes ar atstarpēm vai tabulēšanas zīmēm.

Frāze "sastāv no vienas vai vairākām secīgām teksta rindiņām" faktiski nozīmē, ka Markdown pieļauj piespiedu rindiņu ievadīšanu (jaunu rindiņu ievietošanu) rindkopās, kas atšķiras no vairuma citu teksta-HTML formātu (tostarp pārvietojamā tipa "Convert Line Breaks". " opciju), citos formātos katrs rindiņas pārtraukums tiks pārvērsts par <br /> Etiķete.

Ja jūspatiešāmVēlaties paļauties uz Markdown ievietošanu <br /> Lai iegūtu etiķetes, ievietošanas vietā nospiediet divas vai vairākas atstarpes un pēc tam nospiediet taustiņu Enter.

Patiešām, ģenerēšanai ir nepieciešams nedaudz vairāk darba (papildu atstarpes). <br /> , bet vienkārši "katra jaunā rindiņa tiek pārveidota par <br />"Metode nav piemērota Markdown, em MarkdownaiL-veida citāti un vairāku rindkopu saraksti ir ne tikai noderīgāki, bet arī vieglāk lasāmi, veicot salikumu ar rindiņu pārtraukumiem.

Nosaukums

Markdown atbalsta divas virsrakstu sintakses — Setext un atx.

Settext līdzīgā forma ir forma ar apakšējo rindiņu, izmantojot = (augstākais tituls) un - (Otrās kārtas virsraksti), piemēram:

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

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

jebkura summa = 和 - var būt efektīva.

Atx līdzīgā forma rindas sākumā ievieto no 1 līdz 6 # , kas atbilst 1. līdz 6. virsrakstiem, piemēram:

# 这是 H1

## 这是 H2

###### 这是 H6

Pēc izvēles varat "aizvērt" atx līdzīgas galvenes, tas ir tikai estētikas dēļ, ja jūtaties ērti, varat pievienot rindas beigās #, savukārt rindu galotnes # Skaitlim nav jābūt tādam pašam kā sākumam (mārciņu rakstzīmju skaits rindas sākumā nosaka virsraksta secību):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Marķējuma atzīmju bloka pēdiņas tiek izmantotas līdzīgi kā e-pastā > no citātiem.Ja esat iepazinies ar citātiem e-pasta vēstulēs, jūs zināt, kā Markdown failā izveidot bloka citātu, kas izskatītos tā, it kā jūs pats lauztu rindiņas, pēc tam pievienojiet > :

> 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 arī ļauj būt slinkam un pievienot tikai visas rindkopas pirmo rindiņu > :

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

Bloku atsauces var ligzdot (piemēram, atsauces atsaucēs), pievienojot citu skaitu > :

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

Citas Markdown sintakses var izmantot arī citētos blokos, tostarp virsrakstos, sarakstos, kodu blokos utt.:

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

Jebkurš pienācīgs teksta redaktors var viegli izveidot e-pasta stila citātus.Piemēram, programmā BBEdit varat atlasīt tekstu un pēc tam izvēlēties no izvēlnespalielināt citēšanas hierarhiju.

Saraksts

Markdown atbalsta sakārtotus un nesakārtotus sarakstus.

Nesakārtotos sarakstos kā saraksta marķieri tiek izmantotas zvaigznītes, pluszīmes vai mīnuszīmes:

*   Red
*   Green
*   Blue

Līdzvērtīgs:

+   Red
+   Green
+   Blue

Arī līdzvērtīgs:

-   Red
-   Green
-   Blue

Sakārtotajos sarakstos tiek izmantoti skaitļi, kam seko punkts:

1.  Bird
2.  McHale
3.  Parish

Ir svarīgi ņemt vērā, ka skaitļi, ko izmantojat saraksta tagā, neietekmē izvades HTML. Rezultātā iepriekš norādītā saraksta HTML marķējums būs šāds:

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

Ja jūsu saraksta marķējums ir rakstīts šādi:

1.  Bird
1.  McHale
1.  Parish

vai pat:

3. Bird
1. McHale
8. Parish

Jūs abi iegūsit tieši tādu pašu HTML izvadi.Lieta ir tāda, ka Markdown failā esošos saraksta numurus varat padarīt tādus pašus kā izvades rezultātus, vai arī, ja esat slinks, jums vispār nav jārūpējas par skaitļu pareizību.

Ja izmantojat slinku rakstīšanu, ieteicams pirmajam vienumam sākt ar 1., jo Markdown turpmāk var atbalstīt sakārtoto sarakstu sākuma atribūtu.

Saraksta vienuma atzīme parasti tiek novietota kreisajā malā, taču tajā var būt atkāpe, līdz 3 atstarpēm, un aiz vienuma taga ir jābūt vismaz vienai atstarpei vai tabulēšanai.

Lai saraksts izskatītos skaistāks, varat sakārtot saturu ar fiksētu atkāpi:

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

Bet, ja esat slinks, arī tas ir labi:

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

Ja saraksta vienumi ir atdalīti ar tukšām rindām, Markdown izmantos vienuma saturu, izvadot HTML. <p> Etiķetes tiek iesaiņotas, piemēram:

*   Bird
*   Magic

tiks pārveidots par:

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

Bet šis:

*   Bird

*   Magic

tiks pārveidots par:

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

Saraksta vienumi var saturēt vairākas rindkopas, un rindkopām zem katra vienuma jābūt atkāpēm ar 4 atstarpēm vai 1 tabulēšanas zīmi:

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.

Tas izskatās daudz labāk, ja katru rindiņu ievietojat atkāpē, protams, atkal, ja esat slinks, Markdown atļauj arī:

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

Ja vēlaties saraksta vienumā ievietot atsauci, tad > Tam ir jābūt atkāpei:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Ja vēlaties ievietot koda bloku, blokam ir jābūt atkāpeidivreiz, kas ir 8 atstarpes vai 2 tabulēšanas zīmes:

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

        <代码写在这>

Protams, vienumu saraksts var tikt izveidots nejauši, piemēram:

1986. What a great season.

Citiem vārdiem sakot, tas parādās rindas sākumāskaitlis-punkts-tukšs, lai no tā izvairītos, pirms punkta varat pievienot slīpsvītru.

1986\. What a great season.

koda bloks

Ar programmu saistītajā rakstīšanas vai tagu valodas avota kodā parasti jau ir rakstīti koda bloki. Parasti mēs nevēlamies, lai šie bloki tiktu drukāti kā vispārīgi rindkopu faili, bet tiktu rādīti tādi, kādi tie ir. Markdown izmantos <pre> 和 <code> tagus koda bloku iesaiņošanai.

Koda bloku izveide programmā Markdown ir tikpat vienkārša kā 4 atstarpju vai 1 tabulēšanas atkāpe. Piemēram, ievadiet šo:

这是一个普通段落：

    这是一个代码区块。

Markdown tiks pārveidots par:

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

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

Šī pirmās kārtas atkāpe katrā rindā (4 atstarpes vai 1 tabulēšana) tiek noņemta, piemēram:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

tiks pārveidots par:

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

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

Koda bloks turpinās līdz neatkāptai rindai (vai faila beigām).

Koda bloka iekšpusē & , < 和 > Tas tiks automātiski pārveidots par HTML entītijām. Šī metode ļauj ļoti vienkārši izmantot Markdown, lai ievietotu piemēra HTML avota kodu, vienkārši nokopējiet un ielīmējiet to, pievienojiet atkāpi, un pārējo Markdown to apstrādās jūsu vietā. piemērs:

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

tiks pārveidots par:

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

Koda blokā vispārējā Markdown sintakse netiks konvertēta, piemēram, zvaigznītes ir tikai zvaigznītes, kas nozīmē, ka Markdown sintaksē varat viegli rakstīt ar Markdown sintaksi saistītos failus.

sadalītājs

Lai rindā izveidotu dalītāju, varat izmantot vairāk nekā trīs zvaigznītes, mīnusa zīmes, pasvītrojumus, rindā neko citu.Varat arī ievietot atstarpes starp zvaigznītēm vai mīnusa zīmēm.Atdalīšanas līnijas var izveidot katrā no šiem rakstīšanas veidiem:

* * *

***

*****

- - -

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

sadaļas elements

saite

Markdown atbalsta divus saišu sintakses veidus: Rindā和Atsaucedivas formas.

Jebkurā gadījumā saites teksts ir atzīmēts ar [kvadrātiekavas].

izveidot aRindāJa vēlaties pievienot saites virsraksta tekstu, aiz URL ievietojiet virsraksta tekstu ar dubultām pēdiņām, piemēram:

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

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

Ražos:

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

Ja veidojat saiti uz resursiem tajā pašā resursdatorā, varat izmantot relatīvos ceļus:

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

AtsauceSaitei aiz saites teksta iekavas seko vēl viena kvadrātiekava, un otrajā kvadrātiekavā ir jāaizpilda atzīme, kas tiek izmantota saites identificēšanai:

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

Varat arī pēc izvēles ievietot atstarpi starp divām kvadrātiekavām:

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

Pēc tam jebkurā faila vietā varat definēt šī taga saites saturu:

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

Saites saturs ir definēts šādā formā:

• Kvadrātiekavas (pēc izvēles pirms trim atstarpēm atkāpei), kurās tiek ievadīts saites teksts
• seko kols
• kam seko viena vai vairākas atstarpes vai tabulēšanas zīmes
• nākamās saites URL
• Pēc izvēles sekojiet virsraksta saturam, ko var ievietot vienpēdiņās, dubultpēdiņās vai iekavās

Šo trīs saišu definīcijas ir vienādas:

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

Lūdzu, ņemiet vērā:Ir zināma problēma, kurā Markdown.pl 1.0.1 ignorē saišu nosaukumus, kas ievietoti atsevišķās pēdiņās.

Saišu vietrāžus URL var iekļaut arī leņķiekavās:

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

Varat arī ievietot virsraksta atribūtu nākamajā rindā vai pievienot atkāpi, kas izskatīsies labāk, ja URL ir pārāk garš:

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

URL definīcija tiek izmantota tikai, ģenerējot saiti, un tā netiek rādīta tieši failā.

Saites identifikācijas tagos var būt burti, cipari, atstarpes un pieturzīmes, taču tā navNēTas ir reģistrjutīgs, tāpēc šīs divas saites ir vienādas:

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

Netieša saites tagsfunkcija ļauj izlaist saites taga norādīšanu. Šajā gadījumā saites tags tiks uzskatīts par līdzvērtīgu saites tekstam. Lai izmantotu netiešu saites tagu, vienkārši pievienojiet tukšu kvadrātiekava aiz saites teksta. Ja vēlaties "Google " Izveidojot saiti uz google.com, varat vienkāršot, lai:

[Google][]

Pēc tam definējiet saites saturu:

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

Tā kā saites tekstā var būt atstarpes, šajā vienkāršotajā marķējumā var būt vairāki vārdi:

Visit [Daring Fireball][] for more information.

Pēc tam dodieties uz saites definēšanu:

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

Saites definīciju var ievietot jebkur failā.Man labāk patīk likt tieši aiz rindkopas,kur parādās saite.Var likt arī faila beigās,tāpat kā komentāru.

Šeit ir atsauces saites piemērs:

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"

Ja maināt to, lai rakstīšanai izmantotu saites nosaukumu:

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"

Iepriekš minētie divi rakstīšanas veidi radīs šādu 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>

Zemāk ir tāda paša satura Markdown fails, kas ierakstīts rindiņā un paredzēts salīdzināšanai:

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

Faktiski atsauces stila saišu mērķis ir nevis tas, ka tās ir vieglāk rakstīt, bet gan tas, ka tās ir vieglāk lasāmas. Salīdziniet iepriekš minēto piemēru. Pats atsauces stila raksts ir tikai 81 rakstzīme, bet iekļautā forma palielināsies līdz 176 rakstzīmes. , ja tas ir rakstīts tīrā HTML formātā, būs 234 rakstzīmes. HTML formātā ir vairāk tagu nekā teksta.

Izmantojot Markdown atsauces stila saites, varat padarīt dokumentu līdzīgāku pārlūkprogrammas gala rezultātam, ļaujot pārvietot dažus ar iezīmēšanu saistītus metadatus ārpus rindkopas teksta, kā arī varat pievienot saites, neradot raksta lasīšanas sajūtu. pārtraukt .

强调

Markdown izmanto zvaigznītes (*) un apakšējā rindiņa (_) kā simbols, lai atzīmētu pasvītrotu vārdu, ir * Vai _ Apkārtējie vārdi tiek pārveidoti par <em> ieskauj etiķetes, ar diviem * Vai _Ja tas ir iesaiņots, tas tiks pārveidots par <strong>,piem.:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

pārvērtīsies par:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Varat izmantot jebkuru stilu, kas jums patīk, vienīgais ierobežojums ir tas, ka varat atvērt tagu, ar kuru simbolu vēlaties to beigt.

Uzsvaru var ievietot arī tieši teksta vidū:

un*frigging*believable

betja tavs * 和 _ Ja abās pusēs ir atstarpes, tās tiek uzskatītas par parastiem simboliem.

Lai ievietotu parastās zvaigznītes vai pasvītras tieši pirms un pēc teksta, varat izmantot atpakaļvērstās slīpsvītras:

\*this text is surrounded by literal asterisks\*

Kods

Ja vēlaties atzīmēt nelielu iekļautā koda fragmentu, varat to ietīt ar ķeksīti (`), piemēram:

Use the `printf()` function.

Ražos:

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

Ja vēlaties ievietot atzīmes koda sadaļā, varat sākt un beigt koda sadaļu, izmantojot vairākas atzīmes:

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

Šī sintakse rada:

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

Koda sadaļas sākumā un beigās varat ievietot tukšu vietu, vienu pēc sākuma un vienu pirms beigām, lai sadaļas sākumā varētu ievietot atzīmes:

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

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

Ražos:

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

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

Koda sadaļā& un leņķa kronšteini都tiks automātiski pārveidots par HTML entītijām, kas atvieglo HTML avota koda ievietošanu, Markdown ievietos šādu rindkopu:

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

uz:

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

Varat arī uzrakstīt šo:

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

Ražot:

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

图片

Acīmredzot ir grūti izveidot "dabisku" sintaksi attēlu ievietošanai tikai teksta lietojumprogrammā.

Attēlu iezīmēšanai Markdown izmanto sintakse, kas ir līdzīga saišu sintaksei, kā arī pieļauj divus stilus: Rindā和Atsauce.

Iekļautā attēla sintakse izskatās šādi:

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

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

Sīkāka informācija ir šāda:

• izsaukuma zīme !
• kam seko kvadrātiekava ar attēla alternatīvo tekstu
• Tam seko parastas iekavas ar attēla URL un visbeidzot izvēles "nosaukuma" teksts pēdiņās.

Atsauces attēla sintakse izskatās šādi:

![Alt text][id]

"id" ir attēla atsauces nosaukums, kas tiek definēts tāpat kā saites atsauce:

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

Pagaidām Markdown nav iespējams norādīt attēla platumu un augstumu, ja nepieciešams, varat izmantot parasto <img> Etiķete.

其它

automātiskā saite

Markdown atbalsta vietrāžu URL un e-pasta pastkastu apstrādi salīdzinoši īsu automātisku saišu veidā. Kamēr tie ir ievietoti leņķiekavās, Markdown to automātiski pārveidos par saiti.Vispārējā URL saites teksts ir tāds pats kā saites adrese, piemēram:

<http://example.com/>

Markdown tiks pārveidots par:

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

Arī e-pasta adrešu automātiskā saistīšana ir ļoti līdzīga, izņemot to, ka Markdown vispirms veiks kodēšanas konvertēšanas procesu, pārvēršot teksta rakstzīmes heksadecimālās HTML entītijās. Šis formāts var apmānīt dažus sliktus e-pasta adrešu vākšanas robotus, piemēram:

<[email protected]>

Markdown pārvērtīsies par:

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

Pārlūkprogrammā šī virkne (faktiski <a href="mailto:[email protected]">[email protected]</a>) kļūst par noklikšķināmu saiti "[email protected]".

(Lai gan šī pieeja var apmānīt daudzus robotus, tā nevar viņus visus apturēt, taču tas ir labāk nekā nekas. Jebkurā gadījumā pastkastes atvēršana galu galā piesaistīs reklāmas vēstules.)

atpakaļvērstā slīpsvītra

Markdown var izmantot slīpsvītras, lai ievietotu simbolus, kuriem gramatikā ir cita nozīme, piemēram: ja vēlaties pievienot zvaigznīti blakus tekstam, lai uzsvērtu (bet ne <em> tagu), pirms zvaigznītes varat ievietot atpakaļvērstās slīpsvītru:

\*literal asterisks\*

Markdown atbalsta šādus simbolus, pirms kuriem ir slīpsvītra, lai palīdzētu ievietot izplatītākos simbolus:

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

Markdown bezmaksas redaktors

Windows platforma

• MarkdownPad
• MarkPad

Mac platforma

• mīksts

tiešsaistes redaktors

• MPE redaktors

pārlūkprogrammas spraudnis

• Atzīmēšanas šeit spraudnis

*** Ja ir labāks bezmaksas Markdown redaktors, ko ieteikt, lūdzu, pievērsiet uzmanību atsauksmēmČens Veiliangs,Paldies!