Konverter online gratis ADOC ke PNG

Format sumber

ADOC adalah file sumber AsciiDoc, format dokumen teks biasa yang digunakan untuk menulis dokumentasi teknis, buku, manual, file README, dan konten terstruktur lainnya. Format ini populer di kalangan pengembang, penulis teknis, dan tim dokumentasi karena mendukung heading, daftar, tabel, blok kode, referensi silang, dan fitur dokumen kaya lainnya sekaligus tetap mudah diedit di editor teks apa pun.

Karena ADOC adalah format sumber markup, format ini tidak dimaksudkan untuk dilihat langsung sebagai dokumen visual final. Untuk mengubahnya menjadi gambar, kontennya biasanya dirender terlebih dahulu ke format berbasis halaman seperti PDF atau SVG, lalu dikonversi menjadi PNG.

Format target

PNG adalah format gambar raster yang sangat didukung dan menggunakan kompresi tanpa kehilangan (lossless). PNG umum digunakan untuk screenshot, diagram, grafis web, dan gambar yang memerlukan teks yang tajam atau latar belakang transparan. PNG adalah target yang baik ketika Anda membutuhkan gambar statis dari satu halaman dokumen atau cuplikan teks yang sudah dirender dengan format.

Keunggulan utama PNG adalah kualitas tanpa kehilangan (lossless), kompatibilitas yang luas, dan dukungan untuk transparansi. Untuk konversi dokumen, PNG sangat berguna ketika Anda ingin mendapatkan snapshot visual yang setia dari konten AsciiDoc yang sudah dirender.

Cara melakukan konversi

Cara paling andal untuk mengonversi .adoc menjadi .png adalah merender file AsciiDoc menjadi PDF terlebih dahulu, lalu mengekspor halaman PDF tersebut sebagai gambar PNG. Ini mempertahankan tata letak dan format dengan lebih baik daripada mencoba merasterkan sumber secara langsung.

1. Render file ADOC ke PDF. Jika Anda menggunakan Asciidoctor, instal dan jalankan perintah seperti asciidoctor -o output.pdf input.adoc. Bergantung pada pengaturan Anda, Anda mungkin perlu backend PDF seperti Asciidoctor PDF atau toolchain yang dapat menghasilkan output PDF dari AsciiDoc.

2. Konversi PDF ke PNG. Gunakan tool desktop seperti ImageMagick, utilitas Poppler, atau aplikasi grafis yang dapat mengekspor halaman PDF sebagai gambar. Misalnya, dengan ImageMagick Anda dapat menjalankan magick -density 200 output.pdf output.png. Nilai density yang lebih tinggi menghasilkan teks yang lebih tajam tetapi ukuran file lebih besar.

3. Periksa hasilnya. Buka PNG dan verifikasi ukuran halaman, ketajaman teks, serta margin terlihat benar. Jika gambar terlihat buram, tingkatkan density saat merender atau ekspor dengan resolusi yang lebih tinggi.

Jika Anda lebih menyukai alur kerja yang grafis, buka PDF yang sudah dirender di penampil atau editor desktop, lalu gunakan fungsi ekspornya untuk menyimpan halaman sebagai PNG. Di banyak editor, opsi ini biasanya ditemukan di File → Export atau File → Save As, tergantung aplikasinya.

Anda juga dapat mengonversi file di 101convert.com secara gratis, tanpa menginstal perangkat lunak apa pun.

Catatan tentang kualitas dan keterbatasan

ADOC ke PNG adalah konversi dokumen menjadi gambar, sehingga hasilnya berupa gambar raster dengan resolusi tetap. Artinya, teks tidak lagi dapat dipilih, dicari, atau diedit sebagai teks. Jika dokumen sumber panjang, setiap halaman biasanya menjadi gambar PNG terpisah kecuali Anda sengaja menggabungkan beberapa halaman menjadi satu gambar.

Kualitas sangat bergantung pada langkah perenderan. Ekspor dengan resolusi rendah dapat membuat font kecil terlihat lembut atau bergerigi, sedangkan ekspor resolusi lebih tinggi meningkatkan kejernihan dengan biaya ukuran file yang lebih besar. Perlu juga dicatat bahwa fitur AsciiDoc yang kompleks seperti font, diagram, dan gambar yang disematkan dapat dirender secara berbeda tergantung pada prosesor AsciiDoc dan toolchain PDF/gambar yang digunakan.

Untuk kompatibilitas terbaik, gunakan prosesor AsciiDoc modern seperti Asciidoctor dan tool PDF-ke-gambar yang didukung dengan baik. Jika Anda membutuhkan hasil yang dapat diskalakan (scalable) alih-alih gambar raster, pertimbangkan untuk mengekspor ke SVG atau PDF daripada PNG.