Yeni Başlayanlar İçin Markdown Kılavuzu: Başlamak için Bilmeniz Gereken Her Şey

İçindekiler

• Markdown nedir?
  • Markdown Kullanmanın Avantajları
• Markdown'a Başlarken
  • Markdown'da Temel Formatlama
  • Markdown'da gelişmiş biçimlendirme
• Markdown'da Gerçek Dünya Uygulamaları
• Kaynaklar

Hangi sektörde çalışırsanız çalışın, düşüncelerinizi ve fikirlerinizi açık ve öz bir şekilde sunabilmeniz önemlidir. Neyse ki, iyi metin içeriği oluşturmaya yardımcı olan bir dizi araç ve teknoloji mevcuttur.

Her türden yazar, programcı ve içerik oluşturucunun vazgeçilmezi haline gelen, çok yönlü ancak mütevazı bir işaretleme dili olan Markdown'a girin.

Markdown diyarında yeniyseniz korkmayın; Bu kılavuz, bu kullanıcı dostu işaretleme dilinde uzmanlaşmaya doğru yapacağınız yolculukta pusulanız olacak şekilde tasarlanmıştır.

Markdown Nedir?

Markdown, web ve diğer ortamlar için metni biçimlendirme sürecini basitleştiren hafif bir biçimlendirme dilidir . Kapsamlı teknik bilgi gerektirmeden kolayca HTML ve diğer formatlara dönüştürülebilen içerik yazmanın bir yolu olarak 2004 yılında John Gruber ve Aaron Swartz tarafından oluşturuldu.

Özellikle yazarlar, blog yazarları, programcılar ve web için metni biçimlendirmenin basit ve etkili bir yoluna ihtiyaç duyan herkes arasında popülerdir.

Markdown Kullanmanın Avantajları

1. Basitlik ve Okunabilirlik: Markdown, düz metin karakterlerini kullanan basit bir sözdizimi kullanır. Bu basitlik, öğrenmeyi ve kullanmayı kolaylaştırarak karmaşık biçimlendirme kodları yerine içeriğin kendisine odaklanmanıza olanak tanır.

2. Platform Bağımsızlığı: Markdown platformdan bağımsızdır. Herhangi bir cihazda metin düzenleyici veya kod düzenleyici kullanarak Markdown belgeleri oluşturabilirsiniz ve bu belgeler farklı platformlarda kolaylıkla görüntülenebilir ve çeşitli formatlara dönüştürülebilir. Bu tutarlılık, içeriğinizin erişilebilirliğini ve uzun ömürlülüğünü sağlar.

3. Hızlı Öğrenme Eğrisi: Markdown en kolay söz dizimlerinden birine sahiptir. Bu, kısa sürede öğrenebileceğiniz anlamına gelir. Sözdizimi sezgiseldir ve e-postalarda veya metin mesajlarında halihazırda kullanabileceğiniz biçimlendirmeye benzemektedir.

Bu hızlı öğrenme eğrisi, teknik bilgisi olmayan kullanıcılar için benimsemeyi teşvik eder.

4. Geniş Benimseme: Markdown büyük bir popülerlik kazandı ve aralarında WordPress gibi blog sistemleri, GitHub gibi işbirliği araçları ve içerik yönetim sistemlerinin de bulunduğu çok sayıda platformda destekleniyor. Bu, Markdown'ı birçok bağlamda uygulanabilecek değerli bir beceri haline getirir.

5. Hız ve Verimlilik: Markdown'da içerik oluşturmak hızlı ve etkilidir. Birkaç basit karakter ve diğer biçimlendirme öğeleriyle. Bu da karşılığında kullanıcılarının belgeleri basit, verimli ve hızlı bir şekilde oluşturmasına olanak tanır.

6. Sürüm Kontrolü: Markdown'u Git gibi sürüm kontrol sistemleriyle birlikte kullanırken, Markdown dosyalarında yapılan değişiklikleri takip etmek kolaydır. Bu, projeler üzerinde işbirliği yapmayı, değişiklikleri gözden geçirmeyi ve düzenlemelerin net bir kaydını tutmayı kolaylaştırır.

Markdown'a Başlarken

Markdown çeşitli metin editörlerinde ve kod editörlerinde çalışır. Bu makalenin amacına uygun olarak, kod editörlerinde, özellikle de VS Code'da işaretlemeyi kullanmaya odaklanacağız. Bununla birlikte, metin editörlerinde de aynı sözdizimi takip edilebilir.

1. Öncelikle VS Kodunuzda bir klasör oluşturun (Buna istediğiniz adı verebilirsiniz). Bu klasörde markdown.md adında bir dosya oluşturun.

   
   

2. VS Code dosyanızın sağ üst kısmına gidin ve sonucunuzun önizlemesini yan yana görmek için önizleme düğmesine tıklayın.

   

Markdown'da Temel Formatlama

Markdown'da metni biçimlendirmek için bazı temel sözdizimlerini burada bulabilirsiniz.

1. Başlıklar : Başlıklar, belgenizdeki farklı Başlık düzeylerini belirtmek için kullanılır. Markdown'da Başlıklar oluşturmak için # sembolünü ve ardından bir boşluk bırakarak Başlık metninizi kullanın. # sembol sayısının Yönünüzün seviyelerini belirlediğini unutmayın. Aşağıdaki örneğe bakın.

    # Heading ## Heading ### Heading 

   

2. Vurgu: Metninizi kalın veya italik yaparak vurgu yapabilirsiniz. Metni kalın yapmak için onu çift yıldız işareti ** veya çift alt çizgi __ içine alın. Metni italik yapmak için, onu tek yıldız işareti * veya tek alt çizgi _ içine alın.

Örnek:

 This is the **Bold Text** This is *italics* 

3. Listeler: Markdown hem sıralı (numaralandırılmış) hem de sırasız (madde işaretli) listeleri destekler. Sıralı bir liste oluşturmak için her öğeye bir sayı ve ardından bir nokta ile başlayın. Sırasız bir liste oluşturmak için yıldız işareti * , artı + veya kısa çizgi - kullanın.

Örnek:

 Ordered List: 1. First item 2. Second item 3. Third item Unordered List: * Item 1 * Item 2 * Item 3 

4. Bağlantılar: Bağlantı metni için köşeli parantezleri [] ve bağlantı URL'si için parantezleri () kullanarak Markdown'da köprüler oluşturabilirsiniz.

Örnek:

 [Visit Odafe's Website](https://www.odafe.vercel.app)

5. Resimler: Resim eklemek, bağlantı oluşturmaya benzer; tek fark ünlem işareti ! köşeli parantezlerin önünde. Köşeli parantez içindeki alternatif metin, erişilebilirlik amacıyla görseli tanımlamak için kullanılır.

Örnek:

 ![Alt text](image-url.jpg)

6. Blok alıntılar : Blok alıntılar alıntı metinlerini görüntülemek için kullanılır. Bunu oluşturmak için satıra > sembolüyle başlamanız ve ardından alıntı yapmak istediğiniz metni yazmanız yeterlidir.

Örnek:

 > This is a quote by Odafe

Çıktı şuna benzer:

Bu Odafe'nin bir sözü.

7. Yatay Kural : Üç alt çizgi _ kullanarak yatay ayırıcılar ekleyebilirsiniz.

Örnek:

 This is a regular text ____ This is more regular text 

Bunlar Markdown'daki temel biçimlendirmenin temel unsurlarıdır. Bu kavramlara hakim olarak, ister basit bir not yazıyor olun ister daha karmaşık bir belge hazırlıyor olun, iyi yapılandırılmış ve görsel olarak çekici içerik oluşturabileceksiniz.

Markdown'da Gelişmiş Formatlama

Markdown ayrıca belgenize daha karmaşık öğeler eklemeniz gerekebileceği durumlarda ek işlevler de sunar. Bu biçimlendirme seçeneklerinden bazıları şunlardır:

1. Kod Blokları ve Satır İçi Kod : Kod bloklarınızı üç geri işaret (```) ve ardından kod bloğunuzun yazıldığı dille başlatarak dosyanıza kolayca kod blokları ekleyebilirsiniz. Satır içi kodlar, kod pasajının sarılmasıyla eklenir. tek geri vuruşlarda.

Örnek:

 This is a HTML element `<div>Hello World</div>` ```javascript function myFunction() { console.log("Hello world!") } 

2. Görev Listeleri: Görev listeleri, yapılacaklar listeleri oluşturmak için kullanışlıdır. Bir görev listesi oluşturmak için, tamamlanmış görevler için "x" içeren köşeli parantezleri, tamamlanmamış görevler için ise boşluk kullanın.

Örnek:

 - [x] A complete task - [ ] An incomplete task 

3. Emojiler : Markdown dosyalarına emoji eklemenin iki yolu vardır: emojiyi kopyalayıp Markdown formatlı metninize yapıştırın veya emoji kısa kodlarını yazın.

4. Üstü Çizili Metin: Metnin üstünü çizmek için, üstünü çizmek istediğiniz metnin etrafında çift yaklaşık işareti ( ~~ ) kullanın.

Örnek:

 This is a ~~Strikethrough~~ text.

5. Kaçış Karakterleri: Markdown'da özel anlamı olan karakterleri görüntülemeniz gerekiyorsa, ters eğik çizgi ( \ ) kullanarak bunlardan kaçabilirsiniz.

 To display a literal asterisk \* use a backslash before it.

6. Üst Simge ve Alt Simge: Üst simge oluşturmak için üst simge metni iki ^ sembolüyle sarılır.

Alt simge metni oluşturmak için metin iki ~ sembolüyle sarılır.

Örnekler:

 This is how a superscript is written: X^2^ This is how a subscript is written: H~2~O. 

7. Tablolar : Markdown'da tablolar oluşturmak için şu adımları izleyin:

• Her satırı bir boru simgesiyle ( | ) başlatın ve bitirin.
• Her sütunu bir boru simgesiyle ( | ) ayırın.
• Sütun başlıkları oluşturmak için üç veya daha fazla kısa çizgi ( --- ) kullanın.

 | Syntax | Description | | ----------- | ----------- | | Header | Title | | Paragraph | Text |

Çıktı:

8. Vurgula : Belgenizdeki Önemli kelimeleri, kelimelerin önünde ve sonrasında iki eşittir işareti ( == ) kullanarak vurgulayabilirsiniz.

Örnek:

 This highlighted word is ==Bee==

Çıktı:

9. Dipnotlar : Dipnotlar, ana metni karmaşıklaştırmadan belgenizin sonuna notlar ve referanslar eklemenin bir yoludur. Dipnot referansı oluşturmak için, köşeli parantezlerin ( [^1] ) içine bir düzeltme işareti simgesi ( ^ ) ve benzersiz bir tanımlayıcı (genellikle sayılar veya sözcükler) ekleyin.

Tanımlayıcılar boşluk veya sekme içeremez. Çıktıda dipnotlar sırayla numaralandırılır.

Örnek:

 This is an example sentence with a footnote[^1]. [^1]: This is the content of the footnote.

Çıktı:

Markdown'da gelişmiş biçimlendirme hakkında daha fazla bilgiyi buradan edinebilirsiniz.

Markdown'da Gerçek Dünya Uygulamaları

Markdown, yazılım geliştiricileri ve programlama topluluğu arasında büyük bir popülerlik kazandı. Bir kod tabanının özünü açıklamak için kapsamlı ve erişilebilir bir araç olarak hizmet ederek sürüm kontrol platformları içerisinde önemli bir rol bulmuştur.

Geliştiriciler, Markdown'ı bir kodun inceliklerini açıklamak için bir kanal olarak kullanarak, netlik ve bağlamın uyumlu bir karışımını yaratırlar.

Bu uygulama, kod deposuna rastlayanlara yardım eli uzatarak projenin genel amacının ve nüanslarının hızlı ve derinlemesine anlaşılmasını kolaylaştırır.

Bu şekilde, Markdown yalnızca bir biçimlendirme aracı olarak değil, aynı zamanda karmaşık kodlama çabaları ile bunların gerçek dünyadaki derin sonuçları arasındaki boşluğu dolduran güçlü bir iletişimci olarak da duruyor.

Çözüm

Unutmayın, Markdown yalnızca bir araç değildir; düşüncelerinizi küresel bir izleyici kitlesine bağlayan, sesinizin net ve etkili bir şekilde duyulmasını sağlayan bir köprüdür.

Çeşitli platformlarla uyumluluğu, basitliği ve uyarlanabilirliği, Markdown ile yolculuğunuzun bu kılavuzla sınırlı kalmamasını, kendinizi ve fikirlerinizi ifade etmenin yeni yollarını keşfettikçe devam etmesini sağlar.

Kaynaklar

• Hile sayfası: https://www.markdownguide.org/cheat-sheet/

• Eğitim: https://www.markdowntutorial.com/

• Eğitim: https://commonmark.org/help/tutorial/

  
  

Burada da yayınlandı