Markdown’a Giriş – Linux ipucu

indirim

Markdown, bir metinden HTML’ye dönüştürücüdür. Bugün, neredeyse hafif bir biçimlendirme açıklama dili sınıfıyla eşanlamlı hale geldi. Düz metin biçimlendirme sözdizimini kullanır. Markdown’ın arkasındaki fikir, web sayfaları ve özellikle blog girişleri yazmayı e-posta yazmak kadar kolay hale getirmekti. Kasım 2017’de hedefe ulaşıldı ve Markdown, Asciidoc türevleri, Asciidoctor ve Asciidoctor-pdf yaygın olarak kullanıldı.

Markdown yalnızca düz metne odaklanır ve HTML’de bulunan diğer tüm karmaşıklıklardan kaçınır. Basit tutulduğu için öğrenmesi kolaydır, bu nedenle minimum karakter kullanıldığından daha hızlıdır ve sonunda daha az hata olasılığıyla sonuçlanır. Markdown Stackedit düzenleyicisinde işlenen temel bir belge için Şekil 1’e bakın. Solda kaynak kodunu ve sağda ilgili HTML çıktısını görürsünüz. Başlıkların yalnızca adres hiyerarşisinin düzeyine bağlı olarak #s dizisiyle işaretlendiğini fark edebilirsiniz.

Metin dönüştürme

Düz metin, Markdown veya Pandoc gibi komut satırı araçları kullanılarak XHTML’ye (HTML) ve diğer birçok biçime dönüştürülebilir. Temel olarak, her iki araç da yalnızca HTML parçaları oluşturur ve çıktıyı stdout’a yazar. Pandoc, HTML çıktısını belirtilen dosyaya yazmak için “-o dosya adı” anahtarını sağlar. Aşağıda gösterildiği gibi, çıktı dosyası basic.html olarak adlandırılır ve bir HTML bölümü içerir – iki başlık ve bir paragraf.

$ pandoc -o basic.html basic.md. $ kedi temel.html. 
önsöz
Bir makineden sorumlu olmak, yazılım bileşenlerinin yanı sıra donanıma da özen göstermek anlamına gelir. Günlük hayatta bir sistem yöneticisi olarak görüldüğü gibi, yazılımı bir sürü kaynak dosyadan ziyade bir yazılım paketi olarak kurmak çok daha iyidir. Bu, sistemi düzgün bir şekilde koruma maliyetlerini azaltır. $

Tam bir HTML başlığına sahip bağımsız HTML belgeleri oluşturmak için Pandoc “-s” anahtarını şu şekilde kabul eder:

$ pandoc -o basic.html -s basic.md. $ kedi temel.html. 
önsöz
Bir makineden sorumlu olmak, yazılım bileşenlerinin yanı sıra donanıma da özen göstermek anlamına gelir. Günlük hayatta bir sistem yöneticisi olarak görüldüğü gibi, yazılımı bir sürü kaynak dosyadan ziyade bir yazılım paketi olarak kurmak çok daha iyidir. Bu, sistemi düzgün bir şekilde koruma maliyetlerini azaltır. 

İçeriği görsel sunumdan ayrı tutmanın avantajı, sitenizin görünümünü bozmamasıdır. John Gruber ve Aaron Swartz tarafından geliştirilen Sürüm 1.0.1, Aralık 2004’te yayınlandı ve ücretsiz yazılım olarak sunuluyor (bu makalenin sonundaki bağlantılara bakın).

metin öğeleri

Takma adlar

İlgili HTML düzeyine göre # ile başlıklar şu şekilde yazılır:

#H1. ## H2. ### H3. #### H4. ##### H5. ###### H6. 

H1 ve H2 için iki alternatif yazım şekli kabul edilmektedir:

H1. == H2. --

Lütfen eşittir işareti veya tire sayısının adresteki karakter sayısıyla eşleşmesi gerektiğini unutmayın.

Metin vurgulama

Metin vurgulama için aşağıdaki öğeler desteklenir:

• Ters eğik çizgi: Bir yıldız veya bir alt çizgi
  —-
  *önemli* ve _çok önemli_
  —-
• Kalın metin: Çift yıldız veya çift alt çizgi
  —-
  **önemli** ve __ayrıca önemli__
  —-
• Üstü çizili metin: çift tilde
  —-
  ~~ Metin ~~
  —-

listeler

Markdown, sırasız ve sıralı listeleri destekler. Sıralamalı listeler yıldız, artı veya eksi ile başlar. Dereceli listeler sadece bir numara ile başlar. Alt menüler oluşturmak için menü öğesini aşağıda görebileceğiniz gibi iki boşlukla (Markdown, StackEdit) veya dört boşlukla (Pandoc) girintileyin:

1. meyveler * elma * muz. 2. içecekler + su + süt. 

resimler

En kolay yol, satır içi stili şu şekilde kullanmaktır:

![Debian Logosu](debian-logo.png “Debian Logosu”)

Bu, başvurulan görüntüyü görüntüler. Farenizi görselin üzerine getirdiğinizde ilgili açıklama metnini göreceksiniz.

Kod ve sözdizimi vurgulama

Satır içi kod ve kod blokları olmak üzere iki farklı türü vardır. Satır içi kod, “Yazdır (“Merhaba, dünya!”)” gibi üç ters etiketle çerçevelenir. Kod blokları ayrıca üç arka etiketle başlar ve biter, ancak bunun gibi ayrı satırlarda:

``` yazdır (“Merhaba dünya!”) ```

Markdown, sözdizimi vurgulamayı desteklemez, ancak burada Markdown gibi lehçeleri destekler.

masalar

Markdown tabloları desteklemez, ancak GFM ve Markdown Here gibi uzantıları destekler.

alıntı bloğu

Blok alıntılar yalnızca “>” işaretiyle başlar. Metinden alıntı yapmak çok faydalı olur.

> "Ah! Birinin ne yapması gerektiğine dair kesin ve kesin bir kuralın olması saçmadır. > okuyun ve ne olmamalı. Modern kültürün yarısından fazlası buna bağlıdır. > okunmaması gerekenler üzerine." > > Ciddi Olmanın Önemi. (Oscar Wilde)

bağlantılar

Bağlantılar, geçerli belgedeki diğer belgelere veya bölümlere işaret eder. Yazı tipi stili resimlere benzer ve köşeli parantez içindeki bağlantı açıklamasından ve normal parantez içindeki URL’den oluşur.

[Ben satır içi tarzı bir bağlantıyım]( 

Alternatif metin de ekleyebilirsiniz:

[Ek metin içeren satır içi stilde bir bağlantıyım](  "Linux İpucu")

Bağlantılara şu şekilde başvurulabilir:

[Linuxİpucu][1] … Bazı metin... [1]: .

Bu, akademik belgelerde olduğu gibi, belgenizin sonunda kolayca referans listeleri oluşturmanıza olanak tanır.

çözüm

Markdown çok basittir ve içeriği düzenli olarak belgeleyen ve yayınlayan herkes için bir zorunluluktur. Onu kullanmak bir zevk.

Referanslar

• yığını düzenle,
• pansiyon,
• indirim,
• işaretleme hile sayfası,