Markdown чӣ маъно дорад? Нишондиҳии синтаксиси/формати Markdownро чӣ тавр истифода бурдан мумкин аст?

НишондиҳандаЧӣ маъно дорад?

Нишондиҳандаи синтаксиси Markdown/форматиро чӣ гуна истифода бурдан мумкин аст?

Шарҳи

Markdown як забони сабуки аломатгузорӣ мебошад, ки аз ҷониби Ҷон Грубер сохта шудааст.

Он ба одамон имкон медиҳад, ки "ҳуҷҷатҳоро дар формати матни оддӣ, ки хондан ва навиштан осон аст, нависед ва сипас онҳоро ба ҳуҷҷатҳои дурусти XHTML (ё HTML) табдил диҳед".

Забон бисёр хусусиятҳои аломатгузории матни оддиро, ки аллакай дар почтаи электронӣ пайдо шудааст, фаро гирифтааст.

Ҷон Грубер забони Markdown-ро дар соли 2004 дар ҳамкорӣ бо Аарон Свартз дар қисми зиёди синтаксис офаридааст.Мақсади забон ин истифодаи "формати матнии оддӣ, ки хондан осон, навиштан осон аст ва ихтиёран ба XHTML (ё HTML) дуруст табдил меёбад" мебошад.

максад

Ҳадафи Markdown ин аст, ки "хондан осон ва навиштан осон" бошад.

хониш, ба ҳар ҳол ин корро кунедМаркетинги Интернет, таҷрибаи корбар хеле муҳим аст.

Ҳуҷҷате, ки дар Markdown навишта шудааст, бояд мустақиман дар матни оддӣ нашр карда шавад ва набояд аз тегҳо ё дастурҳои форматкунӣ иборат бошад.

Синтаксиси Markdown аз баъзе форматҳои мавҷудаи матн ба HTML, аз ҷумла Setext, atx, Textile, reStructuredText, Grutatext ва EtText таъсир мерасонад, аммо бузургтарин манбаи илҳом формати почтаи электронии матни оддӣ мебошад.

Хулоса, синтаксиси Markdown ҳама аз рамзҳо иборат аст, ки бодиққат интихоб карда шудаанд ва вазифаҳои онҳо дар як нигоҳ равшананд.Масалан: дар атрофи матн ситорача гузоред, то он ба *таъкид* монанд шавад.

Рӯйхатҳо дар Markdown ба рӯйхатҳо монанданд. Blockquotes дар Markdown воқеан ба иқтибос овардани як порчаи матн монанд аст, мисли он ки шумо дар паёмҳои электронӣ дидаед.

Бо HTML мувофиқ аст

Ҳадафи грамматикаи Markdown ин аст, ки забони хаттӣ барои веб бошад.

Markdown барои иваз кардани HTML ё ҳатто ба он наздик шудан пешбинӣ нашудааст, он хеле кам намуди синтаксис дорад ва танҳо ба як зермаҷмӯаи хурди аломатгузории HTML мувофиқат мекунад. Markdown барои осон кардани навиштани ҳуҷҷатҳои HTML тарҳрезӣ нашудааст.

Ба андешаи ман, HTML навиштан аллакай осон аст. Идеяи Markdown он аст, ки хондан, навиштан ва тағир додани ҳуҷҷатҳоро мувофиқи хоҳиш осонтар кунад. HTML формати нашрист, Markdown aКопирайтингформати хаттӣ.Ҳамин тариқ, синтаксиси форматкунии Markdown танҳо он чизеро фаро мегирад, ки матни оддӣ метавонад.

Тегҳое, ки бо Markdown фаро гирифта нашудаанд, метавонанд дар HTML мустақиман дар ҳуҷҷат навишта шавандТаблиғи вебнусхабардорӣ.Инро ҳамчун HTML ё Markdown қайд кардан лозим нест; танҳо аломатро мустақиман илова кунед.

Танҳо баъзе унсурҳои блоки HTML маҳдуд карда мешаванд - масалан <div>,<table>,<pre>,<p> ва барчаспҳои дигар, онҳо бояд аз дигар минтақаҳои мундариҷа бо сатрҳои холӣ пеш ва баъд ҷудо карда шаванд ва барчаспҳои кушода ва пӯшидани онҳо набояд бо ҷадвалҳо ё фосилаҳо дохил карда шаванд. Генератори Markdown ба қадри кофӣ оқил аст, ки тегҳои блоки HTML-и нолозимро илова накунанд <p> Нишон.

Намунаи зерин аст, илова кардани ҷадвали HTML ба файли Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Дар хотир доред, ки синтаксиси форматкунии Markdown байни тегҳои блоки HTML коркард карда намешавад.Масалан, агар шумо дар дохили блоки HTML услуби Markdown истифода баред*强调*таъсире нахоҳад дошт.

Тегҳои фасли HTML (дар сатри) ба монанди <span>,<cite>,<del> Дар бандҳо, рӯйхатҳо ё сарлавҳаҳои Markdown озодона истифода бурдан мумкин аст.Мувофиқи одатҳои шахсӣ, шумо ҳатто метавонед барчаспҳои HTML-ро бидуни истифодаи формати Markdown формат кунед.Мисол: Агар шумо HTML-ро афзалтар донед <a> 或 <img> барчаспҳо, ки метавонанд мустақиман бидуни истинод ё синтаксиси барчаспҳои тасвир, ки аз ҷониби Markdown пешниҳод шудаанд, истифода шаванд.

Баръакси тегҳои блоки HTML, синтаксиси Markdown байни тегҳои бахши HTML эътибор дорад.

Табдилдиҳии худкори аломатҳои махсус

Дар файлҳои HTML ду аломат мавҷуд аст, ки коркарди махсусро талаб мекунанд: < 和 & . < аломатҳо барои барчаспҳои оғоз истифода мешаванд,& Аломатҳо барои нишон додани объектҳои HTML истифода мешаванд, агар шумо фақат прототипи ин аломатҳоро нишон додан хоҳед, шумо бояд шакли объектро истифода баред, масалан < 和 &.

& Аломатҳо махсусан барои нависандагони ҳуҷҷатҳои веб азоб мекашанд, агар шумо нависед "AT&T", шумо бояд нависед "AT&T".дар ҳоле ки дар URL & Аломатҳо низ табдил дода мешаванд.Масалан, шумо мехоҳед ба:

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

Шумо бояд табдили URL-ро чунин нависед:

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

дар теги истинод ҷойгир карда шавад href дар моликият.Бояд гуфт, ки инро нодида гирифтан осон аст ва эҳтимолан шумораи зиёди хатогиҳое, ки тавассути санҷиши стандартҳои HTML ошкор шудаанд.

Markdown ба шумо имкон медиҳад, ки аломатҳоро табиатан нависед ва он чизеро, ки бояд табдил дода шавад, ғамхорӣ мекунад.агар шумо истифода баред & Аломат як ҷузъи аломати HTML мебошад, он тавре боқӣ мемонад, вагарна ба он табдил дода мешавад &;.

Ҳамин тавр, агар шумо хоҳед, ки рамзи ҳуқуқи муаллифиро дар ҳуҷҷат гузоред ©, шумо метавонед нависед:

©

Markdown онро бетаъсир мегузорад.Ва агар шумо нависед:

AT&T

Markdown онро ба: табдил медиҳад:

AT&T

Айнан ҳамин гуна вазъият дар < қайд, зеро Markdown имкон медиҳад, мутобиқати HTML, агар шумо гузошта < Аломатҳо ҳамчун ҷудокунанда барои барчаспҳои HTML истифода мешаванд ва Markdown дар онҳо ҳеҷ гуна табдилро анҷом намедиҳад, аммо агар шумо нависед:

4 < 5

Markdown онро ба: табдил медиҳад:

4 < 5

Бо вуҷуди ин, бояд қайд кард, ки дар доираи код, хоҳ он сатр аст, хоҳ блок, < 和 & ҳарду рамзбоядба объектҳои HTML табдил дода мешаванд, хусусиятест, ки ба шумо имкон медиҳад ба осонӣ коди HTML дар Markdown нависед (бар хилофи HTML, ки дар он шумо ҳама < 和 & Ҳама ба объектҳои HTML табдил дода мешаванд, то рамзи HTML дар файли HTML навишта шаванд. )

унсури блок

Параграфҳо ва танаффусҳои сатрҳо

Параграфи Markdown аз як ё якчанд сатрҳои пайдарпайи матн иборат аст, ки пеш ва баъд аз он зиёда аз як сатри холӣ (таърифи сатри холӣ ин аст, ки он дар экран холӣ ба назар мерасад ва сатри холӣ ҳисобида мешавад. Масалан, , агар сатр танҳо фосилаҳо ва ҷадвалҳоро дар бар гирад, сатр инчунин ҳамчун хати холӣ баррасӣ карда мешавад).Параграфҳои муқаррарӣ набояд бо фосила ё ҷадвалбандиҳо дохил карда шаванд.

Ибораи "аз як ё якчанд сатрҳои пайдарпайи матн иборат аст" дар асл маънои онро дорад, ки Markdown ба сатрҳои маҷбурӣ (ворид кардани сатрҳои нав) дар дохили параграфҳо имкон медиҳад, ки ин хусусият аз дигар форматҳои матн-ба HTML (аз ҷумла Намуди манқул "Танаффусҳои хаттӣ табдил додан" фарқ мекунад. " опсия), форматҳои дигар ҳар як танаффуси сатрро ба <br /> Нишон.

Агар туҳақиқатанМехоҳед барои ворид кардан ба Markdown такя кунед <br /> Барои тамғакоғазҳо, дар ҷои воридкунӣ ду ё зиёда фосиларо пахш кунед ва Enter-ро пахш кунед.

Дарвоқеъ, барои тавлиди он кори каме бештар (ҷойҳои иловагӣ) лозим аст <br /> , балки танҳо "ҳар як сатри нав ба <br />"Усул дар Markdown мувофиқ нест, em дар MarkdownaiБлоки иқтибосҳои сабки L ва рӯйхатҳои бисёрпараграфӣ на танҳо муфидтаранд, балки ҳангоми чоп кардан бо танаффусҳои сатр хондан осонтаранд.

Унвон

Markdown ду синтаксиси сарлавҳаҳоро дастгирӣ мекунад, ба монанди Setext ва ба atx монанд.

Шакли ба монанди Settext ин шаклест, ки сатри поёнро истифода мебарад = (унвони олӣ) ва - (Сарлавҳаҳои тартиби дуюм), масалан:

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

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

ягон миқдор = 和 - самарабахш буда метавонад.

Шакли ба монанди Atx дар аввали сатр аз 1 то 6 дохил мекунад # , ки ба сарлавҳаҳои 1 то 6 мувофиқанд, масалан:

# 这是 H1

## 这是 H2

###### 这是 H6

Шумо метавонед ба таври ихтиёрӣ сарлавҳаҳои ба монанди atx-ро "пӯшед", ин танҳо барои эстетика аст, агар шумо ин тавр худро бароҳат ҳис кунед, шумо метавонед онро дар охири сатр илова кунед #, дар ҳоле ки охири сатр # Рақам набояд бо ибтидо якхела бошад (шумораи аломатҳои фунт дар аввали сатр тартиби сарлавҳаро муайян мекунад):

# 这是 H1 #

## 这是 H2 ##

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

Ихтибосҳои басташуда

Блоки иқтибосҳои аломатгузории Markdown ба онҳое, ки дар почтаи электронӣ истифода мешаванд, истифода мешаванд > аз иқтибосҳо.Агар шумо бо иқтибосҳо дар ҳарфҳои почтаи электронӣ шинос бошед, шумо медонед, ки чӣ гуна дар файли Markdown иқтибосҳои блокро эҷод кунед, ки гӯё шумо сатрҳоро худатон мешиканед ва баъд илова кунед. > :

> 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 инчунин ба шумо имкон медиҳад, ки танбал бошед ва танҳо сатри аввали тамоми параграфро илова кунед > :

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

Истинодҳои блокро метавон ҷойгир кард (масалан: истинодҳо дар дохили истинодҳо) бо илова кардани шумораи дигари > :

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

Дигар синтаксисҳои Markdown низ метавонанд дар дохили блокҳои иқтибосшуда истифода шаванд, аз ҷумла сарлавҳаҳо, рӯйхатҳо, блокҳои рамзӣ ва ғайра:

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

Ҳар як муҳаррири матнии арзанда метавонад ба осонӣ иқтибосҳои сабки почтаи электронӣ эҷод кунад.Масалан, дар BBEdit шумо метавонед матнро интихоб кунед ва баъд аз меню интихоб кунедзинаи иқтибосҳоро зиёд кунед.

Рӯйхат

Markdown рӯйхатҳои фармоишӣ ва бетартибиро дастгирӣ мекунад.

Рӯйхати номатлуб ситорачаҳо, аломатҳои ҷамъ ё минусро ҳамчун аломатҳои рӯйхат истифода мебаранд:

*   Red
*   Green
*   Blue

Муодил ба:

+   Red
+   Green
+   Blue

Инчунин ба:

-   Red
-   Green
-   Blue

Рӯйхати тартибдодашуда рақамҳоро истифода мебаранд, ки пас аз он нуқта гузошта мешаванд:

1.  Bird
2.  McHale
3.  Parish

Бояд қайд кард, ки рақамҳое, ки шумо дар теги рӯйхат истифода мебаред, ба HTML-и баромади натиҷавӣ таъсир намерасонад. Нишонаи HTML барои рӯйхати дар боло овардашуда чунин хоҳад буд:

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

Агар аломатгузории рӯйхати шумо чунин навишта шавад:

1.  Bird
1.  McHale
1.  Parish

ё ҳатто:

3. Bird
1. McHale
8. Parish

Ҳардуи шумо маҳз як баромади HTML мегиред.Гап дар сари он аст, ки шумо метавонед рақамҳои рӯйхатро дар файли Markdown ба натиҷаҳои натиҷа монанд созед, ё агар шумо танбал бошед, ба дурустии рақамҳо умуман ғамхорӣ кардан лозим нест.

Агар шумо навиштани танбалро истифода баред, тавсия дода мешавад, ки бо 1. барои банди аввал оғоз кунед, зеро Markdown метавонад дар оянда атрибути оғози рӯйхатҳои фармоиширо дастгирӣ кунад.

Теги ҷузъҳои рӯйхат одатан дар тарафи чапи дур ҷойгир карда мешавад, аммо он метавонад то 3 фосила ворид карда шавад ва аз теги ашё бояд ҳадди аққал як фосила ё ҷадвал бошад.

Барои зеботар кардани рӯйхат, шумо метавонед мундариҷаро бо абзори собит тартиб диҳед:

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

Аммо агар шумо танбал бошед, ин ҳам хуб аст:

*   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 ҳангоми баровардани HTML мундариҷаи ҷузъҳоро истифода мебарад. <p> Тамғакоғазҳо печонида мешаванд, масалан:

*   Bird
*   Magic

табдил дода мешавад:

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

Аммо ин:

*   Bird

*   Magic

табдил дода мешавад:

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

Ҷузъҳои рӯйхат метавонанд параграфҳои сершумор дошта бошанд ва параграфҳои зери ҳар як адад бояд бо 4 фосила ё 1 ҷадвал дохил карда шаванд:

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.

Агар шумо ҳар як сатрро банд кунед, хеле беҳтар ба назар мерасад, албатта, боз, агар шумо танбал бошед, Markdown инчунин имкон медиҳад:

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

Агар шумо хоҳед, ки дар дохили як ҷузъи рӯйхат истинод гузоред, пас > Он бояд банд карда шавад:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Агар шумо хоҳед, ки блоки кодро гузоред, блок бояд ба инобат гирифта шавадду маротиба, ки 8 фосила ё 2 ҷадвал аст:

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

        <代码写在这>

Албатта, рӯйхати ашёро тасодуфан эҷод кардан мумкин аст, чизе монанди ин:

1986. What a great season.

Ба ибораи дигар, он дар аввали сатр пайдо мешавадрақам-давра-холӣ, барои пешгирӣ кардани ин, шумо метавонед пеш аз давра хати баръакс илова кунед.

1986\. What a great season.

блоки код

Рамзи сарчашмаи навиштан ё забони тегҳои марбут ба барнома одатан аллакай блокҳои коди чопшуда дорад. Одатан, мо намехоҳем, ки ин блокҳо ба тариқи файлҳои параграфи умумӣ чоп карда шаванд, аммо онҳоро тавре нишон диҳед, ки ҳастанд. Markdown истифода хоҳад кард. <pre> 和 <code> барчаспҳо барои печонидани блокҳои код.

Сохтани блокҳои код дар Markdown ба мисли гузоштани 4 фосила ё 1 ҷадвал содда аст, масалан, зеринро ворид кунед:

这是一个普通段落：

    这是一个代码区块。

Markdown ба ин табдил меёбад:

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

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

Ин абзорбандии дараҷаи аввал дар як сатр (4 фосила ё 1 ҷадвал) хориҷ карда мешавад, масалан:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

табдил дода мешавад:

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

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

Блоки код то сатри ношинос (ё охири файл) идома меёбад.

Дар дохили блоки код, & , < 和 > Он ба таври худкор ба ҷузъҳои HTML табдил дода мешавад.Ин усул ба шумо имкон медиҳад, ки Markdown-ро барои ворид кардани коди сарчашмаи HTML барои мисол истифода баред, танҳо онро нусхабардорӣ кунед ва часбонед, қафо илова кунед ва боқимонда Markdown онро барои шумо ҳал мекунад, барои мисол:

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

табдил дода мешавад:

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

Дар блоки код, синтаксиси умумии Markdown табдил дода намешавад, ба монанди ситорачаҳо танҳо ситорача мебошанд, яъне шумо метавонед ба осонӣ файлҳои марбут ба синтаксиси Markdown-ро дар синтаксиси Markdown нависед.

тақсимкунанда

Шумо метавонед зиёда аз се ситорача, аломатҳои минус, зерхатро барои эҷоди тақсимкунанда дар сатр истифода баред, на чизи дигаре дар сатр.Шумо инчунин метавонед дар байни ситорачаҳо ё аломатҳои минус фосила гузоред.Хатҳои ҷудокуниро метавон бо ҳар яке аз роҳҳои зерини навиштан эҷод кард:

* * *

***

*****

- - -

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

унсури бахш

истинод

Markdown ду шакли синтаксиси пайвандро дастгирӣ мекунад: Дар мувофиқат和Истинодду шакл.

Дар ҳар сурат, матни истинод бо [қавсҳои мураббаъ] қайд карда мешавад.

ба вучуд овардани аДар мувофиқатАгар шумо хоҳед, ки матни унвони истинодро илова кунед, танҳо матни унвонро пас аз URL бо нохунакҳои дукарата печонед, масалан:

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

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

истеҳсол хоҳад кард:

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

Агар шумо ба захираҳо дар ҳамон ҳост пайваст шавед, шумо метавонед аз роҳҳои нисбӣ истифода баред:

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

ИстинодПас аз истинод пас аз қавси матни истинод қавси квадратии дигар гузошта мешавад ва нишонае, ки барои муайян кардани пайванд истифода мешавад, бояд дар қавси квадратии дуюм пур карда шавад:

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

Шумо инчунин метавонед ба таври ихтиёрӣ дар байни ду қавси мураббаъ фосила гузоред:

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

Сипас, дар ҳама ҷо дар файл шумо метавонед мундариҷаи истинод ба ин тегро муайян кунед:

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

Мундариҷаи истинод дар шакл муайян карда мешавад:

• Қавсҳои мураббаъ (ихтиёрӣ то се фосила дар пеш гузошта мешаванд), ки ба онҳо матни истинод ворид карда мешавад
• аз паи ду рукн
• пас аз як ё якчанд фосила ё ҷадвалҳо
• URL-и истиноди навбатӣ
• Ихтиёрӣ ба мундариҷаи сарлавҳа пайравӣ кунед, ки онро метавон ба як нохунак, ду нохунак ё қавс дохил кард

Таърифҳои се истиноди зерин якхелаанд:

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

Илтимос не:Масъалаи маълуме вуҷуд дорад, ки Markdown.pl 1.0.1 унвонҳои истинодҳоро, ки дар нохунакҳои ягона замима шудаанд, сарфи назар мекунад.

URL-ҳои истинод низ метавонанд ба қавсҳои кунҷӣ дохил карда шаванд:

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

Шумо инчунин метавонед атрибути унвонро дар сатри навбатӣ гузоред ё каме қафо гузоред, ки агар URL хеле дароз бошад, беҳтар хоҳад буд:

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

Таърифи URL танҳо ҳангоми тавлиди истинод истифода мешавад ва мустақиман дар файл пайдо намешавад.

Барчаспҳои мушаххаси истинод метавонанд ҳарфҳо, рақамҳо, фосилаи холӣ ва пунктуатсияро дар бар гиранд, аммо наНаОн ба ҳарфҳои хурд ҳассос аст, бинобар ин ду истиноди зерин якхелаанд:

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

Теги истиноди номуайянхусусият ба шумо имкон медиҳад, ки нишон додани теги истинодро сарфи назар кунед. Дар ин ҳолат, теги истинод ба матни истинод баробар ҳисоб карда мешавад. Барои истифодаи теги истинод, танҳо пас аз матни истинод қавсаи квадратии холӣ илова кунед. Агар шумо хоҳед, ки "Google" " Пайвастшавӣ ба google.com, шумо метавонед содда кунед:

[Google][]

Сипас мундариҷаи истинодро муайян кунед:

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

Азбаски матни истинод метавонад фазои холӣ дошта бошад, ин аломатгузории соддашуда метавонад якчанд калимаҳоро дар бар гирад:

Visit [Daring Fireball][] for more information.

Сипас барои муайян кардани истинод идома диҳед:

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

Таърифи истинодро дар ҳама ҷо дар файл ҷойгир кардан мумкин аст. Ман афзалтар медонам, ки онро мустақиман пас аз параграфе, ки истинод пайдо мешавад, гузорам. Шумо инчунин метавонед онро дар охири файл гузоред, мисли шарҳ.

Ин аст як мисоли истинод:

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"

Агар шумо онро тағир диҳед, то номи истинодро барои навиштан истифода баред:

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"

Ду роҳи дар боло навиштан 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>

Дар зер файли Markdown бо ҳамон мундариҷаи дар хатти навишташуда оварда шудааст, ки барои муқоиса пешниҳод шудааст:

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

Дар асл, нуқтаи истинодҳои истинод дар он нест, ки навиштан осонтар аст, балки хондан осонтар аст. Мисоли дар боло овардашударо муқоиса кунед. Худи мақолаи услуби истинод ҳамагӣ 81 аломат аст, аммо шакли сатрӣ то ба андоза зиёд мешавад. 176 аломат. , агар он дар формати тозаи HTML навишта шавад, он 234 аломат мешавад.Дар формати HTML тегҳо нисбат ба матн бештаранд.

Бо истифода аз истинодҳои истинодҳои Markdown, шумо метавонед ҳуҷҷатро бештар ба натиҷаи ниҳоии браузер монанд кунед, ки ба шумо имкон медиҳад, ки баъзе метамаълумотҳои марбут ба қайдро берун аз матни параграф интиқол диҳед ва шумо метавонед истинодҳоро бидуни эҳсоси хондани мақола илова кунед. interrupt .

Таъкид кунед

Markdown ситорачаҳоро истифода мебарад (*) ва сатри поён (_) ҳамчун аломат барои ишора кардани калимаи зерхатшуда, аст * 或 _ Калимаҳои иҳоташуда ба табдил дода мешаванд <em> дар ихоташуда бо тамгахо, бо ду * 或 _Агар он печонида шавад, ба он табдил дода мешавад <strong>,Масалан:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

табдил меёбад:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Шумо метавонед ҳар услуберо, ки ба шумо маъқул аст, истифода баред, танҳо маҳдудият дар он аст, ки шумо метавонед рамзро барои кушодани тег ва рамзро барои анҷоми он истифода баред.

Таваҷҷӯҳиро инчунин бевосита дар миёнаи матн гузоштан мумкин аст:

un*frigging*believable

аммоагар шумо * 和 _ Агар дар ҳарду ҷониб фазои холӣ мавҷуд бошад, онҳо танҳо ҳамчун аломатҳои муқаррарӣ баррасӣ карда мешаванд.

Барои ворид кардани ситорачаҳои муқаррарӣ ё зерхатти мустақим пеш аз ва баъд аз матн, шумо метавонед хатҳои баръаксро истифода баред:

\*this text is surrounded by literal asterisks\*

Кодекс

Агар шумо хоҳед, ки як пораи хурди коди дохилиро қайд кунед, шумо метавонед онро дар паси аломатҳо печонед (`), масалан:

Use the `printf()` function.

истеҳсол хоҳад кард:

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

Агар шумо хоҳед, ки дар дохили қисмати рамз қафо гузоред, шумо метавонед қисмати рамзро бо якчанд аксҳои бозгашт оғоз ва анҷом диҳед:

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

Ин синтаксис истеҳсол мекунад:

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

Шумо метавонед дар аввал ва охири қисмати рамз холӣ гузоред, яке пас аз аввал ва дигаре пеш аз анҷом, то шумо метавонед дар аввали бахш қафо гузоред:

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

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

истеҳсол хоҳад кард:

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

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

Дар дохили фасли рамз,& ва қавсҳои кунҷӣ都ба таври худкор ба объектҳои HTML табдил дода мешавад, ки ворид кардани рамзи сарчашмаи HTMLро осон мекунад, Markdown параграфи зеринро мегузорад:

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

ба:

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

Шумо инчунин метавонед инро нависед:

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

Барои истеҳсол:

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

图片

Аён аст, ки тарҳрезии синтаксиси "табиӣ" барои ворид кардани тасвирҳо дар барномаи танҳо матн душвор аст.

Markdown барои қайд кардани тасвирҳо синтаксиси шабеҳи истинодҳоро истифода мебарад ва инчунин ба ду услуб иҷозат медиҳад: Дар мувофиқат和Истинод.

Синтаксиси тасвири дохилӣ чунин менамояд:

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

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

Тафсилот чунинанд:

• аломати нидо !
• пас аз қавси мураббаъ бо матни ивазкунандаи тасвир
• Пас аз он қавсҳои муқаррарӣ бо URL-и тасвир ва дар ниҳоят матни ихтиёрии "унвон", ки дар нохунак дохил карда шудааст.

Синтаксиси тасвири истинод чунин менамояд:

![Alt text][id]

"id" номи истинод ба тасвир аст, ки ҳамон тавре ки истинод ба истинод муайян карда мешавад:

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

То ҳол, Markdown ҳеҷ гуна роҳе барои муайян кардани паҳнӣ ва баландии тасвирро надорад, агар ба шумо лозим бошад, шумо метавонед муқаррариро истифода баред <img> Нишон.

其它

пайванди худкор

Markdown коркарди URL-ҳо ва қуттиҳои почтаи электрониро дар шакли истинодҳои автоматии нисбатан кӯтоҳ дастгирӣ мекунад.То он даме, ки онҳо дар қавсҳои кунҷӣ дохил карда шудаанд, Markdown онро ба таври худкор ба истинод табдил медиҳад.Матни истиноди URL-и умумӣ бо суроғаи истинод якхела аст, масалан:

<http://example.com/>

Markdown ба: табдил дода мешавад:

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

Пайвастшавии автоматии суроғаҳои почтаи электронӣ низ хеле монанд аст, ба истиснои он ки Markdown аввал раванди табдили рамзгузориро иҷро мекунад ва аломатҳои матниро ба объектҳои шонздаҳӣ HTML табдил медиҳад.Ин формат метавонад баъзе роботҳои ҷамъоварии суроғаҳои почтаи электрониро фиреб диҳад, масалан:

<[email protected]>

Markdown ба инҳо табдил меёбад:

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

Дар браузер, ин сатр (воқеан <a href="mailto:[email protected]">[email protected]</a>) ба истиноди кликшавандаи "[email protected]" табдил меёбад.

(Гарчанде ки ин равиш метавонад бисёр роботҳоро фиреб диҳад, аммо ин ҳамаро боздошта наметавонад, аммо ин беҳтар аз ҳеҷ чиз нест. Дар ҳар сурат, кушодани қуттии почтаи шумо дар ниҳоят мактубҳои таблиғотиро ҷалб мекунад.)

рахи баръакс

Markdown метавонад хатҳои баръаксро барои ворид кардани аломатҳое истифода барад, ки дар грамматика маънои дигар доранд, масалан: агар шумо хоҳед, ки дар паҳлӯи матн барои таъкид ситорача илова кунед (вале не <em> барчасп), шумо метавонед пеш аз ситорача бо хатти баръакс гузоред:

\*literal asterisks\*

Markdown рамзҳои зеринро, ки пеш аз хатти баръакс ҷойгиранд, дастгирӣ мекунад, то барои ворид кардани рамзҳои умумӣ кӯмак кунад:

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

Муҳаррири ройгони Markdown

платформаи Windows

• MarkdownPad
• MarkPad

платформаи Mac

• Мо

муҳаррири онлайн

• MPEditor

плагини браузер

• Васлкунаки Markdown дар ин ҷо

*** Агар муҳаррири беҳтари Markdown барои тавсия дода шавад, лутфан ба фикру мулоҳизаҳо диққат диҳедЧен Вейлян,ташаккур!