Markdown Doğrulayıcı
Markdown sözdizimini doğrulayın ve çevrimiçi hataları tespit edin. Başlık boşluğu, kapatılmamış kod blokları, liste biçimlendirmesi ve CommonMark uyumluluğunu kontrol edin.
Markdown Girişi
Doğrulama Raporu
Markdown Doğrulayıcı Nedir?
Markdown doğrulayıcı, Markdown dosyalarının sözdizimi spesifikasyonlarına uygun olup olmadığını ve hatasız oluşturulup oluşturulmadığını kontrol eden bir araçtır. Stil tercihlerini uygulayan bir linter'ın aksine, doğrulayıcı doğruluğa odaklanır — Markdown'ınızın her platformda yapısal olarak sağlam ve doğru görüntülendiğinden emin olur. Kapatılmamış kod blokları, hatalı biçimlendirilmiş bağlantılar, geçersiz başlık seviyeleri ve tablo hizalama sorunları gibi problemleri tespit eder.
CommonMark spesifikasyonu, tüm Markdown doğrulayıcıları tarafından kullanılan referans standardı sağlar. CommonMark, orijinal formattaki belirsizlikleri ortadan kaldıran iyi belgelenmiş ve düzenlenmiş bir Markdown sürümüdür. Bu tarayıcı tabanlı doğrulayıcı, içeriğinizi CommonMark kurallarına göre anında kontrol ederek GitHub, GitLab veya statik site oluşturucuları gibi platformlarda yayınlamadan önce sorunları tespit eder.
Markdown'ı doğruladığınızda, esasen şunu sorarsınız: "Bu her yerde doğru oluşturulacak mı?" Bir doğrulayıcı, önizleme anına kadar görünmeyen ince sorunları tespit eder — kapatılmamış kod blokları, bağlantı sözdizimi hataları, bozuk tablo yapıları ve yüklenmeyen görsel yolları.
Markdown Doğrulayıcı Nasıl Kullanılır
Markdown'ınızı doğrulamak için bu adımları izleyin. Her adım bu sayfadaki gerçek düğmeleri ve panelleri kullanır.
Yapıştır, Yükle veya Örnek Yükle
Markdown'ı sol paneldeki Markdown Girişi alanına yapıştırın veya bir .md dosyası yüklemek için Yükle'ye tıklayın. Kasıtlı doğrulama sorunları içeren örnek API belgelerini görmek için Örnek'e tıklayın. CommonMark'a göre kontrol eder.
Doğrulama Raporunu Görüntüle
Sağ Doğrulama Raporu paneli, satır numaralarıyla birlikte hataları ve uyarıları listeler. Kapatılmamış kod bloklarını, hatalı biçimlendirilmiş bağlantıları, geçersiz başlıkları ve tabloları tespit eder.
Raporu Kopyala veya İndir
Kopyala veya İndir'e tıklayarak raporu kullanın. Yeniden başlamak için Temizle'yi kullanın. Tüm işlemler tarayıcınızda gerçekleşir.
Gerçekten Ne Zaman Kullanırsınız
Yayın Öncesi Kontrol
İçeriği GitHub, GitLab, Notion veya statik site oluşturucusunda yayınlamadan önce, oluşturma hatalarını tespit etmek için doğrulama çalıştırın. Bozuk kod bloklarını veya hatalı biçimlendirilmiş tabloları yayın öncesinde tespit etmek, üretim belgelerindeki utanç verici hataları önler.
API Belge Kalitesi
API belgelerinde, OpenAPI spesifikasyonlarında ve SDK belgelerinde kullanılan Markdown'ı doğrulayın. Kod örneklerinin bloklarda doğru oluşturulduğundan ve parametre tablolarının yapısal olarak sağlam olduğundan emin olun. Swagger gibi araçlar geçerli Markdown'a bağımlıdır.
Blog ve İçerik Geçişi
Blog içeriğini HTML veya diğer formatlardan Markdown'a taşırken, dönüştürülen Markdown'ın yapısal olarak doğru olduğunu doğrulayın. Kaçış karakterleri, bozuk bağlantılar ve hatalı biçimlendirilmiş tablolar gibi dönüşüm artefaktlarını tespit edin.
Erişilebilirlik ve Anlamsal Uyumluluk
Markdown'ınızın uygun başlık seviyeleri ve görüntülerde alt metin ile anlamsal yapıyı takip ettiğinden emin olun. Geçerli bir Markdown yapısı, ekran okuyucular için kritik öneme sahiptir ve HTML'e dönüştürüldüğünde daha erişilebilir bir çıktı üretir.
Sık Sorulan Sorular (SSS)
Bu doğrulayıcı hangi Markdown diyalektini destekliyor?
Bu doğrulayıcı, en taşınabilir ve standartlaştırılmış Markdown formatı olan CommonMark spesifikasyonunu katı şekilde takip eder. GitHub Flavored Markdown (GFM), CommonMark'ı tablolar, üzeri çizili metin ve görev listeleriyle genişletir.
Doğrulama hataları ile uyarılar arasındaki fark nedir?
Hatalar, doğru oluşturmayı engelleyen yapısal sorunlardır — kapatılmamış kod blokları, bozuk bağlantı sözdizimi, geçersiz başlık sıraları. Uyarılar, oluşturmayı bozmayabilecek ancak kötü uygulamalara veya olası erişilebilirlik sorunlarına işaret eden problemleri bildirir.
Markdown'ı özellikle GitHub için doğrulayabilir miyim?
Bu araç CommonMark uyumluluğunu doğrular. GitHub, GitHub Flavored Markdown kullanır ve bu CommonMark'ı tablolar, görev listeleri ve üzeri çizili metinle genişletir. Bu doğrulayıcıyı geçen içerik GitHub'da çalışacaktır.
Doğrulayıcı yazım veya dilbilgisi kontrolü yapar mı?
Hayır, doğrulayıcı yalnızca Markdown sözdizimi ve yapısına odaklanır. Yazım ve dilbilgisi denetimi için Grammarly veya IDE uzantıları gibi ayrı araçlar kullanın.
Doğrulama verileri bir sunucuya gönderilir mi?
Hayır. Tüm doğrulama JavaScript kullanılarak tamamen tarayıcınızda gerçekleştirilir. Markdown içeriğiniz hiçbir yere iletilmez, bu da onu tescilli veya gizli belgeler için güvenli kılar.