Pada artikel ini kita melihat konversi antara Markdown [1] dan DOCX - format dokumen asli Microsoft Word yang digunakan sejak 2007. Anda mungkin bertanya-tanya mengapa penggemar Markdown dan Asciidoc (seperti saya) menangani kasus ini. Nah, berkolaborasi dengan sekelompok penulis lain dapat menyebabkan situasi dimana satu atau lebih peserta meminta DOCX sebagai format output. Jangan mengecewakan siapa pun, dan cari tahu batasan mana yang ada, sebagai gantinya, dan bagaimana kita bisa mencoba membuat semua anggota grup bahagia.
Apa itu penurunan harga??
Seperti yang telah ditunjukkan dalam “Pengantar Penurunan Harga” [2], maksud penurunan harga adalah konversi teks ke HTML sederhana. Ide di baliknya adalah membuat penulisan halaman web, dokumentasi, dan terutama entri blog semudah menulis email. Sampai hari ini adalah sinonim de facto untuk kelas bahasa deskripsi markup ringan, dan tujuannya dapat dilihat telah tercapai.
Penurunan harga menggunakan sintaks pemformatan teks biasa. Dengan pendekatan serupa seperti HTML, sejumlah penanda menunjukkan judul, daftar, gambar, dan referensi dalam teks Anda. Beberapa baris di bawah ini menggambarkan dokumen dasar yang berisi dua judul (tingkat 1 dan 2) serta dua paragraf, dan lingkungan daftar.
## Prancis
Ini adalah pilihan tempat:
* Paris (_Ile de France_)
* Strasbourg (_Alsace_)
Untuk rencana kunjungan yang tepat sekitar seminggu.
Konversi ke DOCX
Untuk mengonversi dokumen Markdown Anda ke DOCX, gunakan alat pandoc [3]. Pandoc adalah perpustakaan Haskell, dan menggambarkan dirinya sebagai "konverter dokumen universal", atau "pisau tentara Swiss untuk konversi dokumen". Ini tersedia untuk berbagai 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 sederhana untuk konversi adalah sebagai berikut:
$ pandoc -o tes.tes docx.mdParameter pertama '-o' mengacu pada file output, diikuti dengan nama file ('test.dok'). Ekstensi file membantu pandoc untuk mengidentifikasi format output yang diinginkan. Parameter kedua menamai file input - dalam kasus kami ini hanyalah 'test.md'.
Versi panjang dari perintah yang ditunjukkan di atas berisi dua parameter '-f markdown' dan '-t docx'. Yang pertama menyingkat istilah 'rasa', dan menjelaskan format file input. Yang kedua melakukan hal yang sama untuk file output, dan menyingkat '-to'.
Perintah lengkapnya adalah sebagai berikut:
$ pandoc -o tes.docx -f penurunan harga -t tes docx.mdMembuka file yang dikonversi menggunakan Microsoft Word menghasilkan output berikut:
Untuk elemen teks yang berbeda, Pandoc menggunakan lembar gaya. Ini memungkinkan Anda untuk menyesuaikan elemen-elemen ini nanti sesuai dengan kebutuhan Anda di seluruh dokumen. Versi Pandoc yang lebih baru juga menawarkan sebaliknya - Anda dapat mengonversi file DOCX menjadi penurunan harga sebagai berikut:
$ pandoc -o tes.tes md.dokKemudian, file yang dihasilkan memiliki konten berikut:
Rekomendasi Tempat Untuk Dikunjungi Di Eropa=======================================
Perancis
------
Ini adalah pilihan tempat:
- Paris (*Ile de Prancis*)
- Strasbourg (*Alsace*)
Untuk rencana kunjungan yang tepat sekitar seminggu.
Opsi Baris Perintah yang Berguna
Daftar opsi Pandoc agak panjang. Yang berikut ini membantu Anda menghasilkan hasil yang lebih baik, dan membuat hidup Anda lebih mudah:
* '-P' (versi panjang '-preserve-tabs'): Pertahankan tab alih-alih mengubahnya menjadi spasi. Ini berguna untuk blok kode dengan baris indentasi yang merupakan bagian dari teks Anda.
* '-S' (versi panjang '-smart'): Menghasilkan output yang benar secara tipografis.
Opsi ini mengoreksi tanda kutip, tanda hubung/tanda hubung, serta elips (“… ”). Tambahan, spasi non-breaking ditambahkan setelah singkatan tertentu seperti “Mr.”.
* '-track-changes=value': Menentukan apa yang harus dilakukan dengan penyisipan, penghapusan, dan komentar yang dihasilkan dengan bantuan fitur "Lacak Perubahan" Microsoft Word. Nilainya dapat berupa menerima, menolak, atau semua untuk menyertakan atau menghapus perubahan yang dibuat dalam dokumen. Hasilnya adalah file datar.
Untuk opsi lebih lanjut, lihat dokumentasi, dan halaman manual Pandoc.
Ringkasan
Konversi antara Markdown dan DOCX bukan lagi misteri. Itu dilakukan dalam beberapa langkah, dan bekerja dengan sangat baik. Selamat meretas
Tautan dan Referensi
* [1] Penurunan harga
* [2] Frank Hofmann: Pengantar Penurunan Harga
* [3] Pandoc
Ucapan Terima Kasih
Penulis ingin mengucapkan terima kasih kepada Annette Kalbow atas bantuannya saat menyiapkan artikel.