Konverter online gratis ASCIIDOC ke DOCX

Apa itu format ASCIIDOC

AsciiDoc adalah format markup teks biasa untuk dokumen terstruktur seperti manual perangkat lunak, catatan rilis, buku, spesifikasi, dan file README. File biasanya menggunakan ekstensi .adoc atau .asciidoc dan dapat dibuat dengan editor teks apa pun, IDE, atau sistem dokumentasi yang didasarkan pada Asciidoctor.

AsciiDoc menyimpan judul, daftar, tabel, tautan, blok kode sumber, gambar, admonition, atribut, dan referensi silang sebagai teks yang mudah dibaca. Asciidoctor adalah converter yang paling banyak digunakan dan dapat menghasilkan HTML, DocBook, PDF melalui alat tambahan, serta format output lainnya.

Apa itu format DOCX

DOCX adalah format dokumen berbasis XML yang digunakan oleh Microsoft Word dan didukung oleh LibreOffice Writer, OnlyOffice, serta aplikasi Office lainnya. Format ini cocok untuk alur kerja pengolah kata yang memerlukan paragraf yang dapat diedit, style, tabel, komentar, perubahan terlacak, header, footer, dan pencetakan berorientasi halaman.

DOCX lebih disarankan ketika penerima perlu merevisi dokumen secara visual, menerapkan template Word, menambahkan komentar ulasan, atau mengirimkan file ke sistem yang tidak menerima markup teks biasa. Tidak seperti AsciiDoc, DOCX tidak mempertahankan markup sumber sebagai antarmuka pengeditan utama.

Cara sebenarnya mengonversi ASCIIDOC ke DOCX

Menggunakan Asciidoctor dan Pandoc

Metode desktop yang paling mudah dikendalikan adalah merender AsciiDoc sebagai DocBook dengan Asciidoctor, lalu mengonversi file DocBook tersebut ke DOCX dengan Pandoc.

1. Instal Asciidoctor dan Pandoc. Setelah Ruby terinstal, Asciidoctor dapat diinstal menggunakan gem install asciidoctor. Instal Pandoc dari paket desktop resminya untuk sistem operasi Anda.
2. Buka terminal di direktori yang berisi file sumber dan buat DocBook 5:

asciidoctor -b docbook5 -o manual.xml manual.adoc

3. Konversikan file perantara ke DOCX:

pandoc manual.xml -o manual.docx

4. Buka manual.docx di Word atau LibreOffice Writer dan periksa judul, tabel, gambar, blok kode, pemisah halaman, serta tautan sebelum mendistribusikannya.

Untuk menggunakan template Word, berikan DOCX referensi yang berisi style yang diinginkan:

pandoc manual.xml --reference-doc=company-template.docx -o manual.docx

Pastikan gambar tersedia di path relatif yang digunakan oleh sumber AsciiDoc. Jika sumber menggunakan atribut atau include, jalankan Asciidoctor dari direktori proyek agar file tersebut dapat ditemukan. Dokumen dengan beberapa file sumber dapat terlebih dahulu dirakit menggunakan direktif include::, lalu diproses menggunakan perintah yang sama.

Menggunakan converter online

Anda dapat mengonversi file secara gratis di 101convert.com tanpa menginstal perangkat lunak: unggah file ASCIIDOC, pilih DOCX sebagai format output, mulai konversi, lalu unduh dokumen yang dihasilkan. Tinjau hasilnya setelah mengunduh, terutama jika sumber berisi gambar lokal, include, ekstensi Asciidoctor kustom, atau diagram.

Keterbatasan kualitas dan kompatibilitas

Langkah DocBook perantara mempertahankan struktur dokumen standar dengan lebih baik daripada menyalin HTML yang telah dirender ke Word, tetapi tidak dapat mereproduksi setiap fitur Asciidoctor. Ekstensi kustom, blok passthrough, konten kondisional, logika atribut yang kompleks, pemroses diagram, style admonition khusus, dan beberapa macro dapat dihilangkan atau dikonversi menjadi teks biasa.

DOCX menggunakan tata letak halaman dan style Word, sedangkan AsciiDoc terutama mendeskripsikan struktur semantik. Bersiaplah untuk menyesuaikan margin, font, lebar tabel, syntax highlighting, ukuran gambar, caption, header, footer, dan pemisah halaman pada DOCX yang dihasilkan. Blok kode sumber dan tabel perlu diperiksa secara khusus karena baris yang panjang dan kolom yang lebar dapat melampaui halaman.

Tautan dan judul dasar umumnya dikonversi dengan baik. Referensi silang, catatan kaki, media tersemat, dan path gambar relatif bergantung pada versi Asciidoctor dan Pandoc serta cara sumber diatur. Simpan file .adoc asli sebagai sumber utama jika dokumen akan terus dipelihara.