Konversi DOCX ke Markdown
Memindahkan dokumentasi dari Word ke repositori Git dimulai dengan mengubah setiap .docx menjadi Markdown. Konverter ini menulis teks bergaya CommonMark dengan heading #, tabel pipa, dan tautan gambar, siap di-commit.
Konverter Dokumen
atau jatuhkan file PDF, DOC, DOCX … di sini ·
Maks. 95 MB per file· Hingga 20 file· Dihapus setelah 30 menit
File diproses di server kami dan dihapus setelah 30 menit.
150 DPI mengubah halaman A4 menjadi sekitar 1240 × 1754 px. Gunakan 300 untuk dicetak.
Konversi seluruh file atau hanya sebagian halaman atau slide (masukan PDF dan presentasi).
Halaman atau slide yang dikonversi, mis. 1-3, 5, 8-10.
UTF-8 berfungsi untuk semua bahasa. Pilih UTF-8 dengan BOM jika Excel atau Notepad di Windows menampilkan karakter yang kacau; encoding lama hanya untuk perangkat lunak lama.
LF untuk macOS, Linux, dan editor kode; CRLF untuk program Windows lama seperti Notepad klasik.
Koma adalah standar. Gunakan titik koma untuk Excel di negara yang menulis desimal dengan koma (Jerman, Prancis, Brasil).
Masukan Excel dengan beberapa sheet: konversi semuanya (satu bagian atau file per sheet) atau hanya yang pertama.
Cara menggunakan alat ini
- 1
Unggah file Word
Tambahkan hingga 20 file .docx atau .doc, masing-masing hingga 95 MB. Terima atau tolak lacak perubahan di Word terlebih dahulu, karena Markdown tidak punya cara untuk menampilkannya.
- 2
Periksa opsi teks
Pemformatan diatur ke Sederhana, Encoding teks ke UTF-8, dan Akhir baris ke LF, kombinasi yang diharapkan Git dan static site generator. Biarkan Sertakan gambar aktif agar gambar tersimpan dalam satu folder.
- 3
Konversi dan ekstrak
Tekan Konversi ke MD. Setiap dokumen tiba sebagai ZIP berisi file .md beserta gambarnya; ekstrak ke folder dokumentasi Anda lalu commit.
Bagaimana cara mengubah dokumen Word ke Markdown?
Unggah .docx lalu tekan Konversi ke MD. Anda mendapatkan file .md berisi heading #, daftar, tautan, dan tabel, ditambah gambar dalam folder di sampingnya, semuanya dalam satu ZIP.
DOCX ke Markdown untuk docs-as-code
Tim menerapkan docs-as-code karena satu alasan: dokumentasi tinggal berdampingan dengan kode, melewati pull request yang sama, dan dirilis bersama rilis yang sama. File .docx merusak alur itu, karena isinya ZIP berisi bagian-bagian XML yang disimpan Git sebagai biner tertutup. Perubahan satu kata hanya muncul sebagai file yang berubah tanpa diff yang bisa dibaca, dan dua orang yang menyunting bersamaan tidak bisa menggabungkan pekerjaan mereka.
Markdown adalah teks polos, sehingga setiap suntingan terlihat sebagai perubahan baris. Markdown juga menjadi jauh lebih konsisten pada 2014, ketika John MacFarlane dan rekan-rekannya menerbitkan CommonMark, spesifikasi presisi untuk sintaks yang sepuluh tahun sebelumnya dijelaskan Gruber secara longgar. Pada 2017 GitHub mendasarkan spesifikasi GitHub Flavored Markdown miliknya pada CommonMark, dengan menambahkan tabel pipa, daftar tugas, dan coretan yang dipakai sebagian besar README saat ini.
Jika konten Anda bergerak ke arah sebaliknya, dari Markdown ke peninjau yang bekerja di Word, gunakan Markdown ke DOCX. Untuk halaman web, bukan repositori, DOCX ke HTML mempertahankan lebih banyak gaya.
Seperti apa hasil Markdown-nya
## Daftar periksa rilis Sebelum menandai rilis, pastikan hal berikut: - Tes lolos di **main** - Changelog mencantumkan setiap PR yang sudah digabung | Langkah | Penanggung jawab | | --- | --- | | Build | CI | | Publikasi | Maintainer | 
Tempat Markdown hasil konversi akan ditampilkan
| Organisasi | Persyaratan | Sumber |
|---|---|---|
| GitHub | Menampilkan README.md dan file .md apa pun di repositori dengan GitHub Flavored Markdown | github.com |
| Hugo | Membangun halaman dari file konten .md dengan parser yang sesuai CommonMark | gohugo.io |
| Jekyll | Mengubah file .md yang memiliki front matter menjadi halaman; mesin di balik GitHub Pages | jekyllrb.com |
| Docusaurus | Membaca file .md dan .mdx di folder docs sebagai halaman dokumentasi | docusaurus.io |
DOCX
Dokumen Microsoft Word
DOCX adalah format dokumen bawaan Microsoft Word sejak Office 2007, berbasis standar Office Open XML (ECMA-376, ISO/IEC 29500). Format ini berupa paket ZIP berisi file XML yang memuat teks, gaya, gambar, tabel, komentar, dan perubahan terlacak. DOCX adalah format paling umum untuk dokumen yang dapat diedit di kantor, sekolah, dan lamaran kerja. Tata letak dapat sedikit bergeser antara Word, Google Docs, LibreOffice, dan Pages, terutama dengan format yang rumit. Sebagian besar pengolah kata dapat membuka file DOCX.
- Kompresi
- –
- Transparansi
- –
- Animasi
- –
- Diperkenalkan
- 2007 · Microsoft
MD
Markdown
Markdown adalah sintaksis markup ringan yang dibuat oleh John Gruber pada 2004. Markdown menggunakan simbol teks biasa, seperti # untuk judul, * untuk penekanan, dan - untuk daftar, yang tetap mudah dibaca sebagai teks mentah dan dapat dikonversi dengan rapi ke HTML. Markdown menjadi standar untuk file README, dokumentasi, wiki, aplikasi catatan, dan banyak static site generator. Ada beberapa dialek, seperti CommonMark dan GitHub Flavored Markdown, yang berbeda dalam detail seperti tabel. Editor teks apa pun dapat membuka file .md.
- Kompresi
- –
- Transparansi
- –
- Animasi
- –
- Diperkenalkan
- 2004 · John Gruber
DOCX diubah ke Markdown ketika dokumen masuk ke alur kerja kode: README, situs dokumentasi, atau basis pengetahuan yang disimpan di Git, tempat teks polos bisa dibandingkan perubahannya, ditinjau dalam pull request, dan ditampilkan oleh banyak alat.
Fitur Word yang tidak punya padanan di Markdown
Rencanakan hal-hal ini sebelum mengonversi
- Font, warna, dan tata letak halaman dibuang; Markdown menggambarkan struktur, dan tema situs yang menentukan tampilan
- Lacak perubahan dan komentar tidak ikut terbawa, jadi selesaikan dulu di Word
- Header, footer, dan nomor halaman tidak punya tempat di file .md
- Kotak teks dan gambar dengan pembungkusan teks menjadi paragraf biasa dan tautan gambar
- Heading yang Anda format manual, misalnya tebal 16 pt alih-alih Heading 2, keluar sebagai teks tebal, jadi terapkan style heading yang sebenarnya lebih dulu
- Garis bawah tidak punya sintaks Markdown dan akan dihapus atau dipertahankan sebagai HTML
Pertanyaan seputar konversi DOCX ke Markdown
Varian Markdown apa yang diikuti keluaran DOCX ke MD?
Heading, penekanan, daftar, tautan, dan kode mengikuti CommonMark, sedangkan tabel memakai sintaks pipa dari GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll, dan Docusaurus semuanya menampilkan kombinasi itu.
Apa yang terjadi pada sel tabel yang digabung saat diubah ke Markdown?
Tabel pipa Markdown tidak mengenal sel gabungan, sehingga setiap area gabungan dipecah kembali menjadi sel-sel tersendiri dengan teks di sel pertama. Susun ulang tabel yang rumit sebagai HTML di dalam .md, atau sederhanakan di Word sebelum mengonversi.
Ke mana perginya gambar dari dokumen Word saya?
Dengan Sertakan gambar aktif, setiap gambar disimpan sebagai file terpisah di dalam ZIP, dan Markdown menautkannya dengan path relatif seperti images/figure-1.png. Simpan folder itu di samping file .md saat Anda memindahkannya.
Apakah catatan kaki Word tetap ada di Markdown?
CommonMark tidak punya sintaks catatan kaki, tetapi GitHub menambahkan catatan kaki [^1] pada 2021 dan sebagian besar site generator mendukungnya. Jika renderer Anda tidak mendukung, teks catatan muncul sebagai paragraf biasa di bagian akhir.
Bisakah Google Docs diubah ke Markdown dengan cara ini?
Bisa. Di Google Docs pilih File > Download > Microsoft Word (.docx), lalu unggah file itu di sini. Google Docs juga punya opsi unduhan Markdown sendiri, yang cukup baik untuk dokumen sederhana.