DOCX'i Markdown'a çevir

Bir Word dosyasının yapılı düz metne dönüşmesi gerektiğinde

Dokümantasyon çoğu zaman Word'de doğar: bir ürün yöneticisinin yazdığı bir şartname, hukuk ekibinin hazırladığı bir politika, bir müşterinin teslim ettiği bir kılavuz. Ancak varış noktası sıklıkla bir Git deposu, bir statik site üreticisi, bir wiki, bir bilgi bankası veya bir not alma uygulamasıdır ve bunların hepsi Markdown konuşur. Kopyalayıp yapıştırmak başlıkları ve listeleri kaybettirir; 20 sayfalık bir belgeyi elle yeniden yazmak ise saatler alır.

Markdown aynı zamanda iyi bir arşiv ve inceleme formatıdır. Sürüm kontrolünde temiz bir diff verir; böylece bir sözleşmeyi veya gereksinim belgesini dönüştürdükten sonra sonraki her değişikliği satır satır takip edebilirsiniz. İkili bir .docx dosyası buna izin vermez.

Dönüştürme nasıl çalışır

Bir .docx dosyası, XML dosyalarından oluşan bir ZIP arşividir. Dönüştürücü onu tarayıcınızda açar, belge gövdesini okur ve Word'ün yapısını önce HTML'ye eşler, ardından bu HTML'yi Markdown'a çevirir. Bu iki adım, sitedeki HTML'yi Markdown'a dönüştür aracıyla aynı Markdown kurallarını kullanır, bu yüzden iki aracın çıktısı tutarlı görünür.

Neler aktarılır ve nasıl yazılır:

• Başlıklar, 1'den 6'ya kadar her Word başlık seviyesi için bir seviye olmak üzere # ile ###### arasına dönüşür.
• Kalın **metin**, italik ise _metin_ olur.
• Madde işaretli ve numaralı listeler, beş seviyeye kadar iç içe yapı korunarak - ve 1. listelerine dönüşür.
• Köprüler, harici sitelere bağlantılar dahil [metin](url) olur.
• Tablolar, ilk satır başlık olarak kullanılarak dikey çizgili (pipe) tablolara dönüşür.
• Dipnotlar ve son notlar belgenin sonunda numaralı bir listede toplanır ve metindeki her atıf kendi notuna giden bir bağlantıya dönüşür.

Çıktı, bloklar arasında hiçbir zaman birden fazla boş satır kalmayacak şekilde temizlenir.

Başlıklar neden bazen düz metin olarak çıkar

Dönüştürücü bir başlığı nasıl göründüğüne göre değil, paragraf stiline göre tanır. Yerleşik Başlık 1 ile Başlık 6 stilleriyle biçimlendirilmiş bir satır Markdown başlığına dönüşür. Yazarın elle büyüttüğü ve kalınlaştırdığı bir satır ise dosya açısından kalın metin içeren sıradan bir paragraftır ve ## Introduction yerine **Introduction** olarak çıkar.

Aynı durum belge başlığı için de geçerlidir. Word'ün Konu Başlığı stili bir başlık stili değildir, bu yüzden bununla ayarlanmış bir başlık normal bir paragrafa dönüşür. Yapı önemliyse dönüştürmeden önce Word'de düzeltin: satırı seçin ve Stiller galerisinden Başlık 1 veya Başlık 2'yi uygulayın. Belgeyi kontrol etmenin hızlı bir yolu, yalnızca gerçek başlıkları listeleyen Word'deki Gezinti Bölmesi'dir. Orada eksik olan her şey Markdown ana hattında da eksik olacaktır.

Neler dışarıda kalır

Markdown bilinçli olarak basittir, bu yüzden Word düzeninin büyük kısmının karşılığı yoktur:

• Görseller dahil edilmez ve bir uyarı kaç tanesinin atlandığını söyler. Onları base64 metin olarak gömmek dosyayı metnin kendisinden kat kat büyük yapardı.
• Altı çizili, yazı tipi, boyut ve renk atılır. Markdown'da bunlar için sözdizimi yoktur.
• Üstü çizili metin korunur, ancak çizgi işaretleri olmadan.
• Üst bilgiler, alt bilgiler, sayfa numaraları ve bölüm sonları içeriğe değil sayfa düzenine aittir ve dönüştürülmez.
• Metin kutuları ve şekiller, ana metin akışının dışında yüzdükleri için kaybolabilir veya yanlış yerde görünebilir.
• Tablo hücresi biçimlendirmesi düz metne indirgenir. Bir hücre içindeki kalın yazı, bağlantılar veya listeler biçimlerini kaybeder ve çok paragraflı bir hücrenin paragrafları, bazen aralarında boşluk olmadan, tek bir satırda birleştirilir.

Pratik bir temizlik rutini

Markdown genellikle yüzde 90 hazırdır. Kısa bir gözden geçirme gerisini düzeltir:

1. Başlıkları tarayın. Siteniz bekliyorsa tek bir üst düzey # başlığı olduğundan ve seviyelerin #'ten doğrudan ###'e atlamadığından emin olun.
2. Bir paragraf veya görselle bölünmüş numaralı listeleri kontrol edin. Markdown numaralandırmayı 1'den yeniden başlatabilir.
3. Farklı sayıda sütuna sahip satırlar olarak gelen birleştirilmiş hücreli tablolara bakın ve bunları elle eşitleyin.
4. Görselleri Word'den dışa aktararak, dosyaları .md dosyasının yanına koyarak ve ait oldukları yere ![açıklama](image.png) ekleyerek yeniden ekleyin.
5. Yayımlamadan önce sonucu Markdown'ı HTML'ye dönüştür ile önizleyin.

50 MB'a kadar dosyalar kabul edilir; eski ikili .doc formatı kabul edilmez. Belge yalnızca tarayıcı sekmenizde okunur, bu yüzden gizli taslaklar hiçbir zaman bir sunucuya ulaşmaz.