Konverter online gratis AD ke MD

Markdown umumnya diperlukan untuk file README, repositori Git, situs dokumentasi, dan pengeditan ringan, sementara beberapa dokumen sumber tersedia sebagai file AsciiDoc dengan ekstensi .ad yang lebih singkat. Mengonversi sumber akan mempertahankan kontennya yang mudah dibaca sekaligus menyesuaikan heading, daftar, tautan, blok kode, dan tabel ke sintaks Markdown.

Apa itu format AD

Dalam kategori file Text, .ad umumnya mengidentifikasi file sumber AsciiDoc. AsciiDoc adalah bahasa markup plain-text untuk dokumentasi teknis, buku, manual, file README, dan halaman web; bahasa yang sama lebih sering disimpan dengan .adoc atau .asciidoc.

File AsciiDoc dapat dibuat dengan prosesor AsciiDoc asli, Asciidoctor, editor teks, dan sistem build dokumentasi. File tersebut berisi markup sumber yang mudah dibaca seperti judul bagian, daftar, tautan, blok source code, admonition, tabel, atribut, dan direktif include. Ekstensi saja tidak dapat dijadikan penentu, jadi pastikan file tersebut berisi sintaks AsciiDoc sebelum mengonversinya.

Apa itu format MD

.md mengidentifikasi file Markdown. Markdown menggunakan karakter plain-text untuk heading, penekanan, tautan, daftar, kutipan, blok kode, dan struktur dokumen lainnya. GitHub, GitLab, static-site generator, aplikasi pencatatan, platform dokumentasi, dan code editor umumnya merender Markdown.

Markdown berguna ketika dokumen harus tetap mudah dibaca tanpa renderer, bekerja dengan baik dalam version control, atau diterima sebagai README atau sumber dokumentasi. GitHub Flavored Markdown, yang umumnya disebut GFM, menambahkan tabel, task list, strikethrough, dan fenced code block.

Cara benar-benar mengonversi AD ke MD

Menggunakan Asciidoctor dan Pandoc

Untuk konversi yang andal, gunakan Asciidoctor untuk menginterpretasikan sumber AsciiDoc dan menghasilkan DocBook XML, lalu gunakan Pandoc untuk mengonversi file intermediate terstruktur tersebut ke GFM Markdown. Instal Asciidoctor dan Pandoc, tempatkan sumber di working directory, lalu jalankan:

1. Konversikan file AsciiDoc ke DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Konversikan XML ke Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Buka output.md di editor Markdown dan periksa heading, tautan, tabel, gambar, daftar, serta blok kode.

Untuk pipeline shell satu langkah, gunakan:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Menggunakan online converter bawaan

Anda dapat mengonversi file secara gratis di 101convert.com tanpa menginstal software: pilih format input AD, unggah input.ad, pilih MD sebagai format output, mulai konversi, lalu unduh file .md yang dihasilkan.

Keterbatasan kualitas dan kompatibilitas

Konversi mengubah markup, bukan sekadar mengganti nama ekstensi. Atribut AsciiDoc, konten kondisional, macro, cross-reference, diagram yang disematkan, serta struktur tabel atau admonition yang kompleks mungkin memerlukan pengeditan manual setelah konversi.

Gunakan path yang tetap valid dari lokasi file Markdown. Referensi gambar mungkin perlu diperbaiki, dan role atau atribut khusus AsciiDoc dapat dihapus karena Markdown standar tidak memiliki padanan. Output GFM biasanya merupakan target yang paling kompatibel untuk GitHub dan GitLab, sedangkan basic Markdown lebih sesuai ketika tujuan hanya mendukung sintaks asli.

Direktif include dan substitusi source AsciiDoc dapat memengaruhi hasil yang dihasilkan. Tinjau output setelah preprocessing, terutama ketika sumber menggunakan file eksternal, atribut khusus, atau path gambar relatif.