Ubah Markdown ke PDF

Markdown yang mana, dan menjadi apa

Markdown adalah satu keluarga, bukan satu spesifikasi tunggal. Intinya — judul, penekanan, daftar, link, gambar, blok kutipan, blok kode — sama di mana-mana, dan di luar itu setiap implementasi berbeda. Yang didukung di sini adalah set tambahan yang disepakati luas: tabel, blok kode berpagar dengan syntax highlighting, task list, coret, catatan kaki, dan front matter. Itu mencakup apa yang ditulis hampir semua orang, dan lebih baik mengetahui batasnya daripada menemukannya sendiri.

Judul menjadi struktur PDF sungguhan, bukan sekadar teks yang lebih besar: judul membawa level outline, sehingga PDF mendapat sidebar bookmark yang bisa dinavigasi. Link menjadi anotasi link yang berfungsi. Blok kode diset dengan huruf monospace dan highlight, yang membedakan dokumen yang nyaman dibaca dari tembok abu-abu. Ukuran halaman dan margin dipilih untuk kenyamanan membaca, bukan diwarisi, karena file Markdown tidak punya pendapat soal kertas.

Gambar harus bisa dijangkau, dan inilah kekecewaan yang paling umum. File Markdown merujuk gambar, bukan memuatnya, jadi path relatif hanya bisa ditemukan jika gambarnya diletakkan bersama file, dan alamat web hanya bisa diambil jika server-nya mengizinkan situs lain mengambilnya. Gambar yang tidak ditemukan diberi label di PDF, bukan meninggalkan ruang kosong tanpa kabar, sehingga diagram yang hilang terlihat, bukan baru Anda sadari setelah dokumen dikirim.

Dua hal sengaja ditampilkan sebagai kode, bukan dirender. Rumus matematika dalam notasi LaTeX dan diagram Mermaid masing-masing butuh renderer sendiri, dan merendernya secara keliru lebih buruk daripada menampilkan sumbernya — persamaan yang salah render keliru dengan cara yang tidak bisa dilihat siapa pun. HTML mentah di dalam Markdown ditangani untuk format inline sederhana, bukan untuk tata letak, karena blok markup sembarangan tidak punya tempat di dokumen berhalaman.

Jika Anda butuh hal lain

Pandoc adalah alat serius untuk ini, dan gratis. pandoc doc.md -o doc.pdf --pdf-engine=xelatex menata huruf melalui LaTeX, yang menghasilkan output yang benar-benar indah dengan pemenggalan kata yang tepat, kontrol baris yatim, dan daftar isi sungguhan — dan dengan template, Anda mengendalikan setiap aspek desain. Pandoc juga merender matematika LaTeX dengan benar, yang justru menjadi kekurangan di sini. Harganya adalah menginstal distribusi TeX, yang tidak kecil.

Untuk dokumentasi alih-alih dokumen sekali pakai, static site generator atau mdBook menghasilkan sesuatu yang lebih baik daripada PDF: bisa dicari, bisa ditautkan, dan nyaman dibaca di ponsel. Ubah ke PDF saat dokumen harus dicetak, dilampirkan, atau diarsipkan — dan tetap jadikan Markdown sebagai sumber utamanya, karena itulah versi yang bisa diedit dan di-diff.