Sözdizimini Dene

Sözdizimi Referansı

Markdown Sözdizimi Nedir?

Markdown, John Gruber tarafından 2004 yılında oluşturulan hafif bir metin biçimlendirme dilidir. Ham halde dağınık görünmeden HTML'ye dönüştürülen içerik yazmayı kolaylaştırmak için metni biçimlendirmek amacıyla basit semboller ve karakterler kullanır. Markdown, belgeler, README dosyaları, bloglar ve basit, okunabilir biçimlendirme gerektiren içerikler için standart haline gelmiştir.

CommonMark, ayrıştırıcıların sözdizimini nasıl yorumlaması gerektiğini tanımlayan en yaygın kabul gören Markdown spesifikasyonudur. CommonMark uyumlu sözdizimini öğrenerek içeriğiniz GitHub, GitLab, Discord, Slack, Reddit, Stack Overflow ve düzinelerce diğer platformda tutarlı şekilde render edilecektir. John Gruber'ın orijinal Markdown spesifikasyonu temel olmaya devam ederken, GitHub Flavored Markdown gibi uzantılar görev listeleri, üstü çizili metin ve tablolar gibi özellikler ekler.

Modern Markdown, belirli platformlara göre uyarlanmış birden fazla çeşitte mevcuttur. GitHub Flavored Markdown (GFM) tablolar, onay kutuları ve otomatik bağlantılar ekler. GitLab Markdown benzer uzantıları ve diyagramları destekler. CommonMark temel sözdizimini öğrenmek, her yerde çalışan taşınabilir bir temel sağlar.

Markdown Sözdizimi Rehberi Nasıl Kullanılır

Markdown sözdizimini öğrenmek ve denemek için bu adımları izleyin.

Yapıştırın, Yükleyin veya Örnek Yükleyin

Markdown'ı sol Sözdizimini Dene paneline yapıştırın veya bir .md dosyası yüklemek için Yükle'ye tıklayın. Örnek belge görmek için Örnek'e tıklayın. Sağ Sözdizimi Referansı paneli CommonMark ve GFM kalıplarını gösterir.

Alıştırma yapın ve başvurun

Başlıklar, vurgu, listeler, bağlantılar, tablolar, kod blokları için referansı kullanın. Denemek için örnekleri sol panele kopyalayın. CommonMark ile GitHub Flavored Markdown uzantılarını kapsar.

Kopyalayın veya indirin

Referansı kaydetmek için Kopyala veya İndir'e tıklayın. Yeniden başlamak için Temizle'yi kullanın. Tüm işlem tarayıcınızda gerçekleşir.

Bunu Gerçekten Ne Zaman Kullanırsınız

Belge Yazma

Teknik belgeler, API referans kılavuzları ve yazılım belgeleri neredeyse evrensel olarak Markdown'da yazılır. Python Docs, Node.js kılavuzları ve çoğu açık kaynak projesi belgeleri için Markdown kullanır. Sözdizimi referansı, karmaşık belgeler yazarken üretken kalmanıza yardımcı olur.

README'ler ve Proje Dosyaları

Her GitHub projesinin projeyi, kullanımı, kurulumu ve katkı yönergelerini açıklayan bir README.md dosyası vardır. Bu dosyalar tamamen Markdown'da yazılır ve genellikle kullanıcıların ilk gördüğü şeydir.

İçerik Oluşturma ve Yayımlama

Jekyll, Hugo ve Ghost gibi blog platformları içerik için Markdown kabul eder. Medium benzeri platformlar ve statik site oluşturucular Markdown'ı birincil giriş formatı olarak kullanır. Sözdizimini bilmek daha hızlı yazmanıza ve tutarlı biçimlendirme korumanıza yardımcı olur.

İşbirliği İletişimi

Slack, Discord, GitHub issue'ları, pull request yorumları ve forum gönderileri Markdown biçimlendirmesini destekler. Kod incelemeleri, hata raporları veya takımlarda sohbet ederken Markdown, konuşma akışını kesmeden mesajınızı açıkça biçimlendirmenizi sağlar.

Sıkça Sorulan Sorular (SSS)

Markdown içinde HTML kullanabilir miyim?

Evet, Markdown ham HTML'yi karıştırmaya izin verir. Markdown'ın ihtiyacınız olanı desteklemediği durumlarda HTML'yi doğrudan yazabilirsiniz ve çıktıya aktarılır. CommonMark spesifikasyonuna göre HTML blokları ve inline HTML tanınır ve değiştirilmeden aktarılır. Dikkatli kullanın.

Vurgu için yıldız işaretleri ve alt çizgiler arasındaki fark nedir?

CommonMark'ta işlevsel olarak aynıdırlar — *metin* ve _metin_ her ikisi de italik, **metin** ve __metin__ her ikisi de kalın üretir. Seçim stilistiktir. Birçok takım tutarlılık ve çoğu klavyede yazımının daha kolay olması nedeniyle yıldız işaretlerini tercih eder.

Markdown'da satır sonları nasıl çalışır?

Bu yaygın bir karışıklık kaynağıdır. Kaynakta tek bir satır sonu boşluk olarak işlenir. Gerçek bir satır sonu (<br> HTML'de) oluşturmak için Enter'a basmadan önce satır sonuna iki boşluk ekleyin veya satır sonundan önce ters eğik çizgi kullanın. Paragraf sonları için boş bir satır kullanın.

Tablolar Markdown'da her yerde destekleniyor mu?

Hayır. Tablolar GitHub Flavored Markdown'ın ve diğer uzantıların parçasıdır, ancak CommonMark standardında değildir. Çoğu modern platform (GitHub, GitLab, Discord) onları destekler, ancak bazı eski Markdown ayrıştırıcıları pipe sözdizimini tanımaz.

Özel karakterler nasıl escape edilir?

Markdown'da özel anlamı olan karakterlerin önüne ters eğik çizgi (\) koyun: ters eğik çizgi (\), backtick (`), yıldız (*), alt çizgi (_), süslü parantezler ({}), köşeli parantezler ([]), yuvarlak parantezler (()), diyez (#), artı (+), eksi (-), nokta (.) ve ünlem işareti (!). Örneğin, \*italik değil\* yıldız işaretlerini aynen render eder.

Markdown'da kodu biçimlendirmenin en iyi yolu nedir?

Inline kod için tek backtick kullanın: `kod burada`. Kod blokları için sözdizimi vurgulama için isteğe bağlı dil etiketi (```javascript) ile üç backtick kullanın. Kodu girinti olarak kod bloğu oluşturmaktan kaçının — çitli bloklar daha açık ve taşınabilirdir.

Markdown Sözdizimi Rehberi