Word ke Markdown Panduan Pemformatan: Pertahankan Setiap Gaya

Pemformatan adalah di mana sebagian besar konversi Word-ke-Markdown salah. Teks tebal ditampilkan sebagai teks biasa. Meja runtuh. Judul menjadi paragraf yang tidak bergaya. Panduan ini menjelaskan persis apa yang terjadi selama Word ke Markdown konversi dan bagaimana mengontrol output.

Memahami Proses Konversi

Ketika Anda mengkonversi dokumen Word ke Markdown, dua hal terjadi:

1. DOCX → HTML mammoth.js menganalisis Word XML dan memetakan setiap elemen ke HTML
2. HTML → Markdown Turndown mengkonversi sintaksis HTML ke Markdown

Langkah kedua tidak rugi jika HTML bersih. Langkah pertama adalah di mana masalah kerumitan pemformatan Words gaya perlu memetakan ke diketahui HTML setara.

Penggunaan Konverter WordToMDs untuk melihat persis bagaimana dokumen Anda dikonversi secara real time.

Gaya Judul

Keputusan pemformatan yang paling penting dalam Word adalah menggunakan gaya header built-in.

Kesalahan umum: Memformat teks secara manual sebagai besar dan tebal alih-alih menerapkan gaya Judul. Ini terlihat seperti judul di Word tetapi mengkonversi ke teks tebal di Markdown, tidak ##.

Untuk referensi lengkap untuk judul, lihat Markdown Panduan Judul.

Penekanan Teks

Underline dan highlight tidak memiliki Markdown setara dalam sintaksis standar. Setelah konversi, gunakan HTML <u> tag atau kelas CSS kustom jika platform penerbitan Anda mendukungnya.

Daftar

Words otomatis pemformatan daftar mengkonversi bersih:

- Bullet item one
- Bullet item two
  - Nested bullet (indent 2 spaces)

1. First item
2. Second item
   1. Nested numbered item

Apa yang memecahkan daftar: Dasar atau angka yang diketik secara manual yang bukan item daftar Word yang sebenarnya. Ini terlihat seperti daftar secara visual tetapi Word memperlakukan mereka sebagai paragraf teks biasa. Perbaikan: pilih mereka di Word dan gunakan gaya List Bullet atau List Number.

Tabel

Tabel standar dikonversi ke GitHub Beraroma Markdown sintaksis tabel:

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |

Apa yang menghancurkan tabel:

• Sel yang digabungkan sel yang mencakup beberapa kolom atau baris akan digabungkan
• Isi sel multi-garis Putus garis di dalam sel dihapus
• Tabel tertanam tabel dalam rata menjadi teks polos

Untuk rincian lengkap, lihat Markdown Tabel: Panduan Lengkap.

Kode dan Teks Pra-Format

Teks diformat dengan font monospace (Courier New, Consolas) dalam Word maps ke kode inline:

Use `console.log()` to debug.

Untuk blok kode yang diblokir dengan penekanan sintaksis, gunakan Words Code gaya paragraf jika templat Anda memilikinya, atau tambahkan pagar backtick triple secara manual setelah konversi. Lihat Markdown Panduan Blok Kode untuk sintaksis penuh.

Hiper-tautan

Word hyperlink dikonversi dengan sempurna:

Visit [WordToMD](https://wordtomd.org) for instant conversion.

Teks tautan dan URL disimpan. Bookmark (tautan internal dalam dokumen yang sama) mungkin tidak dikonversi jika target tidak ada di Markdown.

Gambar-gambar

Gambar adalah di mana konversi Word-to-Markdown secara konsisten gagal. mammoth.js dapat mengekstrak gambar tertanam sebagai base64 data URIs, tapi perilaku default adalah untuk mencatat keberadaan mereka dalam Conversion Notes. Setelah konversi:

1. Ekspor gambar dari Word: File → Save As → Web Page (HTML)
2. Referensi mereka di Markdown: ![Alt text](path/to/image.png)

Karakter dan Simbol Khusus

Word sering memasukkan karakter Unicode khusus secara otomatis:

• Penawaran cerdas ("...") → dipertahankan sebagai karakter Unicode
• Em dash (—) → terkonservasi
• Ruang non-pecah → dikonversi menjadi ruang reguler
• Simbol hak cipta (©) → terkonservasi

Jika Anda membutuhkan output ASCII-only, lakukan cari-dan-ganti di editor teks Anda setelah konversi.

Word Gaya kustom

Jika dokumen Word Anda menggunakan gaya paragraf khusus (seperti Callout atau Warning), mammoth.js mencatatnya sebagai catatan konversi. Anda akan melihat pesan seperti Unrecognized paragraph style: Callout. WordToMD menyaring pesan informasi ini secara default.

Untuk menangani gaya kustom, Anda akan membutuhkan pengaturan Pandoc lokal dengan filter kustom lihat Pandoc Word sampai Markdown untuk pendekatan itu.

Daftar Periksa Format Sebelum Anda Mengkonversi

Terapkan daftar periksa ini pada dokumen Word Anda sebelum mengkonversi:

• Semua judul menggunakan Words built-in Style Heading 1/2/3 (bukan pemformatan manual)
• Daftar dibuat dengan alat daftar Words (tidak dicetak garis miring / angka)
• Tabel adalah grid sederhana (tidak ada sel yang digabungkan)
• Kode menggunakan font monospace
• Hyperlink adalah hyperlink yang sebenarnya (bukan hanya teks yang digarisbawahi biru)

FAQ

Mengapa judul saya dikonversi menjadi teks tebal? Anda menerapkan format ukuran font manual yang tebal + bukan gaya Heading. Dalam Word, klik pada paragraf dan lihat pada panel Gaya seharusnya mengatakan Judul 1 tidak Normal.

Daftar bernomor saya dimulai kembali pada 1 di tempat yang salah bagaimana saya memperbaikinya? Tetapkan kelanjutan daftar di Word: klik kanan daftar → Lanjutkan Penomoran. Atau edit Markdown langsung setelah konversi.

Perataan tabel terlihat salah di Markdown. Apa yang terjadi? Penggunaan tabel GFM |---| untuk pemisah penyelarasan. WordToMD menghasilkan ini secara otomatis. Jika rendering terlihat salah, periksa bahwa tidak ada sel yang memiliki karakter pipa (|) dalam isi mereka menghindari mereka sebagai \|.

Kesimpulan

Membuat bersih Word ke Markdown pemformatan adalah sebagian besar tentang menggunakan Word dengan benar. Menerapkan gaya judul built-in, menggunakan Words daftar dan tabel alat, dan Anda akan mendapatkan output yang hampir sempurna dari WordToMD konverter. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.