Dalam artikel ini kita melihat penukaran antara Markdown [1] dan DOCX - format dokumen asli Microsoft Word yang digunakan sejak 2007. Anda mungkin tertanya-tanya mengapa peminat Markdown dan Asciidoc (seperti saya) menangani kes ini. Baiklah, berkolaborasi dengan sekumpulan penulis lain boleh menyebabkan keadaan sedangkan satu atau lebih peserta meminta DOCX sebagai format output. Jangan biarkan sesiapa pun kecewa, dan cari batasan mana yang ada, dan bagaimana kita boleh mencuba membahagiakan semua ahli kumpulan.
Apa itu Markdown?
Seperti yang telah ditunjukkan dalam "Pengantar Markdown" [2], niat untuk Markdown adalah teks sederhana untuk penukaran HTML. Idea di sebalik itu adalah menjadikan menulis laman web, dokumentasi dan terutama entri blog semudah menulis e-mel. Mulai hari ini, ini adalah de facto-sinonim untuk kelas bahasa deskripsi markup ringan, dan tujuannya dapat dilihat sebagai tercapai.
Markdown menggunakan sintaks pemformatan teks biasa. Dengan pendekatan yang serupa dengan HTML sebilangan penanda menunjukkan tajuk utama, senarai, gambar, dan rujukan dalam teks anda. Beberapa baris di bawah menggambarkan dokumen asas yang mengandungi dua tajuk utama (tahap 1 dan 2) serta dua perenggan, dan persekitaran senarai.
## Perancis
Ini adalah pilihan tempat:
* Paris (_Ile de France_)
* Strasbourg (_Alsace_)
Untuk rancangan lawatan yang betul kira-kira seminggu.
Penukaran ke DOCX
Untuk menukar dokumen Markdown anda ke DOCX, gunakan pandoc alat [3]. Pandoc adalah perpustakaan Haskell, dan menggambarkan dirinya sebagai "penukar dokumen sejagat", atau "pisau tentera Swiss untuk penukaran dokumen". Ini tersedia untuk pelbagai platform seperti Linux, Microsoft Windows, Mac OS X, dan BSD. Pandoc biasanya disertakan sebagai paket untuk distribusi Linux seperti Debian GNU / Linux, Ubuntu, dan CentOS.
Panggilan mudah untuk penukaran adalah seperti berikut:
ujian $ pandoc -o.ujian docx.mdParameter pertama '-o' merujuk kepada fail output, diikuti dengan nama file ('test.docx '). Sambungan fail membantu pandoc mengenal pasti format output yang diinginkan. Parameter kedua menamakan fail input - dalam kes ini, ia hanyalah 'ujian.md '.
Versi panjang arahan yang ditunjukkan di atas mengandungi dua parameter '-f markdown' dan '-t docx'. Yang pertama menyingkat istilah 'rasa', dan menerangkan format fail input. Yang kedua melakukan perkara yang sama untuk fail output, dan menyingkat '-to'.
Perintah penuh adalah seperti berikut:
ujian $ pandoc -o.docx -f markdown -t docx test.mdMembuka fail yang ditukar menggunakan Microsoft Word menghasilkan output berikut:
Untuk elemen teks yang berbeza Pandoc menggunakan lembaran gaya. Ini membolehkan anda menyesuaikan elemen-elemen ini kemudian mengikut keperluan anda di seluruh dokumen. Versi Pandoc yang lebih baru juga menawarkan sebaliknya - anda boleh menukar fail DOCX menjadi Markdown seperti berikut:
ujian $ pandoc -o.ujian md.docxKemudian, fail yang dihasilkan mempunyai kandungan berikut:
Tempat yang Disyorkan untuk Melawati Di Eropah=====================================
Perancis
------
Ini adalah pilihan tempat:
- Paris (* Ile de France *)
- Strasbourg (* Alsace *)
Untuk rancangan lawatan yang betul kira-kira seminggu.
Pilihan Baris Perintah Berguna
Senarai pilihan Pandoc agak panjang. Berikut ini membantu anda menghasilkan hasil yang lebih baik, dan menjadikan hidup anda lebih mudah:
* '-P' (versi panjang '-preserve-tab'): Memelihara tab dan bukannya menukarnya ke ruang. Ini berguna untuk blok kod dengan garis lekukan yang merupakan sebahagian daripada teks anda.
* '-S' (versi panjang '-smart'): Menghasilkan output yang betul secara tipografi.
Pilihan ini membetulkan tanda petikan, tanda hubung / tanda hubung dan juga elips (“…”). Tambahan, ruang tidak pecah ditambahkan setelah singkatan tertentu seperti “Mr.".
* '-track-perubahan = nilai': Menentukan apa yang harus dilakukan dengan sisipan, penghapusan, dan komen yang dihasilkan dengan bantuan ciri Microsoft Word "Track Changes". Nilainya boleh diterima, ditolak, atau semuanya untuk memasukkan atau menghapus perubahan yang dibuat dalam dokumen. Hasilnya adalah fail rata.
Untuk lebih banyak pilihan, lihat dokumentasi dan halaman manual Pandoc.
Ringkasan
Penukaran antara Markdown dan DOCX bukan lagi misteri. Ia dilakukan dalam beberapa langkah, dan berfungsi dengan baik. Selamat menggodam 🙂
Pautan dan Rujukan
* [1] Penurunan Nilai
* [2] Frank Hofmann: Pengantar Markdown
* [3] Pandoc
Ucapan terima kasih
Penulis ingin mengucapkan terima kasih kepada Annette Kalbow atas bantuannya semasa menyiapkan artikel.