Markdown эмнени билдирет? Markdown синтаксисин/форматтоо белгисин кантип колдонсо болот?

MarkdownЭмнени билдирет?

Markdown синтаксисин/формат белгисин кантип колдонсо болот?

Обзор

Markdown - бул Жон Грубер тарабынан түзүлгөн жеңил белгилөө тили.

Бул адамдарга "окууга жана жазууга оңой болгон жөнөкөй текст форматында документтерди жазууга, анан аларды жарактуу XHTML (же HTML) документтерине айландыруу" мүмкүнчүлүгүн берет.

Бул тил электрондук почтада мурунтан эле табылган жөнөкөй текстти белгилөөнүн көптөгөн өзгөчөлүктөрүн камтыйт.

Джон Грубер Маркдаун тилин 2004-жылы Аарон Сварц менен биргеликте синтаксис боюнча түзгөн.Тилдин максаты "окууга оңой, жазууга оңой жана ыктыярдуу түрдө жарактуу XHTML (же HTML) форматына айландыруучу жөнөкөй текст форматын" колдонуу.

максаты

Markdown максаты - "окууга жана жазууга жеңил" болуу.

окулушу, баары бир кылИнтернет маркетинг, колдонуучунун тажрыйбасы абдан маанилүү.

Markdown-да жазылган документ түз текстте жарыяланышы керек жана көптөгөн тегдерден же форматтоо директивалары менен түзүлбөшү керек.

Markdown синтаксисине Setext, atx, Textile, reStructuredText, Grutatext жана EtText сыяктуу учурдагы кээ бир тексттен HTML форматтары таасир этет, бирок илхамдын эң чоң булагы бул жөнөкөй текст электрондук почта форматы.

Кыскача айтканда, Markdown синтаксиси бардык символдордон турат, алар кылдаттык менен тандалып алынган жана алардын функциялары бир караганда түшүнүктүү.Мисалы: тексттин айланасына жылдызчаларды коюңуз, аны * баса белгилөө* сыяктуу кылып коюңуз.

Markdown ичиндеги тизмелер тизмелерге окшош. Markdown'дагы блок тырмакчалар чындап эле электрондук каттарда көргөндөй, тексттин бир бөлүгүн цитата кылгандай көрүнөт.

HTML менен шайкеш

Markdown грамматикасынын максаты желе үчүн жазуу тили болуу.

Markdown HTMLди алмаштырууга, жада калса ага жакындап калууга арналбайт, ал синтаксистин аз түрлөрүнө ээ жана HTML белгилөөнүн кичинекей бөлүгүнө гана туура келет. Markdown HTML документтерин жазууну жеңилдетүү үчүн иштелип чыккан эмес.

Менин оюмча, HTML жазууга мурунтан эле оңой. Markdown идеясы документтерди окууну, жазууну жана каалагандай өзгөртүүнү жеңилдетүү болуп саналат. HTML - бул жарыялоо форматы, Markdown - акопирайтингжазылган формат.Ошентип, Markdown форматтоо синтаксиси жөнөкөй текстти гана камтыйт.

Markdown менен камтылбаган тегдерди HTMLде түз документте жазууга болотWeb Promotionкөчүрүү.Муну HTML же Markdown катары белгилөөнүн кереги жок; жөн гана белгилөөнү түз кошуңуз.

Кээ бир HTML блок элементтери гана чектелиши керек - мисалы <div>,<table>,<pre>,<p> жана башка тегдер, алар башка мазмун аймактарынан мурун жана кийин бош сызыктар менен бөлүнүшү керек жана алардын ачылыш жана жабуу тегдери өтмөктөр же боштуктар менен чегинбеши керек. Markdown генератору керексиз HTML блок тегдерин кошпоо үчүн жетиштүү акылдуу <p> энбелги.

Мисал төмөнкүдөй, Markdown файлына HTML таблицасын кошуу:

这是一个普通段落。

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

这是另一个普通段落。

HTML блок тегдеринин ортосундагы Markdown форматтоо синтаксиси иштетилбей турганын эске алыңыз.Мисалы, HTML блогунун ичинде Markdown стилин колдонсоңуз*强调*эч кандай таасири болбойт.

сыяктуу HTML бөлүмү (саптык) тэгдер <span>,<cite>,<del> Markdown абзацтарында, тизмелеринде же аталыштарында эркин колдонулушу мүмкүн.Жеке адаттарыңыз боюнча, Markdown форматын колдонбостон форматтоо үчүн HTML тэгдерин да колдонсоңуз болот.Мисал: Эгер сиз 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 форматына (анын ичинде кыймылдуу түрү "Сизди айландыруу" сыяктуу форматтардан айырмаланат. Breaks" опциясы), башка форматтар ар бир саптын үзүлүшүн өзгөртөт <br /> энбелги.

Эгер сенЧындыгындаКыстаруу үчүн Markdown'га ишенгиңиз келет <br /> Энбелгилер үчүн кыстаруу жеринде эки же андан көп боштукту басып, андан кийин Enter баскычын басыңыз.

Чынында эле, аны түзүү үчүн бир аз көбүрөөк жумуш (кошумча мейкиндиктер) талап кылынат <br /> , бирок жөн гана "ар бир жаңы сапка айландырылат <br />"Метод Markdown-да, Markdown-да туура эмесaiL стилиндеги блок тырмакчалар жана көп абзацтан турган тизмелер саптарды тыныгуу менен терүүдө пайдалуураак гана эмес, окууга да жеңил болот.

башкы

Markdown рубрикалар үчүн эки синтаксисти колдойт, Setext сыяктуу жана atx сыяктуу.

Settext сыяктуу түрү төмөнкү сызык менен түрү болуп саналат, колдонуу = (эң жогорку наам) жана - (Экинчи тартиптеги рубрикалар), мисалы:

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

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

каалаган сумма = 和 - натыйжалуу болушу мүмкүн.

Atx сыяктуу форма саптын башына 1ден 6га чейин киргизет # , 1ден 6га чейинки аталыштарга туура келет, мисалы:

# 这是 H1

## 这是 H2

###### 这是 H6

Каалооңуз боюнча, atx сымал рубрикаларды "жабып" койсоңуз болот, бул эстетика үчүн, эгер сиз өзүңүздү ыңгайлуу сезсеңиз, аны саптын аягына кошсоңуз болот. #, сап аяктап жатканда # Сан башталышы менен бирдей болбошу керек (саптын башындагы фунт символдордун саны аталыштын тартибин аныктайт):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

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.

Тизме элементтери бош сызыктар менен бөлүнгөн болсо, HTML чыгарууда Markdown элементтин мазмунун колдонот. <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 объекттерине айландырылат. Бул ыкма сизге үлгү үчүн HTML булак кодун киргизүү үчүн Markdown'ду колдонууну абдан жеңилдетет. Жөн гана аны көчүрүп, чаптап, чегинүүнү кошуңуз жана Markdownдун калган бөлүгү сиз үчүн чечилет. , мисалы:

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

төмөнкүгө айландырылат:

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

Код блогунда жалпы Markdown синтаксиси өзгөртүлбөйт, мисалы жылдызчалар жөн гана жылдызчалар, демек Markdown синтаксисине тиешелүү файлдарды Markdown синтаксисинде оңой жаза аласыз.

бөлүүчү

Сапта бөлгүч түзүү үчүн үчтөн ашык жылдызчаны, минус белгини, астын сызгычты колдоно аласыз, сапта башка эч нерсе жок.Ошондой эле жылдызчалардын же минус белгилеринин арасына боштуктарды киргизе аласыз.Бөлүнүүчү саптар төмөнкү жазуу жолдорунун ар биринде түзүлүшү мүмкүн:

* * *

***

*****

- - -

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

бөлүм элементи

шилтеме

Markdown шилтеме синтаксисинин эки формасын колдойт: Inline和Шилтемеэки форма.

Кандай болбосун, шилтеме тексти [чарчы кашаа] менен белгиленет.

түзүү аInlineШилтеменин аталышынын текстин кошкуңуз келсе, жөн гана аталыштын текстин 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 сүрөттөрдү белгилөө үчүн шилтемелерге окшош синтаксисти колдонот, ошондой эле эки стилге мүмкүнчүлүк берет: Inline和Шилтеме.

Саптагы сүрөттүн синтаксиси төмөнкүдөй көрүнөт:

![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 редактору бар болсо, пикириңизге көңүл буруңузЧен Вейлян,рахмат!