Word ke MarkdownKonverter Word ke Markdown
Kembali ke Blog
🚀 Baru Diluncurkan

🆕 Konversi Word ke Markdown dengan Gambar - Fitur Baru Telah Diluncurkan!

Kami sangat senang mengumumkan peluncuran fitur yang paling diminta: Konversi Word ke Markdown dengan Gambar! Alat revolusioner ini menggabungkan pemrosesan gambar bertenaga AI dengan konversi Word ke Markdown yang andal

27 Juli 2025

Mengonversi dokumen Word dengan gambar ke Markdown adalah momen ketika kebanyakan konverter diam-diam gagal — teks tembus, heading sejajar, lalu Anda menemukan bahwa setiap screenshot menjadi referensi `![image](data:...)` yang rusak, atau lebih buruk, hilang dalam diam. Word2MD.net dibangun khusus di sekitar masalah gambar karena di situlah setiap migrasi dokumentasi yang kami lihat rontok. Panduan ini menjelaskan apa yang sebenarnya terjadi pada gambar selama konversi, pipeline yang dipakai Word2MD.net untuk menjaganya tetap utuh, dan kapan menyematkan, menautkan, atau menjalankan OCR.

Apa yang terjadi pada gambar secara default

File .docx adalah arsip ZIP. Gambar tinggal di dalam `/word/media/` sebagai biner PNG, JPEG, atau EMF mentah. Konverter naif melakukan salah satu dari tiga hal, semuanya buruk: menyisipkannya sebagai string base64 raksasa (Markdown membengkak menjadi megabytes), menjatuhkannya dengan placeholder `[image]`, atau gagal total pada format EMF/WMF yang Word masih emit untuk chart dan screenshot dari versi Office lama. Tak satu pun hasil ini lolos review PR Git.

Pipeline gambar Word2MD.net

  • Ekstraksi: setiap gambar tertanam dilepas dari ZIP .docx dan diberi nama file stabil dari nama dokumen plus hash.
  • Normalisasi format: EMF dan WMF — yang sebagian besar browser tidak render — dikonversi ke PNG saat itu juga.
  • Sidecar export: di mode batch, gambar dikirim dalam folder `images/` di dalam ZIP hasil, bersama Markdown yang merujuknya dengan path relatif bersih.
  • Pelestarian alt text: jika Word asli punya alt text pada gambar, itu dibawa ke sintaks `![alt]()` — krusial untuk aksesibilitas dan SEO.
  • Opsi OCR: untuk screenshot UI, terminal, atau halaman yang dipindai, AI OCR berjalan di samping link gambar untuk menarik teks yang bisa dicari.

AI OCR untuk screenshot dan scan

Screenshot merusak pipeline RAG karena index LLM tidak bisa melihat ke dalam gambar. Spek produk 50 halaman dengan 80 screenshot UI kehilangan 80 chunk konten saat di-ingest. Lintasan OCR opsional Word2MD.net menarik teks yang terlihat dari setiap gambar dan meng-emit-nya di sebelah link `![alt]()` sebagai blok kode fenced. Gambar tetap dikirim untuk pembaca manusia; versi teks membuat konten yang sama bisa diambil oleh LlamaIndex, LangChain, Haystack, atau pipeline embedding kustom apa pun. Untuk tim knowledge base, fitur tunggal ini sering kali sudah membenarkan konversi.

Kapan embed, link, atau OCR — aturan keputusan

Gunakan base64 inline hanya untuk dokumen di bawah 50 KB total yang akan Anda publikasikan di satu halaman statis (jarang). Gunakan sidecar export dengan link relatif untuk apa pun yang tinggal di repo Git — itu memberi reviewer diff gambar normal dan menjaga Markdown tetap terbaca manusia. Tambah OCR ketika konten gambar itu sendiri membawa informasi yang pembaca atau LLM perlu cari: pesan error di screenshot, kode di terminal, label di diagram. Lewati OCR untuk foto dekoratif — itu hanya menambah noise. Tes jujurnya: jika pembaca bisa mengabaikan gambar tanpa kehilangan apa-apa, Anda tidak butuh OCR.