Naon hartosna Markdown? Kumaha ngagunakeun Markdown syntax/format markup?

MarkdownNaon hartina?

Kumaha cara nganggo Markdown syntax/formatting markup?

Ihtisar

Markdown mangrupakeun basa markup lightweight dijieun ku John Gruber.

Hal ieu ngamungkinkeun jalma pikeun "nulis dokumén dina format téks polos anu gampang dibaca jeung ditulis, lajeng ngarobah kana dokumén XHTML (atawa HTML) valid".

Basa ieu kalebet seueur fitur markup téks polos anu parantos aya dina e-mail.

John Gruber nyiptakeun basa Markdown di 2004, gawé bareng Aaron Swartz sabagian ageung dina sintaksis.Tujuan basa nyaéta ngagunakeun "format téks polos anu gampang dibaca, gampang ditulis, sareng sacara opsional dirobih kana XHTML (atanapi HTML) anu valid".

tujuanana

Tujuan tina Markdown nyaéta "gampang dibaca sareng gampang ditulis".

readability, ngalakukeun eta atohPamasaran Internét, pangalaman pamaké pohara penting.

Dokumén anu ditulis dina Markdown kedah tiasa dipedalkeun langsung dina téks polos, sareng henteu sigana diwangun ku seueur tag atanapi diréktif pormat.

Sintaksis Markdown dipangaruhan ku sababaraha format téks-to-HTML anu tos aya, kalebet Setext, atx, Textile, reStructuredText, Grutatext, sareng EtText, tapi sumber inspirasi pangbadagna nyaéta format email téks polos.

Pondokna, sintaksis Markdown sadayana diwangun ku simbol, anu dipilih sacara saksama sareng fungsina jelas dina sakedapan.Contona: nempatkeun tanda bintang sabudeureun téks sangkan eta kasampak kawas * tekenan *.

Daptar di Markdown kasampak kawas, sumur, daptar. Tanda kutip blokir dina Markdown katingalina sapertos ngutip sapotong téks, sapertos anu anjeun tingali dina email.

Cocog sareng HTML

Tujuan tina grammar Markdown nyaéta janten basa tulisan pikeun wéb.

Markdown henteu dimaksudkeun pikeun ngagentos HTML, atanapi bahkan caket kana éta, éta gaduh sakedik variasi sintaksis sareng ngan ukur sawaréh leutik tina markup HTML. Markdown teu katimu sangkan dokumén HTML gampang nulis.

Dina pamanggih kuring, HTML geus gampang nulis. Gagasan Markdown nyaéta ngagampangkeun dokumén dibaca, ditulis, sareng dirobih upami hoyong. HTML mangrupikeun format penerbitan, Markdown mangrupikeunPanulis naskahformat tulisan.Sapertos kitu, sintaksis pormat Markdown ngan ukur nyertakeun naon anu tiasa dilakukeun ku téks polos.

Tag nu teu katutupan ku Markdown bisa ditulis dina HTML langsung dina dokuménPromosi wébnyalin.Henteu kedah ditandaan ieu salaku HTML atanapi Markdown; cukup tambahkeun markup langsung.

Ngan sababaraha elemen blok HTML kudu diwatesan - kayaning <div>,<table>,<pre>,<p> sareng tag anu sanés, aranjeunna kedah dipisahkeun tina daérah eusi sanés kalayan garis kosong sateuacan sareng saatosna, sareng tag pambuka sareng nutupna henteu tiasa dilebetkeun sareng tab atanapi rohangan. Generator Markdown cukup pinter henteu nambihan tag blok HTML anu teu perlu <p> Label.

Contona kieu, nambahkeun hiji méja HTML kana file Markdown:

这是一个普通段落。

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

这是另一个普通段落。

Catet yén sintaksis pormat Markdown antara tag blok HTML moal diolah.Contona, upami anjeun nganggo gaya Markdown di jero blok HTML*强调*moal boga pangaruh.

Tag bagian HTML (inline) sapertos <span>,<cite>,<del> Bisa dipaké kalawan bébas dina Markdown paragraf, daptar atawa lulugu.Numutkeun kabiasaan pribadi, anjeun malah tiasa nganggo tag HTML pikeun pormat tanpa nganggo format Markdown.Conto: Upami anjeun resep HTML <a> Atanapi <img> tag, anu tiasa dianggo langsung tanpa tautan atanapi sintaksis tag gambar anu disayogikeun ku Markdown.

Teu kawas antara tag blok HTML, sintaksis Markdown valid antara tag bagian HTML.

Konversi otomatis tina karakter husus

Dina file HTML, aya dua karakter anu merlukeun penanganan husus: < 和 & . < simbol dipaké pikeun tag mimiti,& Simbol digunakeun pikeun nandaan entitas HTML, upami anjeun ngan ukur hoyong nunjukkeun prototipe karakter ieu, anjeun kedah nganggo bentuk éntitas, sapertos. < 和 &.

& Karakter hususna nyiksa pikeun panulis dokumén wéb, upami anjeun badé ngetik "AT&T", anjeun kedah nyerat"AT&T".bari dina URL & Karakter ogé dirobah.Contona anjeun hoyong numbu ka:

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

Anjeun kedah nyerat konversi URL sapertos:

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

pikeun ditempatkeun dina tag link href dina sipat.Gunana pikeun nyebutkeun, ieu téh gampang malire, sarta meureun jumlah pangbadagna kasalahan kauninga ku validasi standar HTML.

Markdown ngamungkinkeun anjeun nyerat karakter sacara alami, sareng ngurus naon anu kedah dirobih.lamun make & Hiji karakter mangrupa bagian tina hiji éntitas karakter HTML, eta ditinggalkeun sakumaha anu kasebut, disebutkeun eta dirobah jadi &;.

Janten upami anjeun hoyong nyelapkeun simbol hak cipta dina dokumen éta ©, anjeun tiasa nyerat:

©

Markdown bakal ngantep éta teu kacekel.Sareng upami anjeun nyerat:

AT&T

Markdown bakal ngarobih kana:

AT&T

Hiji kaayaan sarupa ogé lumangsung dina < notasi, saprak Markdown ngamungkinkeun kasaluyuan HTML, lamun nempatkeun < Simbol dianggo salaku pembatas pikeun tag HTML, sareng Markdown moal ngalakukeun konvérsi dina éta, tapi upami anjeun nyerat:

4 < 5

Markdown bakal ngarobih kana:

4 < 5

Nanging, kedah diperhatoskeun yén dina lingkup kode, naha éta inline atanapi blok, < 和 & duanana simbolpastinadirobih kana éntitas HTML, fitur anu ngamungkinkeun anjeun gampang nyerat kode HTML dina Markdown (sabalikna tina HTML, dimana anjeun nempatkeun sadaya < 和 & Sadayana dirobih janten éntitas HTML, supados nyerat kode HTML dina file HTML. )

elemen blok

Paragraf jeung putus baris

Paragraf Markdown diwangun ku hiji atawa leuwih garis padeukeut tina téks, dimimitian tur dituturkeun ku leuwih ti hiji garis kosong (definisi garis kosong nya eta nembongan kosong dina tampilan tur dianggap garis kosong. Contona, , lamun hiji garis ngan ngandung spasi tur tab, garis ogé bakal diolah salaku garis kosong).Paragraf normal teu kedah di-indent sareng spasi atanapi tab.

Frase "diwangun ku hiji atawa leuwih garis padeukeut téks" sabenerna ngakibatkeun yen Markdown ngidinan newlines kapaksa (sisipan of newlines) dina paragraf, hiji fitur anu béda ti paling format téks-to-HTML séjén (kaasup Movable Type "Convert Line Breaks). "Pilihan), format sejenna bakal ngarobah unggal garis putus kana <br /> Label.

Upami anjeunleres pisanHoyong ngandelkeun Markdown nyelapkeun <br /> Pikeun labél, pencét dua atanapi langkung rohangan di tempat sisipan teras pencét Enter.

Mémang, peryogi sakedik deui padamelan (spasi tambahan) pikeun ngahasilkeun <br /> , tapi ngan saukur "unggal baris anyar dirobih kana <br />"Metoda éta henteu cocog dina Markdown, em di MarkdownaiTanda kutip blok gaya L sareng daptar multi-paragraf henteu ngan ukur langkung mangpaat tapi ogé langkung gampang dibaca nalika ngetik sareng ngarecah garis.

Judul

Markdown ngadukung dua sintaksis pikeun judul, Setext-like sareng atx-like.

Bentuk Settext-kawas nyaéta formulir kalawan garis handap, ngagunakeun = (judul pangluhurna) jeung - (Judul urutan kadua), contona:

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

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

jumlah naon = 和 - bisa éféktif.

formulir Atx-kawas inserts 1 ka 6 di awal garis # , pakait jeung lulugu 1 nepi ka 6, contona:

# 这是 H1

## 这是 H2

###### 这是 H6

Anjeun tiasa sacara opsional "nutup" header sapertos atx, ieu murni pikeun éstétika, upami anjeun ngarasa nyaman ku cara ieu, anjeun tiasa nambihanana dina tungtung jalur. #, bari tungtung garis # Jumlahna teu kudu sarua jeung awal (jumlah karakter pound dina awal baris nangtukeun urutan judul):

# 这是 H1 #

## 这是 H2 ##

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

Blockquotes Blockquotes

Markdown markup blockquotes dianggo sami sareng anu dianggo dina email > tina citations.Upami anjeun wawuh sareng tanda petik dina surat email, anjeun terang kumaha cara ngadamel kutipan blok dina file Markdown, anu bakal katingali sapertos anjeun megatkeun garis sorangan, teras tambahkeun > :

> 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 ogé ngamungkinkeun anjeun puguh sareng nambihan ngan ukur baris kahiji tina sadaya paragraf > :

> 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 tiasa disarangkeun (contona: rujukan dina référénsi) ku cara nambihan sajumlah anu béda > :

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

Sintaksis Markdown séjén ogé tiasa dianggo dina blok anu dikutip, kalebet judul, daptar, blok kode, jsb.

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

Sakur pangropéa téksu anu santun tiasa gampang nyiptakeun kutipan gaya email.Contona dina BBEdit anjeun tiasa milih téks teras pilih tina ménuningkatkeun hirarki cutatan.

列表

Markdown ngadukung daptar anu maréntahkeun sareng henteu teratur.

Daptar unordered make tanda bintang, tanda tambah, atawa tanda minus salaku spidol daptar:

*   Red
*   Green
*   Blue

Sarua jeung:

+   Red
+   Green
+   Blue

Sarua oge jeung:

-   Red
-   Green
-   Blue

Daptar maréntahkeun ngagunakeun nomer dituturkeun ku titik:

1.  Bird
2.  McHale
3.  Parish

Kadé dicatet yén angka nu Anjeun pake dina tag daptar teu mangaruhan HTML kaluaran.

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

Upami daptar daptar anjeun ditulis salaku:

1.  Bird
1.  McHale
1.  Parish

atawa malah:

3. Bird
1. McHale
8. Parish

Anjeun duanana bakal nampi kaluaran HTML anu sami.Intina, anjeun tiasa ngadamel daptar nomer dina file Markdown sami sareng hasil kaluaran, atanapi upami anjeun kesel, anjeun henteu kedah paduli kana kabeneran nomerna.

Lamun make tulisan puguh, eta disarankeun pikeun mimitian ku 1. pikeun item kahiji, sabab Markdown bisa ngarojong atribut mimiti daptar maréntahkeun dina mangsa nu bakal datang.

Daptar tag item biasana disimpen dina tebih kénca, tapi bisa indented, nepi ka 3 spasi, sarta tag item kudu dituturkeun ku sahanteuna hiji spasi atawa tab.

Pikeun ngajantenkeun daptar langkung saé, anjeun tiasa ngatur eusi kalayan indent tetep:

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

Tapi upami anjeun puguh, éta ogé henteu kunanaon:

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

Upami daptar barang dipisahkeun ku garis kosong, Markdown bakal nganggo eusi barang nalika ngaluarkeun HTML. <p> Label dibungkus, contona:

*   Bird
*   Magic

bakal dirobah jadi:

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

Tapi ieu:

*   Bird

*   Magic

bakal dirobah jadi:

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

Daptar item bisa ngandung sababaraha paragraf, sarta paragraf dina unggal item kudu indented ku 4 spasi atawa 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.

Sigana langkung saé upami anjeun indent unggal garis, tangtosna, deui, upami anjeun puguh, Markdown ogé ngamungkinkeun:

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

Upami anjeun hoyong nempatkeun rujukan dina daptar item, teras > Éta kedah dilebetkeun:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Upami anjeun hoyong nempatkeun blok kode, blok éta kedah dilebetkeundua kali, nyaéta 8 spasi atanapi 2 tab:

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

        <代码写在这>

Tangtosna, daptar barang tiasa didamel teu kahaja, sapertos kieu:

1986. What a great season.

Dina basa sejen, nembongan dina awal garisangka-jaman-kosong, Pikeun ngahindarkeun ieu, anjeun tiasa nambihan backslash sateuacan periode.

1986\. What a great season.

blok kode

Tulisan anu aya hubunganana sareng program atanapi kode sumber basa tag biasana parantos ngagaduhan blok kode typeset. Biasana, urang henteu hoyong blok-blok ieu disetél dina cara file paragraf umum, tapi ningalikeunana sakumaha aranjeunna. Markdown bakal ngagunakeun <pre> 和 <code> tag pikeun bungkus blok kode.

Ngawangun blok kode dina Markdown saderhana sapertos indenting 4 spasi atanapi 1 tab, contona, lebetkeun ieu:

这是一个普通段落：

    这是一个代码区块。

Markdown bakal dirobih janten:

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

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

Indentasi urutan kahiji ieu per baris (4 spasi atawa 1 tab) dipiceun, contona:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

bakal dirobah jadi:

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

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

Hiji blok kode terus nepi ka garis unindented (atawa tungtung file).

Di jero blok kode, & , < 和 > Éta bakal otomatis dirobih kana éntitas HTML. Metoda ieu ngagampangkeun anjeun ngagunakeun Markdown pikeun nyelapkeun kode sumber HTML contona, ngan ukur salin sareng témpél, tambahkeun indentation, sareng Markdown sésana bakal nanganan pikeun anjeun, pikeun conto:

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

bakal dirobah jadi:

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

Dina blok kode, sintaksis Markdown umum moal dirobih, sapertos tanda bintang ngan ukur tanda bintang, anu hartosna anjeun tiasa nyerat file anu aya hubunganana sareng Markdown dina sintaksis Markdown.

ngabagi

Anjeun tiasa nyieun divider kalawan leuwih ti tilu tanda bintang, tanda minus, underscores dina garis, euweuh nu sejenna dina garis.Anjeun ogé tiasa nyelapkeun spasi antara tanda bintang atanapi tanda minus.Garis pamisah tiasa didamel dina unggal cara nyerat:

* * *

***

*****

- - -

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

unsur bagian

link

Markdown ngadukung dua bentuk sintaksis tautan: Baris和Rujukandua wujud.

Barina ogé, téks link ditandaan ku [kurung kuadrat].

pikeun nyiptakeun aBarisUpami anjeun hoyong nambihan téks judul tautan, bungkus téks judul kalayan tanda petik ganda saatos URL, contona:

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

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

Bakal ngahasilkeun:

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

Upami anjeun nyambungkeun sumber daya dina host anu sami, anjeun tiasa nganggo jalur relatif:

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

RujukanLink ieu dituturkeun ku bracket pasagi séjén sanggeus bracket téks link, sarta tanda dipaké pikeun ngaidentipikasi link kudu dieusian dina bracket kuadrat kadua:

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

Anjeun oge bisa opsional nempatkeun spasi antara dua kurung kuadrat:

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

Teras, dimana waé dina file, anjeun tiasa nangtukeun eusi tautan tina tag ieu:

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

Eusi link didefinisikeun dina bentuk:

• Tanda kurung pasagi (opsional dipiheulaan ku nepi ka tilu spasi pikeun indentation) kana téks link diasupkeun
• dituturkeun ku titik dua
• dituturkeun ku hiji atawa leuwih spasi atawa tab
• URL link salajengna
• Opsional turutan eusi judul, anu tiasa diapit ku tanda petik tunggal, tanda petik ganda, atanapi kurung

Watesan tina tilu tautan di handap ieu sami:

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

ati-ati:Aya masalah anu dipikanyaho dimana Markdown.pl 1.0.1 teu malire judul tautan anu dikurilingan ku tanda petik tunggal.

URL link ogé tiasa diapit ku kurung sudut:

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

Anjeun oge bisa nempatkeun atribut judul dina baris salajengna, atawa tambahkeun sababaraha indentation, nu bakal kasampak hadé lamun URL panjang teuing:

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

Definisi URL ngan ukur dianggo nalika ngahasilkeun tautan, sareng henteu langsung muncul dina file.

Tag idéntifikasi link tiasa ngandung hurup, angka, spasi bodas, sareng tanda baca, tapi henteuHenteuÉta sénsitip kana hurup, janten dua tautan di handap ieu sami:

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

tag link implisitfitur ngidinan Anjeun pikeun ngaleungitkeun nangtukeun tag link. Dina hal ieu, tag link bakal dianggap sarua jeung téks link. Pikeun ngagunakeun tag link implisit, ngan nambahan hiji bracket pasagi kosong sanggeus téks link. Upami anjeun hoyong "Google" " Numbu ka google.com, anjeun tiasa nyederhanakeun kana:

[Google][]

Teras tangtukeun eusi tautan:

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

Kusabab téks link tiasa ngandung spasi bodas, markup saderhana ieu tiasa ngandung sababaraha kecap:

Visit [Daring Fireball][] for more information.

Teras teraskeun pikeun nangtukeun tautan:

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

Definisi link tiasa ditempatkeun dimana waé dina file. Abdi langkung resep nempatkeun éta langsung saatos paragraf dimana tautan muncul. Anjeun ogé tiasa nempatkeun éta dina tungtung file, sapertos koméntar.

Ieu conto tautan 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"

Upami anjeun ngarobih éta nganggo nami tautan pikeun nyerat:

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 nulis di luhur bakal ngahasilkeun HTML handap.

<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 handap ieu mangrupa file Markdown eusi sarua ditulis inline, disadiakeun pikeun babandingan:

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

Sabenerna, titik tumbu gaya rujukan lain yén leuwih gampang nulis, tapi leuwih gampang dibaca. Bandingkeun conto di luhur. Artikel gaya rujukan sorangan ngan 81 karakter, tapi bentuk inline bakal ningkat kana 176 karakter. , lamun ditulis dina format HTML murni, bakal aya karakter 234. Dina format HTML, aya leuwih tag ti téks.

Nganggo tautan gaya rujukan Markdown, anjeun tiasa ngajantenkeun dokumén sapertos hasil ahir browser, ngamungkinkeun anjeun pikeun mindahkeun sababaraha metadata anu aya hubunganana sareng markup di luar teks paragraf, sareng anjeun tiasa nambihan tautan tanpa ngajantenkeun maca tulisan. .

Nekenkeun

Markdown ngagunakeun tanda bintang (*) jeung garis handap (_) salaku lambang pikeun nandaan kecap anu digaris handap, nyaéta * Atanapi _ Kecap dikurilingan dirobah jadi <em> dikurilingan ku labél, kalawan dua * Atanapi _Lamun dibungkus, bakal dirobah jadi <strong>, Salaku conto:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

bakal robah jadi:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

Anjeun tiasa make gaya naon anjeun resep, hijina watesan nyaeta anjeun bisa make simbol pikeun muka tag jeung simbol pikeun ngeureunkeun eta.

Tekenan ogé tiasa diselapkeun langsung di tengah téks:

un*frigging*believable

tapiupami anjeun * 和 _ Mun aya spasi bodas dina dua sisi, aranjeunna ngan dianggap salaku simbol normal.

Pikeun nyelapkeun tanda bintang normal atanapi garis handap langsung sateuacan sareng saatos téks, anjeun tiasa nganggo garis miring:

\*this text is surrounded by literal asterisks\*

Kode

Upami anjeun hoyong nyirian sapotong leutik kode inline, anjeun tiasa mungkus ku tanda tonggong (`), Misalna:

Use the `printf()` function.

Bakal ngahasilkeun:

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

Upami anjeun hoyong nyelapkeun backticks dina bagian kode, anjeun tiasa ngamimitian sareng ngeureunkeun bagian kode kalayan sababaraha backticks:

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

Sintaksis ieu ngahasilkeun:

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

Anjeun tiasa nempatkeun kosong di awal sareng tungtung bagian kode, hiji saatos awal sareng hiji sateuacan akhir, ku kituna anjeun tiasa nyelapkeun backticks di awal bagian:

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

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

Bakal ngahasilkeun:

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

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

Dina bagian kode,& jeung kurung sudut都bakal otomatis dirobih kana éntitas HTML, anu matak ngagampangkeun nyelapkeun kode sumber HTML, Markdown bakal nempatkeun paragraf ieu:

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

ka:

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

Anjeun ogé tiasa nyerat ieu:

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

Pikeun ngahasilkeun:

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

图片

Jelas, hese mendesain sintaksis "alami" pikeun nyelapkeun gambar dina aplikasi ngan ukur téks.

Markdown nganggo sintaksis anu sami sareng tautan pikeun nyirian gambar, sareng ogé ngamungkinkeun dua gaya: Baris和Rujukan.

Sintaksis gambar inline sapertos kieu:

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

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

Rincianna nyaéta kieu:

• tanda seru !
• dituturkeun ku bracket pasagi kalawan alt téks pikeun gambar
• Ieu dituturkeun ku kurung normal jeung URL gambar, sarta tungtungna hiji pilihan téks 'judul' enclosed dina tanda petik.

Sintaksis gambar rujukan sapertos kieu:

![Alt text][id]

"id" nyaéta ngaran rujukan gambar, anu dihartikeun dina cara nu sarua salaku rujukan link:

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

Sajauh ieu, Markdown teu gaduh cara pikeun nangtukeun lebar sareng jangkungna gambar, upami anjeun peryogi, anjeun tiasa nganggo anu normal. <img> Label.

其它

link otomatis

Markdown ngadukung ngolah URL sareng kotak surat email dina bentuk tautan otomatis anu kawilang pondok. Salami aranjeunna ditutupan ku kurung sudut, Markdown bakal otomatis ngarobih kana tautan.Teks tautan URL umum sami sareng alamat tautan, contona:

<http://example.com/>

Markdown bakal dirobih janten:

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

The linking otomatis tina alamat surélék ogé sarupa, iwal Markdown mimitina bakal ngalakukeun hiji prosés konvérsi encoding, ngarobah karakter téks kana éntitas HTML hexadecimal.

<[email protected]>

Markdown bakal janten:

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

Dina browser, string ieu (saleresna <a href="mailto:[email protected]">[email protected]</a>) janten link "[email protected]" anu tiasa diklik.

(Sanajan pendekatan ieu bisa fool loba robot, éta moal bisa ngeureunkeun kabeh, tapi leuwih hade tinimbang nanaon. Dina sagala hal, muka kotak surat anjeun antukna bakal narik hurup iklan.)

backslash

Markdown tiasa nganggo backslashes pikeun nyelapkeun simbol anu gaduh hartos sanés dina grammar, contona: upami anjeun hoyong nambihan tanda bintang di gigireun téks pikeun tekenan (tapi henteu. <em> tag), anjeun tiasa miheulaan tanda bintang ku backslash:

\*literal asterisks\*

Markdown ngadukung simbol-simbol di handap ieu anu diawalan ku backslash pikeun ngabantosan nyelapkeun simbol umum:

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

Markdown redaktur gratis

platform Windows

• MarkdownPad
• MarkPad

platform Mac

• hipu

redaktur online

• MPEditor

plugin browser

• Markdown dieu plugin

*** Upami aya pangropéa Markdown gratis anu langkung saé pikeun nyarankeun, punten perhatoskeun eupan balikChen Weiliang, hatur nuhun!