Konversi DOCX ke Markdown online

Saat file Word perlu menjadi teks biasa yang terstruktur

Dokumentasi sering lahir di Word: spesifikasi yang ditulis product manager, kebijakan yang disusun tim legal, manual yang diserahkan klien. Namun tujuannya sering berupa repositori Git, static site generator, wiki, basis pengetahuan, atau aplikasi catatan, dan semuanya berbahasa Markdown. Salin-tempel menghilangkan heading dan daftar, sedangkan mengetik ulang dokumen 20 halaman secara manual memakan waktu berjam-jam.

Markdown juga format yang baik untuk arsip dan review. Perbedaannya terbaca rapi di version control, jadi setelah mengonversi kontrak atau dokumen kebutuhan, Anda bisa melacak setiap perubahan berikutnya baris demi baris, sesuatu yang tidak mungkin dengan file biner .docx.

Cara kerja konversi

File .docx adalah arsip ZIP berisi file-file XML. Konverter membukanya di browser Anda, membaca isi dokumen, dan lebih dulu memetakan struktur Word ke HTML, lalu mengubah HTML itu menjadi Markdown. Kedua langkah memakai aturan Markdown yang sama dengan konverter HTML ke Markdown di situs ini, sehingga hasil dari kedua alat terlihat konsisten.

Apa yang ikut terbawa, dan bagaimana ditulis:

• Heading menjadi # hingga ######, satu tingkat untuk setiap level heading Word dari 1 sampai 6.
• Tebal menjadi **text** dan miring menjadi _text_.
• Daftar berpoin dan bernomor menjadi daftar - dan 1., dengan tingkat bersarang dipertahankan hingga lima level.
• Hyperlink menjadi [text](url), termasuk tautan ke situs eksternal.
• Tabel menjadi pipe table, dengan baris pertama dipakai sebagai header.
• Catatan kaki dan catatan akhir dikumpulkan menjadi daftar bernomor di akhir dokumen, dan setiap rujukan di teks menjadi tautan ke catatannya.

Hasilnya dirapikan sehingga tidak pernah ada lebih dari satu baris kosong di antara blok.

Mengapa heading kadang keluar sebagai teks biasa

Konverter mengenali heading dari gaya paragrafnya, bukan dari tampilannya. Baris yang diformat dengan gaya bawaan Heading 1 hingga Heading 6 menjadi heading Markdown. Baris yang dibuat besar dan tebal secara manual oleh penulis, bagi file tersebut, hanyalah paragraf biasa dengan teks tebal, dan keluar sebagai **Pendahuluan**, bukan ## Pendahuluan.

Hal yang sama berlaku untuk judul dokumen. Gaya Title di Word bukan gaya heading, jadi judul yang diatur dengan gaya itu menjadi paragraf biasa. Jika struktur penting, perbaiki di Word sebelum mengonversi: pilih barisnya dan terapkan Heading 1 atau Heading 2 dari galeri Styles. Cara cepat memeriksa dokumen adalah Navigation Pane di Word, yang hanya menampilkan heading sungguhan. Apa pun yang tidak ada di sana juga tidak akan ada di kerangka Markdown.

Apa yang tidak disertakan

Markdown sengaja dibuat sederhana, jadi banyak tata letak Word tidak punya padanannya:

• Gambar tidak disertakan, dan sebuah pemberitahuan menyebutkan berapa yang dilewati. Menyematkannya sebagai teks base64 akan membuat file berlipat-lipat lebih besar dari teksnya sendiri.
• Garis bawah, font, ukuran, dan warna dibuang. Markdown tidak punya sintaks untuk itu.
• Teks coret dipertahankan, tetapi tanpa tanda coretnya.
• Header, footer, nomor halaman, dan pemisah bagian termasuk tata letak halaman, bukan konten, dan tidak dikonversi.
• Kotak teks dan bentuk bisa hilang atau muncul di tempat yang salah, karena mengambang di luar alur teks utama.
• Format sel tabel diratakan menjadi teks biasa. Tebal, tautan, atau daftar di dalam sel kehilangan formatnya, dan paragraf-paragraf dalam sel yang berisi beberapa paragraf digabung menjadi satu baris, kadang tanpa spasi di antaranya.

Rutinitas perapian yang praktis

Markdown-nya biasanya sudah 90 persen siap. Satu kali pemeriksaan singkat membereskan sisanya:

1. Periksa heading. Pastikan ada satu heading tingkat atas # jika situs Anda mengharapkannya, dan tingkatannya tidak melompat dari # langsung ke ###.
2. Periksa daftar bernomor yang disela paragraf atau gambar. Markdown bisa memulai ulang penomoran dari 1.
3. Lihat tabel dengan sel gabungan, yang muncul sebagai baris dengan jumlah kolom berbeda, dan seragamkan secara manual.
4. Tambahkan kembali gambar dengan mengekspornya dari Word, meletakkan filenya di samping file .md, dan menyisipkan ![deskripsi](image.png) di tempat yang semestinya.
5. Pratinjau hasilnya dengan Markdown ke HTML sebelum menerbitkan.

File hingga 50 MB diterima, sedangkan format biner lama .doc tidak. Dokumen hanya dibaca di tab browser Anda, jadi draf rahasia tidak pernah sampai ke server.