Konversi DOCX ke Markdown

1. 1

   Tambahkan dokumen Word Anda

   Seret berkas DOCX ke area unggah, atau klik Pilih file untuk memilihnya. Hanya berkas Word .docx yang diterima; selain itu langsung ditolak dengan pesan yang menjelaskan apa yang harus dilakukan. Konversi berjalan sendiri - tidak ada tombol yang perlu ditekan lebih dulu.

2. 2

   Tentukan tampilan Markdown-nya

   Pilih varian Markdown: GitHub Flavored Markdown untuk repositori dan sebagian besar situs statis, CommonMark untuk pengurai ketat, atau Pandoc bila hasilnya masuk ke alur Pandoc. Lalu tentukan nasib gambar tertanam, perlu tidaknya front matter YAML, apakah judul diturunkan, dan apakah baris panjang dibungkus.

3. 3

   Periksa di pratinjau

   Beralihlah antara Sumber dan Terender. Sumber menampilkan persis Markdown yang akan Anda bawa; Terender menampilkan wujudnya setelah dibaca mesin Markdown, sehingga Anda bisa memastikan tabel, daftar, dan tautan sudah benar sebelum menerima hasilnya.

4. 4

   Salin atau unduh

   Gunakan Salin untuk menaruh Markdown ke papan klip, atau Unduh untuk menyimpan berkas .md. Jika dokumen berisi gambar, unduh ZIP-nya: berisi berkas .md dan folder images yang isinya cocok dengan jalur di dalam Markdown. Semua berjalan di perangkat Anda dan tidak ada dokumen yang pernah diunggah.

Setiap bagian dokumen Word yang punya padanan Markdown ikut terbawa, dan bagian yang tidak punya ditulis sebagai HTML alih-alih dibuang diam-diam.

• Tabel sungguhan: Tabel Word menjadi tabel pipa, dengan perataan kolom yang dibaca dari dokumen, bukan ditebak.
• Catatan kaki dan akhir: Keduanya menjadi referensi [^1] dengan definisi yang dikumpulkan di akhir berkas.
• Format sebaris lengkap: Tebal, miring, coret, garis bawah, sorotan, superskrip, subskrip, kode sebaris, dan tautan semuanya bertahan.
• Ekstraksi gambar: Gambar tertanam ditulis ke folder images dan dikirim bersama Markdown sebagai satu ZIP.
• Front matter YAML: Judul, penulis, subjek, kata kunci, dan tanggal dokumen menjadi satu blok front matter.
• Tiga varian Markdown: GitHub Flavored Markdown, CommonMark, dan Pandoc, masing-masing dengan sintaks yang benar-benar didukungnya.
• Pratinjau terender: Beralihlah antara sumber Markdown dan wujud akhirnya sebelum menyalin atau mengunduh apa pun.
• Batch dalam satu arsip: Konversi banyak dokumen dan bawa semuanya sebagai satu ZIP, bukan satu dialog simpan untuk tiap berkas.

Struktur adalah bagian dokumen Word yang paling mudah hilang dan paling sulit disadari hilangnya. Konverter yang meratakan tabel menjadi paragraf lepas menghasilkan keluaran yang sekilas tampak baik tetapi salah dengan cara yang baru ketahuan setelah ditempelkan di suatu tempat. Alat ini memperlakukan struktur sebagai hal yang sedang dikonversi.

Bagaimana tabel Word menjadi Markdown

• Baris kepala: Baris yang ditandai Word sebagai kepala berulang menjadi kepala tabel. Bila tidak ada yang ditandai, baris pertama yang dipakai, karena hampir selalu itulah fungsinya.
• Perataan kolom: Kiri, tengah, dan kanan dibaca dari perataan paragraf dokumen dan ditulis sebagai ---, :---:, dan ---:.
• Pipa di dalam sel: Sel yang memuat karakter pipa di-escape agar tidak memecah kolom menjadi dua.
• Sel dengan banyak paragraf: Dua paragraf dalam satu sel disatukan dengan ganti baris, sehingga tabel pipa tetap utuh alih-alih memaksa seluruh tabel menjadi HTML.
• Sel gabungan: Markdown tidak bisa menyatakan sel gabungan, jadi tabel semacam itu ditulis sebagai HTML - diterima setiap mesin Markdown dan tanpa kehilangan data.
• Daftar bersarang: Sarang dipertahankan sampai kedalaman berapa pun, dengan indentasi yang diminta CommonMark agar isinya sejajar.

Kata Markdown mencakup beberapa dialek yang benar-benar berbeda, dan salah memilih menghasilkan berkas penuh tanda baca liar alih-alih pemformatan. Pengaturan varian mengubah sintaks yang dikeluarkan, bukan sekadar label.

Mana yang sebaiknya dipilih?

• GitHub Flavored Markdown: Pilihan bawaan dan jawaban yang tepat untuk GitHub, GitLab, wiki, dan sebagian besar generator situs statis. Tabel pipa, ~~coret~~, dan catatan kaki [^1] tersedia.
• CommonMark: Dasar yang ketat. Sama sekali tanpa sintaks tabel, coret, atau catatan kaki, sehingga elemen itu ditulis sebagai HTML yang tampil benar di mana pun, alih-alih memperlihatkan tilde dan pipa harfiah.
• Pandoc: Menambahkan sintaks Pandoc sendiri untuk ^superskrip^ dan ~subskrip~. Pilih ini bila Markdown masuk ke alur Pandoc yang membacanya.

Dokumen Word biasanya memuat lebih dari teks. Ke mana perginya tambahan itu bergantung pada rencana Anda terhadap Markdown-nya, jadi ini pengaturan, bukan asumsi.

Tiga cara menangani gambar tertanam

• Ekstrak ke folder: Setiap gambar ditulis ke images/image-1.png dan dirujuk lewat jalur relatif itu. Unduhannya menjadi ZIP berisi berkas .md dan foldernya, siap dimasukkan ke repositori.
• Tanam sebaris: Setiap gambar menjadi URI data di dalam Markdown itu sendiri. Berkasnya mandiri dan jauh lebih besar, cocok untuk menempelkan cuplikan pendek di tempat yang tidak bisa menampung berkas.
• Tinggalkan saja: Tanpa rujukan gambar sama sekali, untuk migrasi ketika gambarnya sudah tersimpan di tempat lain dan hanya teks yang perlu pindah.

Apa yang masuk ke front matter

• Judul, penulis, dan subjek, diambil dari properti yang disimpan Word, bukan ditebak dari teksnya.
• Kata kunci, dipecah menjadi daftar YAML bila dokumen punya lebih dari satu.
• Tanggal dibuat dan diubah, dalam bentuk ISO yang diharapkan generator situs statis.
• Setiap nilai diberi tanda kutip bila perlu, sehingga judul bermuatan titik dua tidak bisa merusak proses build situs yang membacanya.

Mengonversi Word ke Markdown memungkinkan kontrol versi, menghasilkan konten ramah pengembang, memudahkan dokumentasi, memungkinkan publikasi di GitHub, dan menyiapkan dokumen untuk penulisan teknis.

Keunggulan format Markdown

• Kontrol versi: Markdown adalah teks biasa, jadi diff menunjukkan apa yang benar-benar berubah alih-alih gumpalan biner.
• Ramah pengembang: Ia hidup berdampingan dengan kode yang didokumentasikannya dan tidak butuh editor khusus.
• Publikasi GitHub: Konten README dan wiki tampil secara native di GitHub dan GitLab.
• Penulisan teknis: Rantai perkakas docs-as-code menerima Markdown sebagai format masukan.
• Pemformatan sederhana: Sintaksnya cukup ringkas untuk dibaca sebagai teks biasa dan ditulis tanpa bilah alat.

Konversi berlangsung dalam dua tahap, dan mengetahui mana yang mana menjelaskan mengapa mengubah pengaturan terasa instan sementara konversi pertama butuh sesaat.

Proses konversi

• Membaca dokumen: Berkas .docx dibuka di perangkat Anda dan struktur, gaya, gambar, serta propertinya dibaca. Inilah bagian yang memakan waktu, dan hanya terjadi sekali per berkas.
• Menulis Markdown: Struktur diubah menjadi Markdown sesuai varian dan pengaturan lain. Ini murni kerja teks, jadi praktis instan.
• Mengubah pengaturan: Hanya tahap kedua yang dijalankan ulang. Karena itu pratinjau diperbarui begitu Anda menyentuh kontrol, bahkan pada dokumen yang sangat panjang.
• Batch: Setiap dokumen dibaca dan ditulis secara mandiri, dan setiap hasil bisa disalin, diunduh sendiri, atau dikumpulkan ke satu arsip.

Memahami fakta-fakta ini membantu Anda mengambil keputusan konversi yang lebih baik.

Statistik penting

• Dokumen 25.000 kata berisi 50 tabel dibaca sekitar 22 milidetik dan dirender ulang di bawah satu milidetik saat pengaturan berubah.
• Hanya .docx yang diterima. Format biner .doc yang lama ditolak dengan penjelasan, karena itu format berbeda yang bisa dikonversi Word untuk Anda.
• Versi gratis mencakup satu dokumen setiap kali, hingga 50 MB, dengan seluruh fitur konversi; Pro mencakup batch hingga 50.
• Escape dijaga seminimal mungkin: karakter yang bisa memulai Markdown di-escape, dan yang tidak bisa dibiarkan persis seperti aslinya.
• Judul, daftar, tautan, penekanan, tabel, catatan kaki, dan gambar semuanya dipertahankan.

Mengonversi dokumen 25.000 kata berisi 50 tabel jauh di bawah satu detik, di perangkat Anda.

Ikuti panduan ini untuk hasil konversi Word ke Markdown yang optimal.

Pertimbangan kualitas

• Gunakan gaya Heading bawaan Word alih-alih teks tebal yang diperbesar manual - konverter hanya mengenali judul yang memang ditandai sebagai judul.
• Periksa tab Terender sebelum mengunduh, terutama untuk dokumen bertabel, guna memastikan strukturnya sesuai harapan.
• Bila Markdown akan ditempatkan di bawah judul yang sudah ada, turunkan judulnya satu tingkat agar dokumen hanya punya satu judul tingkat teratas.
• Pilih CommonMark hanya bila pengurai ketat mengharuskannya; keluaran HTML penggantinya benar tetapi lebih panjang.
• Uji berkas .md di tempat tujuannya - GitHub, situs statis, wiki - setelah diunduh.

Kasus penggunaan umum

• Dokumentasi: Memindahkan manual Word yang sudah ada ke repositori docs-as-code tanpa mengetik ulang.
• Publikasi GitHub: Mengubah spesifikasi atau proposal menjadi README atau halaman wiki.
• Penulisan teknis: Membawa draf yang ditulis di Word ke rantai Markdown untuk telaah dan kontrol versi.
• Tulisan blog: Mengubah draf tertulis menjadi tulisan untuk generator situs statis, lengkap dengan front matter.
• Konten pengembang: Mengeluarkan tabel dan konten mirip kode dari spesifikasi Word ke bentuk yang bisa dibandingkan.

• Word ke PDF
• Word ke HTML
• Penampil Word
• Word ke teks
• Kompres Word
• CSV ke Markdown