Markdown Düzeltme Aracı
Bozuk Markdown’u otomatik olarak onarın
Markdown Düzeltme Aracı Nedir?
Üstünde boş satır olmayan başlık. Asla kapatılmamış kod bloğu. Yarısında 1’e dönen numaralı liste. Bu hafta bir README yazdıysanız, en az biriyle karşılaşmışsınızdır. Bu araç belgenizi tarar, yapısal sorunları bulur ve renderer’ın çıktınızı sessizce bozmaması için yeniden yazar. Bozuk Markdown’u sola yapıştırın, sağda temizlenmiş bir sürümünü alın — kelimelere dokunulmaz, yalnızca etrafındaki yapı onarılır.
Araç temel dilbilgisi için CommonMark spesifikasyonunu takip eder ve GitHub Flavored Markdown uzantılarını korur — tablolar, görev listeleri ve üstü çizili öğeler bozulmadan kalır. Uyguladığı kurallar markdownlint’inkilere oldukça benzerdir.
Her şey tarayıcınızda çalışır — metniniz cihazınızdan hiç çıkmaz. Markdown’unuzu saniyeler içinde düzeltin ve kaldığınız yerden devam edin.
Markdown Düzeltme Aracı Nasıl Kullanılır
Üç adım. Her biri bu sayfadaki gerçek düğmeleri kullanır.
Bozuk Markdown yapıştırın veya örnek yükleyin
Markdown’unuzu sol editöre yapıştırın. Sık görülen kırılmaları içeren bir örneği yüklemek için Örnek Markdown’a tıklayın — H2 öncesi eksik boş satır, kapatılmamış ```js fence, yeniden başlayan numaralı liste.
# Order Processing
```python
def process(order):
| Stage | Owner |
|-------|-------
[doc][missing-refAraç boş satır aralıklarını ayarlar, açık kod bloklarını kapatır, liste girintilerini normalleştirir ve vurgu işaretlerini CommonMark’a göre dengeler.
"Markdown’u Düzelt!!" düğmesine tıklayın
Araç çubuğundaki yeşil Markdown’u Düzelt!! düğmesine tıklayın. Araç belgeyi analiz eder ve yapısal sorunları yeniden yazar. İşlem sırasında bir yükleme göstergesi belirir.
Düzeltilmiş çıktıyı inceleyin
Sağ panel temiz Markdown’u gösterir. Metniniz, başlıklarınız, kod örnekleriniz aynı kalır. Yalnızca aralık, fence ve girinti yeniden yazılır.
Bu aracı gerçekten ne zaman kullanırsınız
README Temizleme
Commit’ten önce proje README’sini düzeltici aracından geçirin. GitHub Markdown’u titizce render eder; tek bir kapatılmamış fence dosyanızın yarısını yutabilir.
Yapıştırılan İçeriği Temizleme
Notion, Confluence veya bir sohbetten Markdown dosyasına kopyalamak genellikle bozuk madde işaretleri ve garip boşluklar bırakır. Düzeltici bunları temiz CommonMark’a indirger.
Statik Site Üreticileri
Hugo, Jekyll, Astro, MkDocs — hepsi aynı yapısal hatalarda tıkanır. Kaynağı bir kez düzeltirseniz build pipeline’ı şikayet etmeyi bırakır.
Yapay Zeka Üretimi Markdown’u Temizleme
LLM’ler kapatma ```’yu unutmayı veya H2’den H4’e atlamayı sever. Düzeltici başlık hiyerarşisini normalleştirir ve fence’ları yeniden dengeler.
Sık Sorulan Sorular
Markdown’um saklanıyor mu?
Hayır. Düzeltici tamamen tarayıcınızda çalışır — sunucuya gidiş geliş yoktur. Metniniz sekmeden ayrılmaz.
Hangi sorunları gerçekten onarır?
Başlıklar ve listeler etrafındaki boş satırlar, kapatılmamış kod blokları, tek bir listede karışık madde işaretleri, kırılmış numaralandırma, dengesiz vurgu, tanımsız etiketlere işaret eden referans bağlantıları ve pipe sayısı tutmayan tablo satırları.
Kelimelerimi değiştirir mi?
Hayır. Düzeltici yalnızca yapısal boşluklara, fence işaretlerine, liste madde işaretlerine ve bağlantı sözdizimine dokunur. Paragrafların, başlıkların ve kod bloklarının metin içeriği aynen korunur.
CommonMark mı GitHub Flavored Markdown mı?
İkisi de. Temel dilbilgisi CommonMark’ı takip eder; GFM uzantıları (tablolar, görev listeleri, otomatik bağlantılar, üstü çizili) bozulmadan korunur.
Büyük Markdown dosyaları için kullanabilir miyim?
64 KB’a kadar — bu çoğu README ve blog yazısını kapsar. 200 sayfalık bir el kitabı varsa bölümlere ayırın.
Düzeltilen Markdown her zaman geçerli midir?
Yaygın kırılmalar için evet. Sıra dışı durumlarda Markdown Doğrulayıcı ile doğrulayın.
İhtiyaç duyabileceğiniz diğer Markdown araçları
Düzeltmek iş akışının yalnızca bir parçası. İşte sırada gelen araçlar: