Markdown'ın anlamı nedir? Markdown sözdizimi/biçimlendirme işaretlemesi nasıl kullanılır?

MarkdownNe demek?

Markdown sözdizimi/biçimlendirme işaretlemesi nasıl kullanılır?

Genel Bakış

Markdown, John Gruber tarafından oluşturulan hafif bir biçimlendirme dilidir.

İnsanların "okunması ve yazılması kolay düz metin biçiminde belgeler yazmasına ve ardından bunları geçerli XHTML (veya HTML) belgelerine dönüştürmesine" olanak tanır.

Dil, e-postada zaten bulunan düz metin işaretlemenin birçok özelliğini bünyesinde barındırır.

John Gruber, 2004 yılında, büyük ölçüde sözdiziminde Aaron Swartz ile işbirliği içinde Markdown dilini yarattı.Dilin amacı, "okunması kolay, yazması kolay ve isteğe bağlı olarak geçerli XHTML'ye (veya HTML) dönüştüren düz bir metin biçimi" kullanmaktır.

amaç

Markdown'ın amacı "okunması ve yazılması kolay" olmaktır.

okunabilirlik, yine de yapİnternet pazarlamacılığı, kullanıcı deneyimi çok önemlidir.

Markdown'da yazılan bir dosya doğrudan düz metin olarak yayınlanabilmeli ve çok sayıda etiket veya biçimlendirme yönergesinden oluşuyormuş gibi görünmemelidir.

Markdown sözdizimi, Settext, atx, Textile, reStructuredText, Grutatext ve EtText dahil olmak üzere bazı mevcut metinden HTML'ye formatlardan etkilenir, ancak en büyük ilham kaynağı düz metin e-posta formatıdır.

Kısacası, Markdown'ın sözdizimi, özenle seçilmiş ve işlevleri bir bakışta net olan sembollerden oluşur.Örneğin: *vurgu* gibi görünmesi için metnin etrafına yıldız işaretleri koyun.

Markdown'daki listeler, listelere benziyor. Markdown'daki blok alıntılar, e-postalarda gördüğünüz gibi, gerçekten bir metinden alıntı yapmaya benziyor.

HTML ile uyumlu

Markdown dilbilgisinin amacı, web için bir yazı dili olmaktır.

Markdown, HTML'nin yerini almak veya hatta ona yaklaşmak anlamına gelmez, çok az sözdizimi türüne sahiptir ve yalnızca küçük bir HTML biçimlendirme alt kümesine karşılık gelir. Markdown, HTML belgelerinin yazılmasını kolaylaştırmak için tasarlanmamıştı.

Bence HTML yazmak zaten çok kolay. Markdown fikri, belgelerin okunmasını, yazılmasını ve istendiğinde değiştirilmesini kolaylaştırmaktır. HTML bir yayımlama biçimidir, Markdown ise birMetin Yazarlığıyazılı biçimi.Bu nedenle, Markdown'ın biçimlendirme sözdizimi yalnızca düz metnin yapabileceklerini kapsar.

Markdown kapsamına girmeyen etiketler doğrudan belgeye HTML olarak yazılabilir.Web Promosyonukopyala.Bunu HTML veya Markdown olarak işaretlemeye gerek yoktur; sadece işaretlemeyi doğrudan ekleyin.

Yalnızca bazı HTML blok öğeleri kısıtlanmıştır - örneğin <div>,<table>,<pre>,<p> ve diğer etiketler, diğer içerik alanlarından önce ve sonra boş satırlarla ayrılmalı, açılış ve kapanış etiketleri sekme veya boşluklarla girintili olmamalıdır. Markdown oluşturucu, gereksiz HTML blok etiketleri eklemeyecek kadar akıllıdır <p> Etiket.

Örnek, Markdown dosyasına bir HTML tablosu ekleyerek aşağıdaki gibidir:

这是一个普通段落。

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

这是另一个普通段落。

HTML blok etiketleri arasındaki Markdown biçimlendirme sözdiziminin işlenmeyeceğini unutmayın.Örneğin, HTML bloklarının içinde Markdown stilini kullanırsanız*强调*hiçbir etkisi olmayacaktır.

gibi HTML bölümü (satır içi) etiketleri <span>,<cite>,<del> Markdown paragraflarında, listelerinde veya başlıklarında serbestçe kullanılabilir.Kişisel alışkanlıklara göre, Markdown biçimini kullanmadan biçimlendirmek için HTML etiketlerini bile kullanabilirsiniz.Örnek: HTML'yi tercih ediyorsanız <a> 或 <img> Markdown tarafından sağlanan bağlantı veya resim etiketi sözdizimi olmadan doğrudan kullanılabilen etiketler.

HTML blok etiketlerinden farklı olarak, Markdown sözdizimi HTML bölüm etiketleri arasında geçerlidir.

Özel karakterlerin otomatik dönüştürülmesi

HTML dosyalarında özel işlem gerektiren iki karakter vardır: < 和 & . < başlangıç ​​etiketleri için semboller kullanılır,& HTML varlıklarını işaretlemek için semboller kullanılır, sadece bu karakterlerin prototipini görüntülemek istiyorsanız, varlık formunu kullanmanız gerekir. < 和 &.

& "Yazacaksanız, karakterler özellikle web belgesi yazarları için eziyet ediyor.AT&T"yazmalısın"AT&T".URL'deyken & Karakterler de dönüştürülür.Örneğin, aşağıdakilere bağlanmak istiyorsunuz:

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

URL dönüşümünü şu şekilde yazmalısınız:

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

bağlantı etiketine yerleştirilecek href özelliklerde.Söylemeye gerek yok, bunu görmezden gelmek kolaydır ve muhtemelen HTML standartları doğrulaması tarafından tespit edilen en fazla sayıda hatadır.

Markdown, karakterleri doğal olarak yazmanıza izin verir ve neyin dönüştürülmesi gerektiğine bakar.Eğer kullanırsan & Bir karakter, bir HTML karakter varlığının parçasıdır, olduğu gibi bırakılır, aksi takdirde dönüştürülür. &;.

Bu nedenle, belgeye bir telif hakkı simgesi eklemek istiyorsanız ©, Yazabilirsin:

©

Markdown, dokunmadan bırakacaktır.Ve yazarsanız:

AT&T

Markdown onu şuna dönüştürür:

AT&T

Benzer bir durum şurada da yaşanıyor < notasyon, Markdown, HTML uyumluluğuna izin verdiğinden, < Semboller, HTML etiketleri için sınırlayıcı olarak kullanılır ve Markdown bunlar üzerinde herhangi bir dönüşüm yapmaz, ancak şunu yazarsanız:

4 < 5

Markdown onu şuna dönüştürür:

4 < 5

Ancak belirtmek gerekir ki kod kapsamında ister inline ister blok olsun, < 和 & her iki sembolkesinlikleHTML kodunu Markdown'da kolayca yazmanıza izin veren bir özellik olan HTML varlıklarına dönüştürülür (tüm < 和 & HTML dosyasına HTML kodu yazmak için tümü HTML varlıklarına dönüştürülür. )

blok elemanı

Paragraflar ve satır sonları

Markdown paragrafı, önünde ve ardından birden fazla boş satırın geldiği bir veya daha fazla ardışık metin satırından oluşur (boş satırın tanımı, ekranda boş görünmesi ve boş bir satır olarak kabul edilmesidir. Örneğin, , bir satırda yalnızca boşluklar ve sekmeler varsa, satır boş satır olarak da değerlendirilir).Normal paragraflar boşluk veya sekmelerle girintili olmamalıdır.

"Bir veya daha fazla ardışık metin satırından oluşur" ifadesi, aslında Markdown'ın paragraflar içinde zorunlu yeni satırlara (yeni satırların eklenmesine) izin verdiğini ima eder; bu, diğer metinden HTML'ye formatların çoğundan farklı bir özelliktir (Movable Type "Satır Sonlarını Dönüştür dahil" " seçeneği), diğer biçimler her satır sonunu <br /> Etiket.

Eğer senaslındaEklemek için Markdown'a güvenmek istiyorum <br /> Etiketler için, ekleme yerinde iki veya daha fazla boşluğa basın ve ardından Enter'a basın.

Gerçekten de, oluşturmak için biraz daha fazla çalışma (ilave boşluklar) gerekir. <br /> , ancak basitçe "her yeni satır <br />"Yöntem Markdown'da uygun değil, Markdown'da emaiL tarzı blok alıntılar ve çok paragraflı listeler yalnızca daha kullanışlı olmakla kalmaz, aynı zamanda satır sonlarıyla dizgi yaparken daha kolay okunur.

manşet

Markdown, başlıklar için Settext benzeri ve atx benzeri olmak üzere iki sözdizimini destekler.

Settext-benzeri form, alt satırı olan formdur. = (en yüksek başlık) ve - (İkinci dereceden başlıklar), örneğin:

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

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

herhangi bir miktar = 和 - etkili olabilir.

Atx benzeri form satırın başına 1'den 6'ya kadar ekler # , 1'den 6'ya kadar olan başlıklara karşılık gelir, örneğin:

# 这是 H1

## 这是 H2

###### 这是 H6

İsteğe bağlı olarak atx benzeri başlıkları "kapatabilirsiniz", bu tamamen estetik amaçlıdır, bu şekilde kendinizi rahat hissediyorsanız satır sonuna ekleyebilirsiniz. #, satır sona ererken # Sayının başlangıçla aynı olması gerekmez (satırın başındaki pound karakterlerinin sayısı başlığın sırasını belirler):

# 这是 H1 #

## 这是 H2 ##

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

Blok alıntılar Blok alıntılar

İşaretleme işaretleme blok alıntıları, e-postada kullanılanlara benzer şekilde kullanılır > alıntılar.E-posta mektuplarındaki alıntılara aşinaysanız, bir Markdown dosyasında satırları kendiniz kesiyormuşsunuz gibi görünen bir blok alıntı oluşturmayı bilirsiniz, sonra ekleyin. > :

> 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 ayrıca tembel olmanıza ve tüm paragrafın yalnızca ilk satırını eklemenize olanak tanır. > :

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

Blok referansları farklı sayıda eklenerek iç içe yerleştirilebilir (örneğin: referanslar içindeki referanslar). > :

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

Diğer Markdown sözdizimleri, başlıklar, listeler, kod blokları vb. dahil olmak üzere alıntılanan bloklarda da kullanılabilir:

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

Herhangi bir uygun metin düzenleyici, kolayca e-posta stili alıntılar oluşturabilir.Örneğin BBEdit'te metni seçebilir ve ardından menüden seçim yapabilirsiniz.alıntı hiyerarşisini artır.

列表

Markdown, sıralı ve sırasız listeleri destekler.

Sırasız listeler, liste işaretleri olarak yıldız işaretleri, artı işaretleri veya eksi işaretleri kullanır:

*   Red
*   Green
*   Blue

Eşittir:

+   Red
+   Green
+   Blue

Ayrıca şuna eşdeğerdir:

-   Red
-   Green
-   Blue

Sıralı listeler, bir noktanın takip ettiği sayıları kullanır:

1.  Bird
2.  McHale
3.  Parish

Liste etiketinde kullandığınız sayıların çıktı HTML'sini etkilemediğine dikkat etmek önemlidir. Yukarıdaki liste için elde edilen HTML işaretlemesi şöyle olacaktır:

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

Liste işaretlemeniz şu şekilde yazılırsa:

1.  Bird
1.  McHale
1.  Parish

ya da:

3. Bird
1. McHale
8. Parish

İkiniz de tam olarak aynı HTML çıktısını alacaksınız.Mesele şu ki, Markdown dosyasındaki liste numaralarını çıktı sonuçlarıyla aynı hale getirebilirsiniz veya tembelseniz, sayıların doğruluğunu hiç umursamanıza gerek kalmaz.

Tembel yazma kullanıyorsanız, ilk öğe için 1 ile başlamanız önerilir, çünkü Markdown gelecekte sıralı listelerin başlangıç ​​niteliğini destekleyebilir.

Liste öğesi etiketi genellikle en sol tarafa yerleştirilir, ancak 3 boşluğa kadar girintilenebilir ve öğe etiketinin ardından en az bir boşluk veya sekme gelmelidir.

Listenin daha güzel görünmesi için içeriği sabit bir girinti ile düzenleyebilirsiniz:

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

Ama tembelsen, bu da sorun değil:

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

Liste öğeleri boş satırlarla ayrılmışsa, Markdown HTML çıktısı alırken öğe içeriğini kullanır. <p> Etiketler sarılır, örneğin:

*   Bird
*   Magic

dönüştürülecektir:

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

Ama bu:

*   Bird

*   Magic

dönüştürülecektir:

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

Liste öğeleri birden çok paragraf içerebilir ve her öğenin altındaki paragraflar 4 boşluk veya 1 sekme ile girintili olmalıdır:

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.

Her satırı girintilerseniz çok daha iyi görünür, tabii ki yine tembelseniz, Markdown ayrıca şunları sağlar:

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

Bir liste öğesinin içine bir referans koymak istiyorsanız, o zaman > Girintili olması gerekiyor:

*   A list item with a blockquote:

    > This is a blockquote
    > inside a list item.

Bir kod bloğu koymak istiyorsanız, bloğun girintili olması gerekir.iki defa, 8 boşluk veya 2 sekme:

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

        <代码写在这>

Tabii ki, yanlışlıkla bir öğe listesi oluşturulabilir, bunun gibi bir şey:

1986. What a great season.

Başka bir deyişle, satırın başında görünür.sayı-nokta-boş, bunu önlemek için noktadan önce ters eğik çizgi ekleyebilirsiniz.

1986\. What a great season.

kod bloğu

Programla ilgili yazma veya etiket dili kaynak kodu genellikle zaten dizgi kod bloklarına sahiptir.Genellikle, bu blokların genel paragraf dosyaları biçiminde dizilmesini istemiyoruz, ancak oldukları gibi görüntüleyin.Markdown kullanacaktır. <pre> 和 <code> kod bloklarını sarmak için etiketler.

Markdown'da kod blokları oluşturmak, 4 boşluk veya 1 sekmeyi girintilemek kadar basittir.Örneğin, aşağıdakini girin:

这是一个普通段落：

    这是一个代码区块。

Markdown şuna dönüştürülür:

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

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

Satır başına bu birinci dereceden girinti (4 boşluk veya 1 sekme) kaldırılır, örneğin:

Here is an example of AppleScript:

    tell application "Foo"
        beep
    end tell

dönüştürülecektir:

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

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

Bir kod bloğu, girintisiz satıra (veya dosyanın sonuna) kadar devam eder.

Kod bloğunun içinde, & , < 和 > Otomatik olarak HTML varlıklarına dönüştürülecektir.Bu yöntem, örnek için HTML kaynak kodunu eklemek için Markdown'ı kullanmanızı çok kolaylaştırır, sadece kopyalayıp yapıştırın, girinti ekleyin ve gerisini Markdown sizin için halledecektir. örnek:

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

dönüştürülecektir:

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

Kod bloğunda, genel Markdown sözdizimi dönüştürülmez, örneğin yıldız işaretleri yalnızca yıldız işaretleridir; bu, Markdown sözdizimiyle ilgili dosyaları Markdown sözdiziminde kolayca yazabileceğiniz anlamına gelir.

bölücü

Bir satırda üçten fazla yıldız işareti, eksi işareti, alt çizgi içeren bir ayırıcı oluşturabilirsiniz, satırda başka hiçbir şey yoktur.Yıldız işaretleri veya eksi işaretleri arasına boşluk da ekleyebilirsiniz.Ayırma çizgileri, aşağıdaki yazma yollarının her birinde oluşturulabilir:

* * *

***

*****

- - -

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

bölüm elemanı

bağlantı

Markdown, iki bağlantı sözdizimi biçimini destekler: Çizgide和Referansiki form.

Her iki durumda da bağlantı metni [köşeli parantezler] ile işaretlenmiştir.

Oluşturmak içinÇizgideBağlantının başlık metnini eklemek istiyorsanız, başlık metnini URL'den sonra çift tırnak işareti içine almanız yeterlidir, örneğin:

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

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

Üretecek:

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

Aynı ana bilgisayardaki kaynaklara bağlanıyorsanız, göreli yolları kullanabilirsiniz:

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

ReferansBağlantı metninin parantezinden sonra bağlantıyı başka bir köşeli parantez takip eder ve bağlantıyı tanımlamak için kullanılan işaret ikinci köşeli parantez içinde doldurulmalıdır:

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

Ayrıca isteğe bağlı olarak iki köşeli parantez arasına boşluk da koyabilirsiniz:

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

Ardından, dosyanın herhangi bir yerinde bu etiketin bağlantı içeriğini tanımlayabilirsiniz:

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

Bağlantı içeriği şu şekilde tanımlanır:

• Bağlantı metninin girildiği köşeli parantezler (isteğe bağlı olarak önünde girinti için en fazla üç boşluk bulunur)
• ardından kolon
• ardından bir veya daha fazla boşluk veya sekme gelir
• sonraki bağlantının URL'si
• İsteğe bağlı olarak, tek tırnak, çift tırnak veya parantez içine alınabilecek başlık içeriğini takip edin

Aşağıdaki üç bağlantının tanımları aynıdır:

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

Dikkat:Markdown.pl 1.0.1'in tek tırnak içine alınmış bağlantı başlıklarını yok saydığı bilinen bir sorun vardır.

Bağlantı URL'leri ayrıca köşeli parantez içine alınabilir:

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

Ayrıca başlık özelliğini bir sonraki satıra koyabilir veya URL çok uzunsa daha iyi görünecek bazı girintiler ekleyebilirsiniz:

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

URL tanımları yalnızca bağlantılar oluşturulurken kullanılır ve doğrudan dosyada görünmez.

Bağlantı tanımlama etiketleri harfler, sayılar, boşluklar ve noktalama işaretleri içerebilir, ancakdeğilBüyük/küçük harf duyarlıdır, bu nedenle aşağıdaki iki bağlantı aynıdır:

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

Örtülü bağlantı etiketiözelliği, bir bağlantı etiketi belirtmeyi atlamanıza olanak tanır. Bu durumda, bağlantı etiketi, bağlantı metnine eşdeğer olarak ele alınacaktır. Örtülü bir bağlantı etiketi kullanmak için, bağlantı metninden sonra boş bir köşeli parantez eklemeniz yeterlidir. "Google" istiyorsanız " google.com'a bağlayarak şunları basitleştirebilirsiniz:

[Google][]

Ardından bağlantı içeriğini tanımlayın:

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

Bağlantı metni boşluk içerebileceğinden, bu basitleştirilmiş biçimlendirme birden çok kelime içerebilir:

Visit [Daring Fireball][] for more information.

Ardından bağlantıyı tanımlamaya devam edin:

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

Bağlantının tanımı dosyanın herhangi bir yerine yerleştirilebilir.Ben doğrudan bağlantının göründüğü paragraftan sonra koymayı tercih ederim.Ayrıca bir yorum gibi dosyanın sonuna da koyabilirsiniz.

İşte bir referans bağlantısı örneği:

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"

Yazmak için bağlantı adını kullanmak için değiştirirseniz:

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"

Yukarıdaki iki yazma yöntemi aşağıdaki HTML'yi üretecektir.

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

Aşağıda, karşılaştırma için sağlanan aynı içeriğe sahip satır içi yazılmış bir Markdown dosyası bulunmaktadır:

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

Aslında, referans tarzı bağlantıların amacı, daha kolay yazılmaları değil, daha kolay okunmalarıdır.Yukarıdaki örneği karşılaştırın.Referans tarzı makalenin kendisi sadece 81 karakterdir, ancak satır içi form artacaktır. 176 karakter. , saf HTML formatında yazılırsa 234 karakter olacaktır.HTML formatında metinden çok etiket vardır.

Markdown'ın referans stili bağlantılarını kullanarak, belgeyi tarayıcının nihai sonucu gibi yapabilir, biçimlendirmeyle ilgili bazı meta verileri paragraf metninin dışına taşımanıza izin verebilir ve makalenin okuma hissini vermeden bağlantılar ekleyebilirsiniz. .

强调

Markdown yıldız işaretleri kullanır (*) ve alt satırda (_) altı çizili bir kelimeyi işaretlemek için bir sembol olarak, * 或 _ Çevrelenen kelimeler dönüştürülür <em> etiketlerle çevrili, iki * 或 _Sarılırsa, dönüştürülür <strong>,Örneğin:

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

dönüşecek:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

İstediğiniz stili kullanabilirsiniz, tek sınırlama, etiketi açmak için sembolü ve bitirmek için sembolü kullanabilmenizdir.

Vurgu doğrudan metnin ortasına da eklenebilir:

un*frigging*believable

fakatEğer senin * 和 _ Her iki tarafta da boşluk varsa, bunlar sadece normal semboller olarak kabul edilir..

Metinden hemen önce ve sonra normal yıldız veya alt çizgi eklemek için ters eğik çizgi kullanabilirsiniz:

\*this text is surrounded by literal asterisks\*

Kod

Küçük bir satır içi kod parçasını işaretlemek istiyorsanız, onu ters tiklere sarabilirsiniz (`),Örneğin:

Use the `printf()` function.

Üretecek:

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

Bir kod bölümüne ters tik eklemek istiyorsanız, kod bölümünü birden fazla geri tik ile başlatabilir ve bitirebilirsiniz:

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

Bu sözdizimi şunları üretir:

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

Bir kod bölümünün başına ve sonuna, biri başından sonra diğeri de sonundan önce olmak üzere bir boşluk koyabilirsiniz, böylece bölümün başına ters tik ekleyebilirsiniz:

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

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

Üretecek:

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

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

Kod bölümünün içinde,& ve köşeli parantezler都HTML kaynak kodunu eklemeyi kolaylaştıran otomatik olarak HTML varlıklarına dönüştürülecek, Markdown aşağıdaki paragrafı koyacaktır:

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

ile:

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

Bunu da yazabilirsiniz:

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

Üretmek için:

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

图片

Açıkça görülüyor ki, salt metin içeren bir uygulamaya görüntü eklemek için "doğal" bir sözdizimi tasarlamak zordur.

Markdown, görüntüleri işaretlemek için bağlantılarınkine benzer bir sözdizimi kullanır ve ayrıca iki stile izin verir: Çizgide和Referans.

Satır içi görüntü sözdizimi şöyle görünür:

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

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

Detaylar aşağıdaki gibidir:

• ünlem işareti !
• ardından resim için alternatif metin içeren bir köşeli parantez
• Sonra normal bir parantez içine resmin URL'sini koyun ve son olarak onu tırnak içine alın ve isteğe bağlı bir 'başlık' metni ekleyin.

Referans görüntü sözdizimi şöyle görünür:

![Alt text][id]

"id", bağlantı referansıyla aynı şekilde tanımlanan resim referansının adıdır:

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

Şimdiye kadar, Markdown'ın görüntünün genişliğini ve yüksekliğini belirtmenin bir yolu yok, ihtiyacınız varsa normal kullanabilirsiniz. <img> Etiket.

其它

otomatik bağlantı

Markdown, URL'leri ve e-posta posta kutularını nispeten kısa otomatik bağlantılar biçiminde işlemeyi destekler.Açılı parantezler içine alındıkları sürece, Markdown onu otomatik olarak bir bağlantıya dönüştürür.Genel URL'nin bağlantı metni, bağlantı adresiyle aynıdır, örneğin:

<http://example.com/>

Markdown şuna dönüştürülecek:

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

E-posta adreslerinin otomatik olarak bağlanması da benzerdir, ancak Markdown'ın önce metin karakterlerini onaltılık HTML varlıklarına dönüştürerek bir kodlama dönüştürme işlemi gerçekleştirmesi dışında.Bu biçim bazı kötü e-posta adresi toplama robotlarını kandırabilir, örneğin:

<[email protected]>

Markdown şuna dönüşecek:

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

Tarayıcıda bu dize (aslında <a href="mailto:[email protected]">[email protected]</a>) tıklanabilir bir "[email protected]" bağlantısı haline gelir.

(Bu yaklaşım birçok robotu kandırabilse de, hepsini durduramaz, ama hiç yoktan iyidir. Her durumda, posta kutunuzu açmak sonunda reklam mektuplarını çekecektir.)

ters eğik çizgi

Markdown, dilbilgisinde başka anlamları olan semboller eklemek için ters eğik çizgi kullanabilir, örneğin: vurgu için metnin yanına yıldız işareti eklemek istiyorsanız (ancak <em> etiketi), yıldız işaretinin önüne ters eğik çizgi ile gelebilirsiniz:

\*literal asterisks\*

Markdown, ortak sembollerin eklenmesine yardımcı olmak için önünde bir ters eğik çizgi bulunan aşağıdaki sembolleri destekler:

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

Markdown ücretsiz düzenleyici

Windows platformu

• MarkdownPad
• MarkPad

Mac platformu

• Mou

çevrimiçi düzenleyici

• MPEditör

tarayıcı eklentisi

• Burada işaretleme eklentisi

*** Tavsiye edilecek daha iyi bir ücretsiz Markdown editörü varsa, lütfen geri bildirime dikkat edin.Chen Weiliang,Teşekkür ederim!