HTML Kodunu Markdown Metnine Dönüştürme

Dönüştürmeye başlamadan önce

HTML kodunu Markdown metnine çevirmek, etiketlerle yazılmış bir içeriği Markdown kullanan bir taslağa taşırken pratik bir başlangıç sağlar. Dönüştürücü, sağlanan HTML üzerinde yerleşik metin dönüşümleri uygular; başlık, bağlantı, görsel, biçimlendirme, kod, liste ve bazı blok yapılarını tanınan biçimlerine göre ele alır. Bu işlem, HTML içeriğini Markdown tarzı bir metne yaklaştırır; HTML içindeki her olası yazım biçimi için eksiksiz bir karşılık vaat etmez.

Özellikle düzenli ve kısa HTML parçalarında elde edilen metni hızlıca inceleyebilirsiniz. İçeriğinizde farklı öznitelikler, karmaşık iç içe elemanlar veya dönüştürücünün tanımadığı yapılar varsa sonucu düzenleme taslağı olarak değerlendirin. Böylece çevrilmiş bölümleri kullanıp eşleşmeyen kısımları gerektiğinde elle düzeltebilirsiniz.

HTML kodunu dönüştürme adımları

Dönüştürmek istediğiniz HTML kodunu metin girişine yapıştırın. Giriş alanı isteğe bağlıdır; hiçbir metin sağlamazsanız işlem başarılı biçimde tamamlanır ve dönüştürülmüş sonuç boş olur.
Dönüştürmeyi başlatan kontrolü seçin. Birinci ile altıncı düzey arasındaki başlıklar Markdown başlık ön ekleri alır. Tek veya çift tırnakla yazılmış href özniteliğini taşıyan bağlantılar Markdown bağlantı biçimine çevrilebilir. Çift tırnaklı src özniteliği bulunan görseller de eşleşen yapıda işlenir; src sonrasında yer alan alternatif metin kullanılabilir, bu konumda metin yoksa alternatif alanı boş kalabilir.
Biçimlendirilmiş bölümleri sonuçta karşılaştırın. Öznitelik taşımayan strong, b, em ve i elemanları vurgu işaretlerine dönüşebilir. Uygun yalın pre ve code dizilimi çitli kod bloğu oluşturabilir; eşleşen yalın code elemanları satır içi kod olarak yazılabilir. Öznitelik veya yapı farkları bu dönüşümlerin gerçekleşmesini engelleyebilir.
Liste ve blok düzenini inceleyin. Bazı liste öğeleri, sırasız ve sıralı liste kapsayıcıları, alıntılar, paragraflar, satır sonları, yatay çizgiler ve yaygın blok kapsayıcıları Markdown tarzı metin veya boşluk düzeni alır. İç içe geçme biçimi ya da etiket sırası desteklenen kalıptan ayrılıyorsa bu bölümü baştan düzenlemek gerekebilir.
Son metni gözden geçirin ve kullanacağınız yere göre düzeltin. Betik ve stil blokları, açılış ve kapanış kalıpları büyük-küçük harf farkı gözetmeden eşleştiğinde kaldırılır; kapanışsız ya da başka biçimdeki blokların kaldırılması garanti edilmez. Desteklenen işlemlerden sonra eşleşen kalan etiket sözdizimi silinebilir, fakat bu etiketlerin arasındaki etiket dışı metin korunur.
Sonucun dış boşluklarını ve karakter başvurularını kontrol edin. Dört veya daha fazla ardışık satır sonu üç satır sonuna indirgenir; baştaki ve sondaki boşluklar kırpılır. Seçili adlandırılmış varlıklar ile &#digits; biçimindeki ondalık başvurular çözülebilir. Rakam içermeyen veya bozuk biçimler değişmeden kalabilir; yalnızca rakamlardan oluşan, fakat geçerli karakter aralığının dışındaki değer hata oluşturabilir.

Oluşan Markdown metnini okuma

Sonuç, kaynak HTML’nin desteklenen kalıplarının Markdown tarzı karşılığını verir. Başlıkların başında seviye sayısına uygun Markdown işaretleri, bağlantılarda metni ve hedefi ayıran işaretler, uygun kod yapılarında ise çitli veya satır içi kod görünümü beklenebilir. Boş giriş kullanıldığında karşılaştırılacak içerik oluşmaz; sonuç boş metindir.

Bir bölüm beklediğiniz gibi görünmüyorsa önce etiketlerin özniteliklerini, sırasını ve iç içe yapısını inceleyin. Dönüştürülmeyen bir yapı için kalan etiket sözdizimi eşleşen durumlarda kaldırılabilirken, etiketler arasındaki düz metin korunabilir. Bu nedenle yalnızca biçim işaretlerinin oluşup oluşmadığına değil, içerik sırasının ve anlamlı metnin korunup korunmadığına da bakın.

Karakter başvurularında sonuç biçimden etkilenir. Tanınan adlandırılmış başvurular çözülebilir, uygun ondalık gösterimler karaktere çevrilebilir ve hatalı gösterimler olduğu gibi bırakılabilir. Geçerli aralığın dışındaki rakam dizileri işlem sırasında hata doğurabileceğinden, dış kaynaktan alınan HTML’yi yayımlamadan önce baştan sona okuyarak doğrulayın.

Uygulamalı örnek

Bir içerik yazarı, başlık, bağlantı ve kısa kod örneğini Markdown taslağına taşımak amacıyla bu HTML parçasını dönüştürür.

Birinci düzey başlık, çift tırnaklı bir href bağlantısı ve yalın pre ile code yapısından oluşan kısa HTML parçasını girişe yapıştırıp dönüştürme kontrolünü seçin.

Çıktıda birinci düzey başlık için Markdown başlık ön eki, bağlantı için Markdown bağlantı biçimi ve yalın kod yapısı için çitli kod bloğu görülür; eşleşmeyen bölüm ise korunmuş düz metin veya kaldırılmış etiket sözdizimi şeklinde kalabilir.

Sınırlamalar

Dönüşüm, belirli kalıp ve karakter başvurusu biçimleriyle sınırlıdır; farklı HTML yapıları işlenmeden kalabilir, bazı bozuk başvurular korunabilir ve geçerli aralık dışındaki rakam dizileri hata oluşturabilir.

Sık yapılan hatalar

Bağlantı, vurgu, kod veya liste beklediğiniz biçime geçmiyorsa ilgili HTML parçasındaki öznitelik, etiket sırası ya da iç içe yapı desteklenen kalıpla uyuşmuyor olabilir; parçayı daha yalın bir yapıya getirip yeniden dönüştürün.

Sık sorulan sorular

Her HTML yapısı Markdown metnine çevrilir mi?

Hayır, dönüşüm yalnızca tanınan etiket ve yapı kalıplarıyla sınırlıdır. Öznitelik biçimi, etiket sırası veya iç içe düzen farklı olduğunda ilgili bölüm işlenmeyebilir.

HTML alanı boş bırakılırsa ne olur?

Giriş sağlanmadığında veya alan boş bırakıldığında işlem başarılı tamamlanır ve dönüştürülmüş metin boş döner.

Karakter varlıkları dönüştürme sonucunda nasıl işlenir?

Seçili adlandırılmış varlıklar ve rakamlardan oluşan uygun ondalık başvurular çözülebilir. Bozuk gösterimler değişmeden kalabilir; geçerli aralık dışındaki yalnızca rakamlı değerler hata oluşturabilir.