DOCX'i Markdown'a Dönüştürme
Dokümantasyonu Word'den çıkarıp bir Git deposuna taşımak, her .docx dosyasını Markdown'a çevirmekle başlar. Bu dönüştürücü # başlıklar, dikey çizgili tablolar ve resim bağlantıları içeren, CommonMark tarzında ve commit etmeye hazır metin üretir.
Belge Dönüştürücü
veya PDF, DOC, DOCX … dosyaları buraya bırakın ·
Dosya başına en fazla 95 MB· En fazla 20 dosya· 30 dakika sonra silinir
Dosyalar sunucularımızda işlenir ve 30 dakika sonra silinir.
150 DPI, bir A4 sayfasını yaklaşık 1240 × 1754 px yapar. Yazdırma için 300 kullanın.
Dosyanın tamamını ya da yalnızca bazı sayfaları veya slaytları dönüştürün (PDF ve sunum girdisi).
Dönüştürülecek sayfalar veya slaytlar, örn. 1-3, 5, 8-10.
UTF-8 her dilde çalışır. Windows'ta Excel veya Not Defteri bozuk karakterler gösteriyorsa BOM'lu UTF-8'i seçin; eski kodlamalar yalnızca eski yazılımlar içindir.
macOS, Linux ve kod düzenleyiciler için LF; klasik Not Defteri gibi eski Windows programları için CRLF.
Standart olan virgüldür. Ondalıkları virgülle yazan ülkelerde (Almanya, Fransa, Brezilya) Excel için noktalı virgül kullanın.
Birden çok sayfalı Excel girdisi: hepsini dönüştürün (sayfa başına bir bölüm veya dosya) ya da yalnızca ilkini.
Bu aracı nasıl kullanırsınız
- 1
Word dosyalarını yükleyin
Her biri en fazla 95 MB olan en fazla 20 adet .docx veya .doc dosyası ekleyin. Markdown değişiklik takibini gösteremediğinden, önce Word'de izlenen değişiklikleri kabul edin veya reddedin.
- 2
Metin seçeneklerini kontrol edin
Biçimlendirme Basit, Metin kodlaması UTF-8 ve Satır sonları LF olarak ayarlıdır; Git ve statik site oluşturucuların beklediği kombinasyon budur. Resimlerin bir klasörde gelmesi için Resimleri dahil et seçeneğini açık tutun.
- 3
Dönüştürün ve arşivi açın
Convert to MD düğmesine basın. Her belge, .md dosyasını ve resimlerini içeren bir ZIP olarak gelir; ZIP'i docs klasörünüze çıkarın ve commit edin.
Word belgesini Markdown'a nasıl dönüştürürüm?
Dosyanızı (.docx) yükleyin ve Convert to MD düğmesine basın. # başlıklar, listeler, bağlantılar ve tablolar içeren bir .md dosyası alırsınız; resimler de yanındaki bir klasörde, hepsi tek bir ZIP içinde gelir.
Docs-as-code için DOCX'ten Markdown'a
Ekipler docs-as-code yaklaşımını tek bir nedenle benimser: dokümantasyon kodun yanında durur, aynı pull request'lerden geçer ve aynı sürümle yayımlanır. .docx bunu bozar; çünkü XML parçalarından oluşan bir ZIP'tir ve Git onu anlaşılmaz bir ikili dosya olarak saklar. Tek kelimelik bir değişiklik okunabilir bir fark göstermeyen değişmiş bir dosya olarak görünür ve aynı anda düzenleyen iki kişi çalışmalarını birleştiremez.
Markdown düz metindir, bu yüzden her düzenleme görünür bir satır değişikliğidir. 2014'te John MacFarlane ve diğerlerinin, Gruber'ın on yıl önce gevşekçe tarif ettiği sözdiziminin kesin bir belirtimi olan CommonMark'ı yayımlamasıyla çok daha öngörülebilir hale geldi. GitHub, 2017'de kendi GitHub Flavored Markdown belirtimini CommonMark üzerine kurdu ve bugün çoğu README'de kullanılan pipe tabloları, görev listelerini ve üstü çizili metni ekledi.
İçeriğiniz ters yöne gidiyorsa, yani Markdown'dan Word'de çalışan bir gözden geçirene, Markdown'dan DOCX'e aracını kullanın. Depo yerine web sayfası için DOCX'ten HTML'ye stilin daha fazlasını korur.
Markdown çıktısı nasıl görünür
## Sürüm kontrol listesi Sürümü etiketlemeden önce şunları doğrulayın: - Testler **main** dalında geçiyor - Değişiklik günlüğü birleştirilen her PR'ı listeliyor | Adım | Sorumlu | | --- | --- | | Derleme | CI | | Yayımlama | Bakımcı | 
Dönüştürülen Markdown nerede görüntülenir
| Kurum | Gereksinim | Kaynak |
|---|---|---|
| GitHub | README.md dosyasını ve depodaki tüm .md dosyalarını GitHub Flavored Markdown ile görüntüler | github.com |
| Hugo | Sayfaları .md içerik dosyalarından, CommonMark uyumlu bir ayrıştırıcıyla oluşturur | gohugo.io |
| Jekyll | Front matter içeren .md dosyalarını sayfalara dönüştürür; GitHub Pages'in arkasındaki motordur | jekyllrb.com |
| Docusaurus | docs klasöründeki .md ve .mdx dosyalarını dokümantasyon sayfaları olarak okur | docusaurus.io |
DOCX
Microsoft Word belgesi
DOCX, Office 2007'den beri Microsoft Word'ün varsayılan belge biçimidir ve Office Open XML standardına (ECMA-376, ISO/IEC 29500) dayanır. Metin, stiller, resimler, tablolar, yorumlar ve değişiklik izlerini içeren XML dosyalarından oluşan bir ZIP paketidir. Ofislerde, okullarda ve iş başvurularında düzenlenebilir belgeler için en yaygın biçimdir. Özellikle karmaşık biçimlendirmelerde Word, Google Docs, LibreOffice ve Pages arasında sayfa düzeni biraz kayabilir. Çoğu kelime işlemci DOCX dosyalarını açar.
- Sıkıştırma
- –
- Saydamlık
- –
- Animasyon
- –
- Çıkış yılı
- 2007 · Microsoft
MD
Markdown
Markdown, John Gruber'in 2004'te oluşturduğu hafif bir işaretleme sözdizimidir. Başlıklar için #, vurgu için * ve listeler için - gibi düz metin simgeleri kullanır; bunlar ham metin olarak okunabilir kalır ve HTML'ye temiz biçimde dönüşür. README dosyaları, belgeler, wiki'ler, not uygulamaları ve birçok statik site oluşturucu için standarttır. CommonMark ve GitHub Flavored Markdown gibi, tablolar gibi ayrıntılarda farklılaşan birkaç lehçesi vardır. Her metin düzenleyici .md dosyalarını açabilir.
- Sıkıştırma
- –
- Saydamlık
- –
- Animasyon
- –
- Çıkış yılı
- 2004 · John Gruber
DOCX, bir belge kod iş akışına girerken Markdown'a dönüştürülür: Git'te tutulan bir README, docs sitesi veya bilgi tabanı gibi. Düz metin burada karşılaştırılabilir, pull request'lerde incelenebilir ve birçok araç tarafından görüntülenebilir.
Markdown'da karşılığı olmayan Word özellikleri
Dönüştürmeden önce bunları planlayın
- Yazı tipleri, renkler ve sayfa düzeni atılır; Markdown yapıyı tanımlar, görünümü site teması belirler
- İzlenen değişiklikler ve yorumlar aktarılmaz, bu yüzden önce Word'de çözün
- Üstbilgi, altbilgi ve sayfa numaraları .md dosyasında yer almaz
- Metin kutuları ve metin kaydırmalı resimler sıradan paragraflara ve resim bağlantılarına dönüşür
- Elle biçimlendirdiğiniz başlıklar (Başlık 2 yerine kalın 16 pt) kalın metin olarak çıkar, bu yüzden önce gerçek başlık stillerini uygulayın
- Altı çizili metnin Markdown sözdizimi yoktur; kaldırılır veya HTML olarak korunur
DOCX'ten Markdown'a dönüştürme hakkında sorular
DOCX'ten MD'ye çıktı hangi Markdown türünü izler?
Başlıklar, vurgular, listeler, bağlantılar ve kod CommonMark'a uyar; tablolar ise GitHub Flavored Markdown'daki dikey çizgi (pipe) sözdizimini kullanır. GitHub, GitLab, Hugo, Jekyll ve Docusaurus bu kombinasyonu sorunsuz görüntüler.
Birleştirilmiş tablo hücrelerine ne olur?
Markdown pipe tablolarında birleştirilmiş hücre yoktur; bu yüzden her birleştirilmiş alan tek tek hücrelere ayrılır ve metin ilk hücrede kalır. Karmaşık tabloları .md içinde HTML olarak yeniden oluşturun veya dönüştürmeden önce Word'de sadeleştirin.
Word belgemdeki resimler nereye gider?
Resimleri dahil et açıkken her resim ZIP içinde ayrı bir dosya olarak kaydedilir ve Markdown ona images/figure-1.png gibi göreli bir yolla bağlanır. .md dosyasını taşırken bu klasörü yanında tutun.
Word dipnotları Markdown'da korunur mu?
CommonMark'ta dipnot sözdizimi yoktur; ancak GitHub 2021'de [^1] dipnotlarını ekledi ve çoğu site oluşturucu bunları destekler. Kullandığınız oluşturucu desteklemiyorsa dipnot metni sonda düz paragraflar olarak görünür.
Google Dokümanlar'ı bu yolla Markdown'a dönüştürebilir miyim?
Evet. Google Dokümanlar'da Dosya > İndir > Microsoft Word (.docx) seçeneğini seçin, ardından o dosyayı buraya yükleyin. Google Dokümanlar'ın kendi Markdown indirme seçeneği de vardır ve basit belgelerde iyi çalışır.
