Apakah maksud Markdown? Bagaimana untuk menggunakan Markdown syntax/formatting markup?

Penurunan hargaApa maksudnya?

Bagaimana untuk menggunakan Markdown syntax/formatting markup?

概述

Markdown ialah bahasa markup ringan yang dicipta oleh John Gruber.

Ia membolehkan orang ramai "menulis dokumen dalam format teks biasa yang mudah dibaca dan ditulis, dan kemudian menukarnya menjadi dokumen XHTML (atau HTML) yang sah".

Bahasa ini telah menyerap banyak ciri penanda teks biasa yang telah ditemui dalam e-mel.

John Gruber mencipta bahasa Markdown pada tahun 2004, dengan kerjasama Aaron Swartz sebahagian besarnya pada sintaks.Tujuan bahasa ini adalah untuk menggunakan "format teks biasa yang mudah dibaca, mudah ditulis, dan secara pilihan ditukar kepada XHTML (atau HTML) yang sah".

tujuan

Matlamat Markdown adalah untuk menjadi "mudah dibaca dan mudah ditulis".

kebolehbacaan, lakukan jugaPasaran internet, pengalaman pengguna adalah sangat penting.

Dokumen yang ditulis dalam Markdown seharusnya boleh diterbitkan secara langsung dalam teks biasa dan tidak sepatutnya terdiri daripada banyak teg atau arahan pemformatan.

Sintaks penurunan harga dipengaruhi oleh beberapa format teks-ke-HTML sedia ada, termasuk Setext, atx, Textile, reStructuredText, Grutatext dan EtText, tetapi sumber inspirasi terbesar ialah format e-mel teks biasa.

Ringkasnya, sintaks Markdown semuanya terdiri daripada simbol, yang dipilih dengan teliti dan fungsinya jelas sekali imbas.Contohnya: letakkan asterisk di sekeliling teks supaya kelihatan seperti *penekanan*.

Senarai dalam Markdown kelihatan seperti, well, senarai. Sekat petikan dalam Markdown benar-benar kelihatan seperti memetik sekeping teks, seperti yang anda lihat dalam e-mel.

Serasi dengan HTML

Matlamat tatabahasa Markdown adalah untuk menjadi bahasa penulisan untuk web.

Penurunan harga tidak dimaksudkan untuk menggantikan HTML, atau mendekatinya, ia mempunyai sangat sedikit jenis sintaks dan sepadan dengan hanya subset kecil penanda HTML. Markdown tidak difikirkan untuk menjadikan dokumen HTML lebih mudah untuk ditulis.

Pada pendapat saya, HTML sudah mudah untuk ditulis. Idea Markdown adalah untuk menjadikan dokumen lebih mudah dibaca, ditulis, dan diubah sesuka hati. HTML ialah format penerbitan, Markdown ialah aPenulisan Salinanformat bertulis.Oleh itu, sintaks pemformatan Markdown hanya merangkumi perkara yang boleh dilakukan oleh teks biasa.

Teg yang tidak dilindungi oleh Markdown boleh ditulis dalam HTML terus dalam dokumenPromosi Websalinan.Tidak perlu menandai ini sebagai HTML atau Markup; cuma tambahkan markup secara terus.

Hanya beberapa elemen blok HTML yang perlu dikekang - seperti <div>,<table>,<pre>,<p> dan teg lain, ia mesti diasingkan daripada kawasan kandungan lain dengan baris kosong sebelum dan selepas, dan teg pembukaan dan penutupnya tidak boleh dienden dengan tab atau ruang. Penjana Markdown cukup bijak untuk tidak menambah tag blok HTML yang tidak perlu <p> Label.

Contohnya adalah seperti berikut, menambah jadual HTML pada fail Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Ambil perhatian bahawa sintaks pemformatan Markdown antara teg blok HTML tidak akan diproses.Contohnya, jika anda menggunakan gaya Markdown dalam blok HTML*强调*tidak akan memberi kesan.

Tag bahagian HTML (sebaris) seperti <span>,<cite>,<del> Boleh digunakan secara bebas dalam perenggan Markdown, senarai atau tajuk.Mengikut tabiat peribadi, anda juga boleh menggunakan tag HTML untuk memformat tanpa menggunakan format Markdown.Contoh: Jika anda lebih suka HTML <a> 或 <img> teg, yang boleh digunakan terus tanpa pautan atau sintaks teg imej yang disediakan oleh Markdown.

Tidak seperti antara teg blok HTML, sintaks Markdown adalah sah antara teg bahagian HTML.

Penukaran automatik aksara khas

Dalam fail HTML, terdapat dua aksara yang memerlukan pengendalian khas: < 和 & . < simbol digunakan untuk tag permulaan,& Simbol digunakan untuk menandakan entiti HTML, jika anda hanya mahu memaparkan prototaip aksara ini, anda perlu menggunakan borang entiti, seperti < 和 &.

& Watak amat menyeksakan penulis dokumen web, jika anda akan menaip "AT&T", awak mesti tulis"AT&T".semasa dalam URL & Aksara juga ditukar.Sebagai contoh anda ingin memaut ke:

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

Anda perlu menulis penukaran URL sebagai:

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

untuk diletakkan dalam tag pautan href dalam hartanah.Tidak perlu dikatakan, ini mudah diabaikan, dan mungkin bilangan ralat terbesar yang dikesan oleh pengesahan piawaian HTML.

Penurunan harga membolehkan anda menulis aksara secara semula jadi, dan ia menjaga perkara yang perlu ditukar.jika anda menggunakan & Aksara ialah sebahagian daripada entiti aksara HTML, ia dibiarkan seperti sedia ada, jika tidak ia ditukar kepada &;.

Jadi jika anda ingin memasukkan simbol hak cipta dalam dokumen ©, anda boleh menulis:

©

Penurunan harga akan membiarkannya tidak disentuh.Dan jika anda menulis:

AT&T

Penurunan harga akan menukarnya kepada:

AT&T

Keadaan yang sama juga berlaku di < notasi, kerana Markdown membenarkan keserasian HTML, jika anda meletakkan < Simbol digunakan sebagai pembatas untuk teg HTML dan Markdown tidak akan melakukan sebarang penukaran padanya, tetapi jika anda menulis:

4 < 5

Penurunan harga akan menukarnya kepada:

4 < 5

Walau bagaimanapun, perlu diingatkan bahawa dalam skop kod, sama ada ia sebaris atau blok, < 和 & kedua-dua simbolpastiditukar kepada entiti HTML, ciri yang membolehkan anda menulis kod HTML dengan mudah dalam Markdown (berbanding dengan HTML, di mana anda meletakkan semua < 和 & Semua ditukar kepada entiti HTML, untuk menulis kod HTML dalam fail HTML. )

elemen blok

Perenggan dan pemisah baris

Perenggan Markdown terdiri daripada satu atau lebih baris teks berturut-turut, didahului dan diikuti oleh lebih daripada satu baris kosong (takrif baris kosong ialah ia kelihatan kosong pada paparan dan dianggap sebagai baris kosong. Contohnya, , jika baris mengandungi hanya ruang dan tab, baris itu juga akan dianggap sebagai baris kosong).Perenggan biasa tidak boleh diinden dengan ruang atau tab.

Frasa "terdiri daripada satu atau lebih baris teks berturut-turut" sebenarnya membayangkan bahawa Markdown membenarkan baris baharu paksa (penyisipan baris baharu) dalam perenggan, ciri yang berbeza daripada kebanyakan format teks-ke-HTML yang lain (termasuk Jenis Alih "Tukar Pemisah Baris " pilihan), format lain akan menukar setiap pemisah baris kepada <br /> Label.

Jika awakmemangMahu bergantung pada Markdown untuk memasukkan <br /> Untuk label, tekan dua atau lebih ruang di tempat sisipan dan kemudian tekan Enter.

Memang, ia memerlukan sedikit lagi kerja (ruang tambahan) untuk dijana <br /> , tetapi hanya "setiap baris baharu ditukar kepada <br />"Kaedah itu tidak sesuai dalam Markdown, em dalam MarkdownaiPetikan blok gaya L dan senarai berbilang perenggan bukan sahaja lebih berguna tetapi juga lebih mudah dibaca apabila menaip dengan pemisah baris.

Tajuk

Markdown menyokong dua sintaks untuk tajuk, Setext-like dan atx-like.

Borang seperti Settext ialah borang dengan garis bawah, menggunakan = (tajuk tertinggi) dan - (Tajuk urutan kedua), contohnya:

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

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

apa-apa jumlah = 和 - boleh berkesan.

Borang seperti Atx memasukkan 1 hingga 6 pada permulaan baris # , sepadan dengan tajuk 1 hingga 6, sebagai contoh:

# 这是 H1

## 这是 H2

###### 这是 H6

Anda boleh memilih "menutup" pengepala seperti atx, ini semata-mata untuk estetika, jika anda berasa selesa dengan cara ini, anda boleh menambahnya di hujung baris #, manakala garisan berakhir # Nombornya tidak semestinya sama dengan permulaan (bilangan aksara paun pada permulaan baris menentukan susunan tajuk):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Petikan sekatan markup markdown digunakan sama seperti yang digunakan dalam e-mel > daripada petikan.Jika anda biasa dengan petikan dalam surat e-mel, anda tahu cara membuat petikan blok dalam fail Markdown, yang kelihatan seperti anda memecahkan baris itu sendiri, kemudian tambah > :

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

Penurunan harga juga membolehkan anda menjadi malas dan menambah hanya baris pertama dari keseluruhan perenggan > :

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

Rujukan blok boleh bersarang (cth: rujukan dalam rujukan) dengan menambah bilangan yang berbeza > :

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

Sintaks Markdown lain juga boleh digunakan dalam blok yang disebut, termasuk tajuk, senarai, blok kod, dsb.:

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

Mana-mana editor teks yang baik boleh membuat petikan gaya e-mel dengan mudah.Contohnya dalam BBEdit anda boleh memilih teks dan kemudian memilih daripada menumeningkatkan hierarki petikan.

Senarai

Penurunan harga menyokong senarai tersusun dan tidak tersusun.

Senarai tidak tertib menggunakan asterisk, tanda tambah atau tanda tolak sebagai penanda senarai:

*   Red
*   Green
*   Blue

Bersamaan dengan:

+   Red
+   Green
+   Blue

Juga bersamaan dengan:

-   Red
-   Green
-   Blue

Senarai tersusun menggunakan nombor diikuti dengan noktah:

1.  Bird
2.  McHale
3.  Parish

Adalah penting untuk ambil perhatian bahawa nombor yang anda gunakan pada teg senarai tidak menjejaskan HTML output. Penanda HTML yang terhasil untuk senarai di atas ialah:

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

Jika penanda senarai anda ditulis sebagai:

1.  Bird
1.  McHale
1.  Parish

atau pun:

3. Bird
1. McHale
8. Parish

Anda berdua akan mendapat output HTML yang sama.Intinya, anda boleh membuat nombor senarai dalam fail Markdown sama dengan hasil output, atau jika anda malas, anda tidak perlu mengambil berat tentang ketepatan nombor itu sama sekali.

Jika anda menggunakan penulisan malas, adalah disyorkan untuk bermula dengan 1. untuk item pertama, kerana Penurunan harga mungkin menyokong atribut permulaan senarai pesanan pada masa hadapan.

Teg item senarai biasanya diletakkan di bahagian paling kiri, tetapi ia boleh diinden, sehingga 3 ruang dan teg item mesti diikuti oleh sekurang-kurangnya satu ruang atau tab.

Untuk menjadikan senarai kelihatan lebih bagus, anda boleh menyusun kandungan dengan inden tetap:

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

Tetapi jika anda malas, tidak mengapa juga:

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

Jika item senarai dipisahkan oleh baris kosong, Markdown akan menggunakan kandungan item semasa mengeluarkan HTML. <p> Label dibalut, contohnya:

*   Bird
*   Magic

akan ditukar kepada:

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

Tetapi ini:

*   Bird

*   Magic

akan ditukar kepada:

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

Item senarai boleh mengandungi berbilang perenggan dan perenggan di bawah setiap item mesti diinden dengan 4 ruang atau 1 tab:

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.

Ia kelihatan lebih baik jika anda mengesot setiap baris, sudah tentu, sekali lagi, jika anda malas, Markdown juga membenarkan:

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

Jika anda ingin meletakkan rujukan di dalam item senarai, maka > Ia perlu diindenkan:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Jika anda ingin meletakkan blok kod, blok itu perlu diindendua kali, iaitu 8 ruang atau 2 tab:

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

        <代码写在这>

Sudah tentu, senarai item boleh dijana secara tidak sengaja, seperti ini:

1986. What a great season.

Dalam erti kata lain, ia muncul pada permulaan barisnombor-tempoh-kosong, untuk mengelakkan perkara ini, anda boleh menambah garis miring ke belakang sebelum tempoh tersebut.

1986\. What a great season.

blok kod

Penulisan yang berkaitan dengan program atau kod sumber bahasa teg biasanya sudah mempunyai blok kod set taip. Biasanya, kami tidak mahu blok ini ditetapkan mengikut cara fail perenggan umum, tetapi memaparkannya seperti sedia ada. Markdown akan menggunakan <pre> 和 <code> tag untuk membalut blok kod.

Blok binaan kod dalam Markdown adalah semudah mengenden 4 ruang atau 1 tab, contohnya, masukkan yang berikut:

这是一个普通段落：

    这是一个代码区块。

Penurunan harga akan ditukar kepada:

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

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

Lekukan tertib pertama setiap baris (4 ruang atau 1 tab) dialih keluar, contohnya:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

akan ditukar kepada:

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

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

Satu blok kod diteruskan sehingga baris yang tidak disentuh (atau penghujung fail).

Di dalam blok kod, & , < 和 > Ia akan ditukar secara automatik kepada entiti HTML. Kaedah ini memudahkan anda menggunakan Markdown untuk memasukkan kod sumber HTML untuk contoh, hanya salin dan tampalnya, tambah lekukan dan selebihnya Markdown akan mengendalikannya untuk anda, untuk contoh:

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

akan ditukar kepada:

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

Dalam blok kod, sintaks Markdown umum tidak akan ditukar, seperti asterisk hanyalah asterisk, yang bermaksud bahawa anda boleh menulis fail berkaitan sintaks Markdown dengan mudah dalam sintaks Markdown.

pembahagi

Anda boleh menggunakan lebih daripada tiga asterisk, tanda tolak, garis bawah untuk membuat pembahagi dalam baris, tiada apa-apa lagi dalam baris.Anda juga boleh memasukkan ruang antara asterisk atau tanda tolak.Garis pemisah boleh dibuat dalam setiap cara penulisan berikut:

* * *

***

*****

- - -

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

elemen bahagian

pautan

Markdown menyokong dua bentuk sintaks pautan: Dalam barisan和Rujukandua bentuk.

Sama ada cara, teks pautan ditandakan dengan [kurung segi empat sama].

untuk mencipta aDalam barisanJika anda ingin menambah teks tajuk pautan, hanya bungkus teks tajuk dengan tanda petikan berganda selepas URL, contohnya:

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

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

Akan menghasilkan:

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

Jika anda memaut ke sumber pada hos yang sama, anda boleh menggunakan laluan relatif:

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

RujukanPautan diikuti oleh kurungan segi empat sama lain selepas kurungan teks pautan, dan tanda yang digunakan untuk mengenal pasti pautan hendaklah diisi dalam kurungan petak kedua:

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

Anda juga boleh meletakkan ruang di antara dua kurungan segi empat sama secara pilihan:

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

Kemudian, di mana-mana dalam fail, anda boleh menentukan kandungan pautan teg ini:

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

Kandungan pautan ditakrifkan dalam bentuk:

• Tanda kurung segi empat sama (secara pilihan didahului dengan sehingga tiga ruang untuk lekukan) yang dimasukkan teks pautan
• diikuti dengan kolon
• diikuti dengan satu atau lebih ruang atau tab
• URL pautan seterusnya
• Secara pilihan, ikuti kandungan tajuk, yang boleh disertakan dalam petikan tunggal, petikan berganda atau kurungan

Takrifan tiga pautan berikut adalah sama:

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

berhati-hati:Terdapat isu yang diketahui di mana Markdown.pl 1.0.1 mengabaikan tajuk pautan yang disertakan dalam petikan tunggal.

URL pautan juga boleh disertakan dalam kurungan sudut:

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

Anda juga boleh meletakkan atribut tajuk pada baris seterusnya, atau menambah beberapa lekukan, yang akan kelihatan lebih baik jika URL terlalu panjang:

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

Takrifan URL hanya digunakan apabila menjana pautan dan tidak muncul secara langsung dalam fail.

Teg pengenalan pautan mungkin mengandungi huruf, nombor, ruang putih dan tanda baca, tetapi janganTidakIa sensitif huruf besar-besaran, jadi dua pautan berikut adalah sama:

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

Teg pautan tersiratciri membolehkan anda mengecualikan menyatakan teg pautan. Dalam kes ini, teg pautan akan dianggap setara dengan teks pautan. Untuk menggunakan teg pautan tersirat, cuma tambahkan kurungan segi empat sama kosong selepas teks pautan. Jika anda mahu "Google " Memautkan ke google.com, anda boleh ringkaskan kepada:

[Google][]

Kemudian tentukan kandungan pautan:

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

Memandangkan teks pautan mungkin mengandungi ruang putih, penanda yang dipermudahkan ini mungkin mengandungi berbilang perkataan:

Visit [Daring Fireball][] for more information.

Kemudian teruskan untuk menentukan pautan:

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

Definisi pautan boleh diletakkan di mana-mana dalam fail. Saya lebih suka meletakkannya terus selepas perenggan tempat pautan muncul. Anda juga boleh meletakkannya di hujung fail, sama seperti komen.

Berikut ialah contoh pautan rujukan:

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"

Jika anda menukarnya untuk menggunakan nama pautan untuk menulis:

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"

Dua cara penulisan di atas akan menghasilkan HTML berikut.

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

Di bawah ialah fail Markdown dengan kandungan yang sama yang ditulis sebaris, disediakan untuk perbandingan:

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

Sebenarnya, titik pautan gaya rujukan bukanlah lebih mudah untuk ditulis, tetapi lebih mudah dibaca. Bandingkan contoh di atas. Rencana gaya rujukan itu sendiri hanya 81 aksara, tetapi bentuk sebaris akan meningkat kepada 176 aksara. , jika ia ditulis dalam format HTML tulen, akan ada 234 aksara. Dalam format HTML, terdapat lebih banyak tag daripada teks.

Menggunakan pautan gaya rujukan Markdown, anda boleh menjadikan dokumen itu lebih seperti hasil akhir penyemak imbas, membolehkan anda mengalihkan beberapa metadata berkaitan penanda ke luar teks perenggan dan anda boleh menambah pautan tanpa membuat rasa membaca artikel itu. .

强调

Markdown menggunakan asterisk (*) dan garis bawah (_) sebagai simbol untuk menandakan perkataan yang bergaris, ialah * 或 _ Perkataan yang dikelilingi ditukar kepada <em> dikelilingi oleh label, dengan dua * 或 _Jika ia dibungkus, ia akan ditukar menjadi <strong>, Cth:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

akan bertukar menjadi:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Anda boleh menggunakan apa sahaja gaya yang anda suka, satu-satunya had ialah anda boleh menggunakan simbol untuk membuka tag dan simbol untuk menamatkannya.

Penekanan juga boleh disisipkan terus di tengah-tengah teks:

un*frigging*believable

tetapisekiranya anda * 和 _ Jika terdapat ruang putih di kedua-dua belah pihak, ia hanya dianggap sebagai simbol biasa.

Untuk memasukkan asterisk biasa atau garis bawah terus sebelum dan selepas teks, anda boleh menggunakan garis miring ke belakang:

\*this text is surrounded by literal asterisks\*

Kod

Jika anda ingin menandakan sekeping kecil kod sebaris, anda boleh membungkusnya dengan tanda belakang (`), Cth:

Use the `printf()` function.

Akan menghasilkan:

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

Jika anda ingin memasukkan backtick di dalam bahagian kod, anda boleh memulakan dan menamatkan bahagian kod dengan berbilang backtick:

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

Sintaks ini menghasilkan:

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

Anda boleh meletakkan kosong pada permulaan dan penghujung bahagian kod, satu selepas permulaan dan satu sebelum akhir, supaya anda boleh memasukkan tanda belakang pada permulaan bahagian:

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

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

Akan menghasilkan:

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

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

Di dalam bahagian kod,& dan kurungan sudut都akan ditukar secara automatik kepada entiti HTML, yang memudahkan untuk memasukkan kod sumber HTML, Markdown akan meletakkan perenggan berikut:

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

kepada:

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

Anda juga boleh menulis ini:

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

Untuk menghasilkan:

<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>

图片

Jelas sekali, sukar untuk mereka bentuk sintaks "semula jadi" untuk memasukkan imej dalam aplikasi teks sahaja.

Penurunan harga menggunakan sintaks yang serupa dengan pautan untuk menandakan imej, dan juga membenarkan dua gaya: Dalam barisan和Rujukan.

Sintaks imej sebaris kelihatan seperti:

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

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

Butiran adalah seperti berikut:

• tanda seru !
• diikuti dengan kurungan segi empat sama dengan teks alt untuk imej
• Ini diikuti dengan kurungan biasa dengan URL imej, dan akhirnya teks pilihan 'tajuk' disertakan dalam petikan.

Sintaks imej rujukan kelihatan seperti ini:

![Alt text][id]

"id" ialah nama rujukan imej, yang ditakrifkan dengan cara yang sama seperti rujukan pautan:

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

Setakat ini, Markdown tidak mempunyai cara untuk menentukan lebar dan ketinggian imej, jika anda perlu, anda boleh menggunakan yang biasa <img> Label.

其它

pautan automatik

Markdown menyokong pemprosesan URL dan peti mel e-mel dalam bentuk pautan automatik yang agak pendek. Selagi ia disertakan dalam kurungan sudut, Markdown akan menukarnya secara automatik menjadi pautan.Teks pautan URL umum adalah sama dengan alamat pautan, contohnya:

<http://example.com/>

Penurunan harga akan ditukar kepada:

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

Pemautan automatik alamat e-mel juga serupa, kecuali Markdown akan melakukan proses penukaran pengekodan terlebih dahulu, menukar aksara teks kepada entiti HTML perenambelasan. Format ini boleh menipu beberapa robot pengumpulan alamat e-mel yang buruk, seperti:

<[email protected]>

Penurunan harga akan berubah menjadi:

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

Dalam penyemak imbas, rentetan ini (sebenarnya <a href="mailto:[email protected]">[email protected]</a>) menjadi pautan "[email protected]" yang boleh diklik.

(Walaupun pendekatan ini boleh menipu banyak robot, ia tidak boleh menghalang mereka semua, tetapi ia lebih baik daripada tiada. Walau apa pun, membuka peti mel anda akhirnya akan menarik surat pengiklanan.)

garis miring ke belakang

Markdown boleh menggunakan garis miring ke belakang untuk memasukkan simbol yang mempunyai makna lain dalam tatabahasa, sebagai contoh: jika anda ingin menambah asterisk di sebelah teks untuk penekanan (tetapi tidak <em> tag), anda boleh mendahului asterisk dengan garis miring ke belakang:

\*literal asterisks\*

Penurunan harga menyokong simbol berikut yang didahului dengan garis miring ke belakang untuk membantu memasukkan simbol biasa:

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

Editor percuma penurunan harga

platform Windows

• MarkdownPad
• MarkPad

Platform Mac

• Mou

editor dalam talian

• MPEditor

pemalam penyemak imbas

• Pemalam turun harga di sini

*** Jika ada editor Markdown percuma yang lebih baik untuk disyorkan, sila beri perhatian kepada maklum balasChen Weiliang,Terima kasih!