Markdown гэж юу гэсэн үг вэ? Markdown синтакс/форматын тэмдэглэгээг хэрхэн ашиглах вэ?

Маркдаун гэдэг нь юу гэсэн үг вэ?

Markdown синтакс/форматын тэмдэглэгээг хэрхэн ашиглах вэ?

Тойм

Markdown бол Жон Груберийн бүтээсэн хөнгөн хэлбэрийн тэмдэглэгээний хэл юм.

Энэ нь хүмүүст "унших, бичихэд хялбар энгийн текст хэлбэрээр бичиг баримт бичиж, дараа нь тэдгээрийг хүчинтэй XHTML (эсвэл HTML) баримт бичиг болгон хөрвүүлэх" боломжийг олгодог.

Энэ хэл нь имэйлд аль хэдийн олдсон энгийн текстийн тэмдэглэгээний олон шинж чанарыг шингээсэн.

Жон Грубер 2004 онд Аарон Сварцтай хамтран синтакс дээр Markdown хэлийг бүтээжээ.Хэлний зорилго нь "уншихад хялбар, бичихэд хялбар, хүчинтэй 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 баримт бичигт онлайн сурталчилгааны хуулбарыг бичихэд шууд ашиглаж болно . Та 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 догол мөр нь нэг буюу хэд хэдэн дараалсан текстийн мөрөөс бүрдэх бөгөөд өмнө нь болон араас нь нэгээс олон хоосон мөр байдаг (хоосон мөрийн тодорхойлолт нь дэлгэцэн дээр хоосон мэт харагдах бөгөөд хоосон мөр гэж тооцогддог. For жишээ нь, хэрэв мөрөнд зөвхөн хоосон зай, таб байгаа бол мөрийг мөн хоосон мөр гэж үзэх болно).Энгийн догол мөрийг хоосон зай эсвэл табаар доголдуулж болохгүй.

"Нэг буюу хэд хэдэн дараалсан текст мөрүүдээс бүрддэг" гэсэн хэллэг нь Markdown нь догол мөрөнд албадан шинэ мөр оруулах (шинэ мөр оруулах) боломжийг олгодог гэсэн үг бөгөөд энэ нь бусад текстээс HTML формат руу (хөдөлгөөнт төрөл "Мөр таслах хөрвүүлэх" гэх мэт) ялгаатай онцлогтой. " сонголт), бусад форматууд нь мөр таслах бүрийг хөрвүүлэх болно <br /> шошго.

Хэрэв чиүнэхээрMarkdown-д найдаж оруулахыг хүсэж байна <br /> Шошгоны хувьд оруулах хэсэгт хоёр буюу түүнээс дээш зай дарж, Enter дарна уу.

Үнэн хэрэгтээ, үүсгэхийн тулд арай илүү ажил (нэмэлт зай) шаардагдана <br /> , гэхдээ зүгээр л "шинэ мөр бүрийг хөрвүүлдэг <br />"Энэ арга нь Markdown-д тохирохгүй, харин Markdown-д тохиромжгүйaiL хэлбэрийн блок ишлэл болон олон догол мөрийн жагсаалт нь мөр таслах үед бичихэд илүү ашигтай төдийгүй уншихад хялбар байдаг.

Гарчиг

Markdown нь Setext-like болон 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.

Жагсаалтын зүйлсийг хоосон мөрөөр тусгаарласан бол 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 объект болгон хувиргах болно. Энэ арга нь танд жишээний HTML эх кодыг оруулахын тулд Markdown-ийг ашиглахад маш хялбар болгодог. Зүгээр л хуулж буулгаад, догол оруулаарай, Markdown-ын үлдсэн хэсэг нь танд зориулагдана. , Жишээлбэл:

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

болгон хувиргах болно:

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

Кодын блокод ерөнхий Markdown синтакс хөрвүүлэгдэхгүй, жишээ нь одоор нь зүгээр л одоор байдаг тул та Markdown синтакстай холбоотой файлуудыг Markdown синтакс дээр хялбархан бичиж болно гэсэн үг юм.

Хуваагч

你 可以 在 一行 中用 三个 以上 的 星 号 、 减号 、 来 建立 一个 分隔线 ， 行 内 内 不能 有 其他 其他 ， 行 内 不能 有 有 其他 其他 东西东西 也 也分隔线:

* * *

***

*****

- - -

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

хэсгийн элемент

холбоос

Markdown нь холбоосын синтакс гэсэн хоёр хэлбэрийг дэмждэг: шугаман болон лавлагаа.

Аль ч тохиолдолд холбоосын текстийг [дөрвөлжин хаалт] тэмдэглэнэ.

Шугаман холбоос үүсгэхийн тулд хаалттай дөрвөлжин хаалтыг дагаж URL хаягийг оруулна уу. Хэрэв та холбоосонд гарчгийн текст нэмэхийг хүсвэл 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>—</code> is the decimal-encoded
equivalent of <code>—</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 редакторуудын талаар илүү сайн зөвлөмж байгаа бол Чен Вэйлянд мэдэгдээрэй . Баярлалаа!