Konversi Markdown ke PDF tanpa kehilangan dokumen
Markdown dibuat untuk layar yang bisa digulir. PDF memiliki halaman, dan halaman punya batas. Kebanyakan konverter mengabaikan perbedaan itu: mereka menyerahkan file ke browser, menekan cetak, lalu mengirimkan apa pun yang keluar. Itulah sebabnya tabel kehilangan empat kolom terakhirnya, judul terdampar di kaki halaman, dan logo di bagian atas README muncul sebagai baris HTML mentah yang tercetak sebagai teks. Konverter ini menata dokumen untuk kertas terlebih dahulu, lalu memberi tahu Anda apa saja yang perlu dilakukan untuk mencapainya.
Tabel yang tetap muat di kertas
Tabel Markdown tidak memiliki lebar kolom. Sintaksnya memang tidak menyediakan tempat untuk itu, jadi konverter yang langsung mengirimkan tabel ke browser hanya berharap tabelnya muat. Setiap tabel di sini diukur terlebih dahulu sebelum digambar dan disesuaikan dengan ukuran kertas yang Anda pilih. Tabel berisi path file dengan empat belas kolom tetap berada di dalam margin, nilai yang panjang akan dibungkus alih-alih keluar dari batas, dan hasilnya akan memberi tahu jika harus melakukan itu.
Bagian yang sering luput terjadi di halaman kedua. Tabel panjang biasanya meninggalkan baris header di halaman pertama, sehingga pembaca hanya melihat angka-angka tanpa label. Di sini, header diulang di setiap halaman yang memuat tabel, dan baris tidak pernah terpotong di tengah oleh pergantian halaman.
Kode yang tetap utuh di margin
Kode yang dibatasi pagar tetap mempertahankan highlight dan label bahasanya. Baris panjang akan dibungkus sehingga Anda bisa melihat bahwa baris itu dibungkus, bukan terpotong di tepi kertas. PDF tidak punya scrollbar, jadi baris yang tidak dibungkus berarti sisi kanannya hilang. Blok indentasi, pagar tanpa label bahasa, dan kode inline semuanya tetap tampil sebagaimana mestinya.
Gambar di README Anda
Logo dan deretan badge build hampir tidak pernah ditulis dalam Markdown. Tidak ada cara untuk memusatkan gambar di dalamnya, sehingga file README biasanya menggunakan HTML mentah. Konverter yang menolak merender HTML biasanya hanya menampilkannya sebagai teks, sehingga dokumen dibuka dengan deretan tag gambar yang tercetak sebagai teks. Di sini markup-nya dihapus dan gambar serta kata-kata di dalamnya tetap dipertahankan, sehingga bagian atas dokumen tetap terlihat seperti aslinya.
Gambar diambil dan disematkan ke dalam file, bukan hanya ditautkan, sehingga PDF tetap bisa digunakan secara offline dan tetap berfungsi setahun kemudian. Jika gambar tidak bisa diambil, hasilnya akan menghitung dan memberi tahu Anda, bukan diam-diam meninggalkan ruang kosong di tempat gambar seharusnya ada.
Judul Anda menjadi navigasi
Setiap PDF membawa pohon bookmark yang dibuat dari judul-judul Anda sendiri, sehingga dokumen panjang bisa dinavigasi dari sidebar, bukan hanya digulir. Jika Anda meminta halaman daftar isi, Anda akan mendapatkannya yang bisa diklik, pada tingkat judul mana pun yang Anda pilih. Satu judul di paling atas akan dibaca sebagai judul dokumen dan tidak dimasukkan ke daftar, seperti judul buku, bukan bab.
Catatan kaki tetap menjadi catatan kaki, dengan penanda naik dan tautan kembali ke baris yang sedang Anda baca. Daftar tugas tetap dengan kotaknya, baik yang dicentang maupun belum. Catatan, peringatan, dan tips tetap dengan bar warna mereka. Front matter di bagian atas file diperlakukan sebagai metadata dan tidak dicetak di halaman. Daftar definisi, coret, kutipan bersarang, dan tiga tingkat daftar bersarang semuanya tetap tampil sebagaimana mestinya.
Konverter memberi tahu apa yang tidak bisa dilakukan
Setiap konversi disertai ringkasan singkat: berapa halaman, arah teks, jumlah tabel, jumlah blok kode, berapa gambar yang disematkan dan berapa yang gagal diambil. Jika ada karakter yang hilang di font, karakternya akan dicantumkan. Jika Anda meminta halaman daftar isi tapi dokumen tidak punya judul untuk dimasukkan, hasilnya akan memberi tahu Anda, bukan hanya memberikan file dengan halaman kosong di depan. Konverter yang menyembunyikan kegagalannya sendiri adalah alasan orang berhenti mempercayai konverter.
Script yang bukan Latin
Font dibawa di dalam PDF, jadi dokumen akan terbuka sama di perangkat mana pun meski font-nya tidak terpasang. Teks kanan-ke-kiri dinilai per blok, bukan sekali untuk seluruh file, karena dokumen teknis dengan script seperti itu sering kali setengahnya Latin, penuh path file dan nama kelas, tapi tetap dibaca dari kanan ke kiri. Kode berpagar tidak terpengaruh dan selalu diatur dari kiri ke kanan, dan tata letak lainnya dicerminkan dengan benar: bullet, garis kutipan, dan kolom tabel semuanya ikut berpindah. Jika script tidak punya italic, penekanan diberikan dengan ketebalan, bukan memiringkan huruf yang memang tidak didesain miring.
Apa yang tidak dilakukan
LaTeX tidak dirender. Blok di antara tanda dolar akan dicetak sebagai teks apa adanya. Mermaid juga tidak digambar: pagar dengan label mermaid akan keluar sebagai blok kode berlabel, bukan diagram. Karakter Tionghoa, Jepang, dan Korea di luar font yang dibawa alat ini, jadi karakter dalam script tersebut akan dilaporkan hilang, bukan ditebak. Ini adalah batasan, bukan kekurangan, dan ditulis di sini agar tidak ada yang baru mengetahuinya setelah mengunggah.
Bagian praktis
Unggah dari perangkat Anda, dari Google Drive, atau tempel tautan ke file. File Markdown diterima dengan ekstensi apa pun yang umum, begitu juga teks biasa. Kertas bisa A3, A4, A5, Letter, Legal, atau Tabloid, potret atau lanskap, dengan margin sempit, normal, atau lebar. Penomoran halaman dan highlight sintaks aktif kecuali Anda mematikannya. Kirim satu file, PDF akan kembali; kirim beberapa, akan dikirim sebagai ZIP, atau satu PDF gabungan dengan penomoran halaman berlanjut jika Anda memilih opsi itu. Teks tetap sebagai teks asli, sehingga bisa dipilih, dicari, dan disalin, bukan hanya menjadi gambar kata-kata.
Apa yang Anda dapatkan
- Tabel yang tetap di dalam margin, dengan baris header diulang di setiap halaman
- Kode dengan highlight sintaks dan baris panjang dibungkus, bukan terpotong
- Gambar disematkan di dalam file, termasuk yang ditulis dengan HTML mentah
- Pohon bookmark dari judul Anda, dan halaman daftar isi yang bisa diklik jika Anda menginginkannya
- Font dibawa di dalam PDF, sehingga file tampil sama di setiap perangkat yang membukanya
- Ringkasan tertulis tentang apa pun yang tidak bisa dilakukan konverter, termasuk glyph dan gambar yang hilang
Selanjutnya?
Bekerja dari file Word? Word ke PDF mengambil jalur yang sama ke kertas. Gabungkan hasilnya dengan laporan lain menggunakan Gabung PDF. Lalu perkecil ukuran file sebelum Anda kirim dengan Kompres PDF.