Markdown editörü nasıl kullanılır
- Markdown'ı soldaki editöre yazın veya yapıştırın.
- Yazdıkça GitHub-flavoured Markdown (GFM) ile işlenen canlı önizlemenin güncellenmesini izleyin.
- Bir web sitesi, İçerik Yönetim Sistemi (CMS) veya e-posta için oluşturulan HTML'i kopyalamak üzere HTML'i kopyala düğmesine tıklayın.
- Ya da Markdown'ın kendisini bir README, issue, pull request veya dokümantasyon sayfası için kopyalayın.
İşleme tarayıcınızda yapılır ve metniniz yüklenmez veya saklanmaz. İşlenen HTML temizlenir; böylece yapıştırılan içerikteki betikler ve tehlikeli öznitelikler önizleme gösterilmeden önce çıkarılır.
Markdown nedir?
Markdown, John Gruber tarafından 2004'te oluşturulmuş hafif bir işaretleme dilidir. Biçimlendirme için düz metin noktalama işaretlerini kullanır: başlıklar için #, vurgu için * veya _, listeler için -. Kaynak düz metin olarak okunabilir kalır ve bir işleyici onu HTML'e dönüştürür.
Özgün tanım birçok sınır durumunu belirsiz bıraktığı için uygulamalar birbiriyle uyuşmuyordu. CommonMark bu belirsizlikleri çözen ayrıntılı bir belirtimdir; GitHub-flavoured Markdown ise CommonMark'ın, geliştiricilerin her gün kullandığı özellikler ekleyen bir üst kümesidir:
| GFM özelliği | Söz dizimi |
|---|---|
| Tablolar | | Name | Value |, bir |---|---| ayırıcı satırıyla |
| Görev listeleri | - [ ] todo ve - [x] done |
| Üstü çizili metin | ~~removed~~ |
| Otomatik bağlantılar | https://example.com gibi çıplak URL'ler bağlantıya dönüşür |
| Çitli kod blokları | Üç ters tırnak, isteğe bağlı olarak ardından bir dil adı |
Markdown hızlı başvuru
# Heading 1
## Heading 2
**bold**, *italic*, `inline code`
- Bullet item
- Nested item (indent two spaces)
1. Numbered item
[Link text](https://example.com)
> A blockquote
```python
print("fenced code with a language")
```Yaygın Markdown sorunları ve çözümleri
Başlık işlenmiyor. CommonMark, diyez işaretlerinden sonra bir boşluk ister. #Title düz metindir; # Title bir başlıktır.
Satırlar tek bir paragrafta birleşiyor. Bir paragraf içindeki tek bir satır sonu boşluk olarak işlenir. Yeni bir paragraf başlatmak için boş bir satır bırakın ya da zorunlu satır sonu için bir satırı iki boşluk veya bir ters eğik çizgiyle bitirin. (GitHub yorumları tek satır sonlarını README dosyalarından farklı ele alır; bu, kafa karışıklığının yaygın bir kaynağıdır.)
Liste veya kod bloğu erken bitiyor. Bir liste öğesine ait içerik, öğenin metniyle hizalanacak şekilde girintilenmelidir. Bir listenin içindeki kod için çitli bloğun tamamını girintileyin:
1. Install the package:
```bash
npm install example
```
2. Run it.Tablo işlenmiyor. Bir GFM tablosu için bir başlık satırı, sütun başına en az üç tire içeren bir ayırıcı satır ve genellikle öncesinde boş bir satır gerekir. Sütunları hizalamak için ayırıcıda iki nokta üst üste kullanın (:---, :---:, ---:).
İstenmeyen biçimlendirme. *, _ ve # gibi karakterler biçimlendirmeyi tetikleyebilir. Önlerine ters eğik çizgi koyarak bunları etkisizleştirin, örneğin \*not italic\*, ya da ters tırnak içine alın.
İpuçları ve en iyi uygulamalar
- Kod bloklarının, desteklenen yerlerde söz dizimi vurgulaması alması için açılış ters tırnaklarından sonra her zaman bir dil ekleyin.
- Görseller için anlamlı alt metin yazın; ekran okuyucular tarafından kullanılır ve görsel yüklenemediğinde gösterilir.
- Uzun belgelerde satır başına bir cümle kullanın; Markdown bunları paragraflara birleştirir ve diff'ler çok daha temiz olur.
- Belgelerinizdeki kod blokları geçerli ve düzenli olsun diye JSON veya YAML örneklerini önce JSON Biçimlendirici ve Doğrulayıcı veya YAML Biçimlendirici ve Doğrulayıcı aracına yapıştırın.
- Oluşturulan HTML'i bir web sayfasına yapıştırıyorsanız düzgünce girintilemek için HTML Biçimlendirici'den geçirin.
Sık sorulan sorular
Markdown ile GitHub-flavoured Markdown arasındaki fark nedir?
GFM, GitHub'ın tanımladığı CommonMark Markdown'ın bir üst kümesidir. Tablolar, görev listeleri, üstü çizili metin, genişletilmiş otomatik bağlantılar ve ham HTML üzerinde bazı kısıtlamalar ekler. GitHub için yazılmış çoğu README burada da aynı şekilde işlenir.
Markdown içinde HTML kullanabilir miyim?
Evet, Markdown satır içi HTML'e izin verir. Güvenlik için önizleme çıktıyı temizler; bu yüzden <script> gibi etiketler, onclick gibi olay işleyici öznitelikleri ve javascript: bağlantıları kaldırılır.
Markdown'ım başka bir sitede neden farklı görünüyor?
Platformlar farklı Markdown türleri ve kendi stil sayfalarını kullanır. Temel söz dizimi (başlıklar, vurgu, listeler, bağlantılar, kod) tutarlıdır, ancak tablolar, satır sonları ve dipnot veya matematik gibi uzantılar işleyiciler arasında değişir.
Markdown'ı HTML'e nasıl dönüştürürüm?
Markdown'ınızı yazın veya yapıştırın, önizlemeyi kontrol edin, ardından HTML'i kopyala düğmesine tıklayın. Çıktı, stil içermeyen sade ve anlamsal HTML'dir (başlıklar, paragraflar, listeler, tablolar); bu yüzden yapıştırdığınız sayfanın CSS'ini alır.
Güncellendi