Penukar DOCX ke Markdown
Untuk memindahkan dokumentasi daripada Word ke repositori Git, langkah pertama ialah menukar setiap .docx kepada Markdown. Penukar ini menghasilkan teks gaya CommonMark dengan tajuk #, jadual paip dan pautan gambar, sedia untuk di-commit.
Penukar Dokumen
atau seret Fail PDF, DOC, DOCX … ke sini ·
Maks 95 MB setiap fail· Sehingga 20 fail· Dipadam selepas 30 minit
Fail diproses pada pelayan kami dan dipadam selepas 30 minit.
150 DPI menjadikan halaman A4 kira-kira 1240 × 1754 px. Gunakan 300 untuk mencetak.
Tukar seluruh fail atau hanya sebahagian halaman atau slaid (input PDF dan persembahan).
Halaman atau slaid yang ingin ditukar, cth. 1-3, 5, 8-10.
UTF-8 sesuai untuk semua bahasa. Pilih UTF-8 dengan BOM jika Excel atau Notepad pada Windows memaparkan aksara yang bercelaru; pengekodan lama hanya untuk perisian lama.
LF untuk macOS, Linux dan editor kod; CRLF untuk program Windows lama seperti Notepad klasik.
Koma ialah standard. Gunakan koma bertitik untuk Excel di negara yang menulis perpuluhan dengan koma (Jerman, Perancis, Brazil).
Input Excel dengan beberapa helaian: tukar semuanya (satu bahagian atau fail setiap helaian) atau helaian pertama sahaja.
Cara menggunakan alat ini
- 1
Muat naik fail Word
Tambah sehingga 20 fail .docx atau .doc, setiap satu sehingga 95 MB. Terima atau tolak perubahan yang dijejak dalam Word dahulu, kerana Markdown tidak dapat memaparkannya.
- 2
Semak pilihan teks
Pemformatan ditetapkan pada Ringkas, Pengekodan teks pada UTF-8 dan Penamat baris pada LF, gabungan yang dijangka oleh Git dan penjana laman statik. Biarkan Sertakan imej dihidupkan untuk mendapatkan gambar dalam satu folder.
- 3
Tukar dan ekstrak
Tekan Tukar ke MD. Setiap dokumen diterima sebagai ZIP yang mengandungi fail .md dan imejnya; nyahzip ke dalam folder dokumentasi anda dan lakukan commit.
Bagaimanakah cara menukar dokumen Word ke Markdown?
Muat naik fail .docx dan tekan Tukar ke MD. Anda mendapat fail .md dengan tajuk #, senarai, pautan dan jadual, serta imej dalam folder di sebelahnya, semuanya dalam satu ZIP.
DOCX ke Markdown untuk docs-as-code
Pasukan menggunakan docs-as-code atas satu sebab: dokumentasi berada bersama kod, melalui pull request yang sama dan dikeluarkan bersama keluaran yang sama. Fail .docx menggagalkannya, kerana ia ialah ZIP yang mengandungi bahagian XML yang disimpan Git sebagai binari legap. Perubahan satu perkataan muncul sebagai fail yang berubah tanpa diff yang boleh dibaca, dan dua orang yang menyunting serentak tidak dapat menggabungkan kerja mereka.
Markdown ialah teks biasa, jadi setiap suntingan ialah perubahan baris yang kelihatan. Ia juga menjadi jauh lebih boleh diramal pada 2014, apabila John MacFarlane dan yang lain menerbitkan CommonMark, spesifikasi tepat bagi sintaks yang diterangkan Gruber secara longgar sepuluh tahun sebelumnya. GitHub mendasarkan spesifikasi GitHub Flavored Markdown miliknya pada CommonMark pada 2017, dengan menambah jadual paip, senarai tugas dan garis mansuh yang digunakan oleh kebanyakan README hari ini.
Jika kandungan anda menuju ke arah sebaliknya, iaitu Markdown dihantar kepada penyemak yang bekerja dalam Word, gunakan Markdown ke DOCX. Untuk laman web dan bukannya repositori, DOCX ke HTML mengekalkan lebih banyak gaya.
Rupa output Markdown
## Senarai semak keluaran Sebelum menanda keluaran, sahkan perkara berikut: - Ujian lulus pada **main** - Log perubahan menyenaraikan setiap PR yang digabungkan | Langkah | Pemilik | | --- | --- | | Bina | CI | | Terbit | Penyelenggara | 
Tempat Markdown yang ditukar akan dipaparkan
| Organisasi | Keperluan | Sumber |
|---|---|---|
| GitHub | Memaparkan README.md dan mana-mana fail .md dalam repositori menggunakan GitHub Flavored Markdown | github.com |
| Hugo | Membina halaman daripada fail kandungan .md dengan penghurai yang mematuhi CommonMark | gohugo.io |
| Jekyll | Menukar fail .md dengan front matter menjadi halaman; enjin di sebalik GitHub Pages | jekyllrb.com |
| Docusaurus | Membaca fail .md dan .mdx dalam folder docs sebagai halaman dokumentasi | docusaurus.io |
DOCX
Dokumen Microsoft Word
DOCX ialah format dokumen lalai Microsoft Word sejak Office 2007, berasaskan piawaian Office Open XML (ECMA-376, ISO/IEC 29500). Ia ialah pakej ZIP yang mengandungi fail XML untuk teks, gaya, imej, jadual, komen dan perubahan yang dijejaki. Ia format paling lazim untuk dokumen boleh edit di pejabat, sekolah dan permohonan kerja. Susun atur boleh berubah sedikit antara Word, Google Docs, LibreOffice dan Pages, terutamanya dengan pemformatan yang kompleks. Kebanyakan pemproses perkataan membuka fail DOCX.
- Pemampatan
- –
- Ketelusan
- –
- Animasi
- –
- Diperkenalkan
- 2007 · Microsoft
MD
Markdown
Markdown ialah sintaks penanda ringan yang dicipta oleh John Gruber pada 2004. Ia menggunakan simbol teks biasa, seperti # untuk tajuk, * untuk penekanan dan - untuk senarai, yang kekal boleh dibaca sebagai teks mentah dan ditukar dengan kemas kepada HTML. Ia ialah piawaian untuk fail README, dokumentasi, wiki, aplikasi nota dan banyak penjana laman statik. Terdapat beberapa dialek, seperti CommonMark dan GitHub Flavored Markdown, yang berbeza dalam perincian seperti jadual. Mana-mana penyunting teks boleh membuka fail .md.
- Pemampatan
- –
- Ketelusan
- –
- Animasi
- –
- Diperkenalkan
- 2004 · John Gruber
DOCX ditukar kepada Markdown apabila dokumen berpindah ke aliran kerja kod: README, laman dokumentasi atau pangkalan pengetahuan yang disimpan dalam Git, tempat teks biasa boleh dibandingkan perbezaannya, disemak dalam pull request dan dipaparkan oleh banyak alat.
Ciri Word yang tiada padanan dalam Markdown
Rancang perkara ini sebelum anda menukar
- Fon, warna dan reka letak halaman dibuang; Markdown menerangkan struktur, dan tema laman menentukan rupa
- Perubahan yang dijejak dan komen tidak dibawa bersama, jadi selesaikannya dalam Word dahulu
- Pengepala, pengaki dan nombor halaman tidak mempunyai tempat dalam fail .md
- Kotak teks dan imej berbalut menjadi perenggan biasa dan pautan imej
- Tajuk yang anda format secara manual, tebal 16 pt dan bukannya Heading 2, menjadi teks tebal, jadi gunakan gaya tajuk sebenar dahulu
- Garis bawah tidak mempunyai sintaks Markdown dan dibuang atau dikekalkan sebagai HTML
Soalan lazim DOCX ke Markdown
Varian Markdown manakah yang diikuti oleh output DOCX ke MD?
Tajuk, penekanan, senarai, pautan dan kod mengikut CommonMark, manakala jadual menggunakan sintaks paip daripada GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll dan Docusaurus semuanya memaparkan gabungan itu.
Apakah yang berlaku kepada sel jadual yang digabungkan?
Jadual paip Markdown tidak mempunyai sel yang digabungkan, jadi setiap kawasan gabungan dipecahkan semula kepada sel individu dengan teks dalam sel pertama. Bina semula jadual yang kompleks sebagai HTML di dalam fail .md, atau permudahkannya dalam Word sebelum menukar.
Ke manakah perginya gambar daripada dokumen Word saya?
Apabila Sertakan imej dihidupkan, setiap gambar disimpan sebagai fail berasingan dalam ZIP, dan Markdown memautkannya dengan laluan relatif seperti images/figure-1.png. Simpan folder itu bersebelahan fail .md apabila anda memindahkannya.
Adakah nota kaki Word dikekalkan dalam Markdown?
CommonMark tidak mempunyai sintaks nota kaki, tetapi GitHub menambah nota kaki [^1] pada 2021 dan kebanyakan penjana laman menyokongnya. Jika pemapar anda tidak menyokongnya, teks nota muncul sebagai perenggan biasa di hujung.
Bolehkah saya menukar Google Docs ke Markdown dengan cara ini?
Boleh. Dalam Google Docs pilih Fail > Muat turun > Microsoft Word (.docx), kemudian muat naik fail itu di sini. Google Docs juga menyediakan pilihan muat turun Markdown sendiri, yang sesuai untuk dokumen ringkas.
