UltKit

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

Keluaran

File diproses di server kami dan dihapus setelah 30 menit.

Cara menggunakan alat ini

  1. 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. 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. 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.

Jawaban

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

Satu bagian Word berisi heading, daftar, dan tabel, setelah dikonversi
## 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 |

![Alur rilis](images/figure-1.png)

Tempat Markdown hasil konversi akan ditampilkan

Platform yang langsung membaca file Markdown
OrganisasiPersyaratanSumber
GitHubMenampilkan README.md dan file .md apa pun di repositori dengan GitHub Flavored Markdowngithub.com
HugoMembangun halaman dari file konten .md dengan parser yang sesuai CommonMarkgohugo.io
JekyllMengubah file .md yang memiliki front matter menjadi halaman; mesin di balik GitHub Pagesjekyllrb.com
DocusaurusMembaca file .md dan .mdx di folder docs sebagai halaman dokumentasidocusaurus.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
Konverter DOCX

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
Konverter MD

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.