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 - aКопирайтингжазба форматы.Осылайша, Markdown пішімдеу синтаксисі қарапайым мәтінді ғана қамтиды.

Markdown қамтымаған тегтерді HTML тілінде тікелей құжатта жазуға боладыWeb Promotionкөшіру.Мұны HTML немесе Markdown ретінде белгілеудің қажеті жоқ; тек түзетуді тікелей қосыңыз.

Тек кейбір HTML блок элементтері шектелуі керек - мысалы <div>,<table>,<pre>,<p> және басқа тегтер үшін олар басқа мазмұн аймақтарынан алдында және кейін бос жолдармен бөлінуі керек және олардың ашу және жабу тегтері қойындылармен немесе бос орындармен шегініс жасамауы керек. Markdown генераторы қажетсіз HTML блок тегтерін қоспау үшін жеткілікті ақылды <p> заттаңба.

Мысал келесідей, HTML кестесін Markdown файлына қосу:

这是一个普通段落。

<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 пішімдерінің көпшілігінен (оның ішінде жылжымалы түрі «Жолды түрлендіруді» қоса) ерекшеленеді. Үзілістер» опциясы), басқа пішімдер әрбір жол үзілімін түрлендіреді <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

Қосымша атx тәрізді тақырыптарды «жабуға» болады, бұл тек эстетикаға арналған, егер сіз өзіңізді осылай ыңғайлы сезінсеңіз, оны жолдың соңына қосуға болады. #, жолдың аяқталуы кезінде # Санның басымен бірдей болуы міндетті емес (жолдың басындағы фунт таңбаларының саны тақырыптың ретін анықтайды):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Белгілеудің блоктау тырнақшалары электрондық поштада қолданылатындарға ұқсас пайдаланылады > дәйексөздер.Егер сіз электрондық хаттардағы тырнақшалармен таныс болсаңыз, 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 сілтеме синтаксисінің екі түрін қолдайды: Кезекте和Анықтамаекі пішін.

Қалай болғанда да, сілтеме мәтіні [шаршы жақшамен] белгіленеді.

құру үшін аКезектеСілтеменің тақырып мәтінін қосқыңыз келсе, 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 сілтеме стиліндегі сілтемелерді пайдалану құжатты браузердің соңғы нәтижесіне көбірек ұқсатып, кейбір түзетуге қатысты метадеректерді абзац мәтінінен тыс жылжытуға мүмкіндік береді және сілтемелерді мақаланы оқымай-ақ қосуға болады.

Ерекше назар аударыңыз

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 редакторы болса, кері байланысқа назар аударыңызЧен Вэйлян,рахмет!