Markdown ke PDF
Ubah berkas .md menjadi PDF, dengan judulnya tetap menjadi daftar isi.
Alat ini berjalan sepenuhnya di browser Anda. Berkas Anda tidak pernah diunggah, dan Anda bisa membuktikannya sendiri di tab jaringan browser. Buktikan sendiri: buka tab jaringan di browser Anda dan perhatikan. Anda akan melihat satu permintaan kecil yang menanyakan sisa jatah - nama alat dan sebuah hash, bukan berkasnya.
Apa yang dilakukan alat ini
Alat ini membaca berkas Markdown lalu menatanya langsung menjadi PDF, tanpa mampir ke HTML di tengah jalan. Judul, daftar, tabel, kutipan, tautan, dan blok kode berpagar semuanya ikut terbawa, dan judulnya sekaligus menjadi daftar isi PDF yang sungguhan. Markdown sendiri tidak mengenal halaman, jadi pemenggalan halaman di sini diciptakan, bukan disalin dari mana pun - ukuran kertas, margin, dan tema yang Anda pilih itulah yang menentukan di mana batas halaman jatuh.
Pakai ketika pembacanya tidak punya aplikasi Markdown: README yang harus masuk ke berkas tender, catatan rapat yang diminta dalam bentuk lampiran, spesifikasi yang sedang diedarkan untuk dikomentari, atau dokumentasi yang ingin Anda cetak lengkap dengan daftar isi yang benar-benar bekerja.
Cara kerjanya
- Jatuhkan berkas .md atau .markdown Anda ke halaman ini. Sampai 20 sekaligus, masing-masing sampai 50 MB.
- Pilih tema. Plain memakai 11 poin dengan jarak baris 1,45; Book melonggarkannya ke 11,5 poin dan 1,6 untuk bacaan yang ditelan dari awal sampai akhir; Technical merapatkannya ke 10 poin dan 1,35 untuk bahan rujukan yang lebih sering dipindai mata daripada dibaca.
- Tentukan ukuran halaman, orientasi, dan margin. Margin normal adalah 56 poin di tiap sisi.
- Biarkan bookmark dari judul tetap aktif supaya PDF-nya terbuka dengan panel navigasi yang berfungsi, dan matikan nomor halaman kalau dokumennya sudah menomori dirinya sendiri.
- Di opsi lanjutan, putuskan apakah blok front matter YAML di kepala berkas dipakai sebagai judul dokumen.
- Tekan Ubah. Tiap berkas menjadi PDF-nya sendiri dan unduhannya berjalan sendiri.
Markdown-nya diurai menjadi deretan token lalu dijalankan langsung ke model dokumen, tidak pernah dirender dulu menjadi HTML. Kedengarannya seperti urusan dapur, padahal bukan: rute Markdown ke HTML lalu ke PDF meloloskan isi lewat dua lapis pelolosan karakter, dan tiap kekeliruan kecil di perjalanan bolak-balik itu muncul belakangan sebagai ampersand nyasar atau tag ganti baris yang terbaca di dokumen jadi seseorang. Karena langsung ke model, teks yang Anda tulis persis itu pula yang diukur dan digambar.
Judul menjadi daftar isi PDF, dan justru itu yang membuat dokumen Markdown panjang layak dibaca sebagai PDF. Spesifikasi empat puluh halaman tanpa daftar isi hanyalah batang gulir dan tidak lebih. Satu pagar sampai enam pagar menjadi entri daftar isi pada kedalaman yang sesuai, jadi struktur yang sudah ada di berkas Anda langsung menjadi navigasi bagi pembaca, tanpa langkah tambahan dan tanpa ada yang perlu dijaga terpisah.
Perluasan ala GitHub dinyalakan, jadi tabel, teks coret, daftar centang, dan URL telanjang berperilaku seperti di GitHub, bukan tertinggal sebagai tanda baca mentah. Blok kode berpagar disusun dengan Noto Sans Mono pada 92 persen ukuran teks isi, di atas latar bernada tipis, dan blok yang lebih panjang daripada sisa halaman dipotong lintas halaman dengan latarnya digambar ulang, bukan didorong utuh ke lembar berikutnya. Baris kode yang kepanjangan dilipat, sambungannya ditakik sejajar dengan baris asalnya, dan titik lipatnya diutamakan di spasi supaya sebuah nama variabel tidak terbelah dua.
Gambar yang dirujuk oleh Markdown tidak ikut ditanam, dan blok HTML mentah tidak dirender. Berkas Markdown menunjuk gambarnya lewat path atau alamat web alih-alih memuatnya, dan pergi mengambil gambar itu persis merupakan permintaan keluar yang justru tidak ingin dilakukan alat ini. Ubah gambarnya terpisah dengan Gambar ke PDF, lalu satukan hasilnya memakai Gabungkan PDF kalau keduanya memang harus berada dalam satu dokumen.
Tema Book meminta muka huruf berkait, dan ada baiknya Anda tahu apa yang sebenarnya Anda dapat. Dengan Tanam font Unicode menyala, yang merupakan bawaannya, tidak ada Noto Serif di dalam kumpulan yang ditanam, jadi permintaan berkait itu meminjam muka huruf tak berkait. Yang benar-benar Anda peroleh adalah jarak baris yang lebih longgar dan ukuran huruf yang lebih besar. Matikan penanaman font dan teksnya sungguh disusun dengan Times Roman, dengan ongkos berupa setiap karakter di luar jangkauan WinAnsi.
Yang tidak bisa dilakukan alat ini
- Gambar yang dirujuk oleh Markdown tidak ditanam. Mengambilnya berarti melakukan permintaan keluar; ubah gambarnya dengan Gambar ke PDF lalu satukan hasilnya.
- HTML mentah di dalam Markdown tidak dirender. Struktur yang ditulis sebagai Markdown ikut terbawa; struktur yang ditulis sebagai tag HTML tidak.
Pertanyaan yang sering diajukan
- Ragam Markdown mana yang dimengerti alat ini?
- CommonMark ditambah perluasan GitHub: tabel, teks coret, daftar centang, dan URL telanjang yang berubah menjadi tautan. Judul, daftar berurut dan tak berurut, daftar bersarang, kutipan blok, garis pemisah, kode sebaris, dan blok kode berpagar semuanya ditangani. Front matter YAML di kepala berkas dibaca sebagai judul dokumen ketika opsinya menyala, bukan dicetak apa adanya sebagai tabel.
- Apakah judul saya berubah menjadi daftar isi?
- Ya. Dengan bookmark dari judul menyala, satu pagar sampai enam pagar menjadi entri daftar isi PDF pada kedalaman yang sesuai, jadi pembaca mendapat panel navigasi yang tersusun dari struktur yang sudah ada di berkas Anda. Tidak ada yang perlu ditambahkan ke Markdown-nya dan tidak ada daftar terpisah yang harus Anda samakan sendiri setiap kali dokumen berubah.
- Kenapa gambar di Markdown saya hilang?
- Karena berkas Markdown hanya merujuk gambarnya, tidak memuatnya, dan mengambil gambar itu berarti halaman ini melakukan permintaan atas nama Anda - satu-satunya hal yang ditolak oleh semua alat di sini. Teks, tabel, daftar, tautan, dan kode tetap ikut terbawa seluruhnya. Kalau gambarnya penting, jalankan lewat Gambar ke PDF lalu satukan kedua dokumennya dengan Gabungkan PDF.
- Bagaimana blok kode berpagar disusun?
- Dengan Noto Sans Mono pada 92 persen ukuran teks isi, di atas latar bernada tipis, dan tab dilebarkan menjadi empat spasi sebelum apa pun diukur. Baris yang lebih lebar daripada kolomnya dilipat, bukan dipotong; sambungannya ditakik sejajar dengan baris asalnya; dan lipatannya diutamakan jatuh di spasi supaya nama panjang tetap utuh dalam satu potong.
- Apakah dokumen saya diunggah untuk diubah?
- Tidak. Berkasnya dibaca, diurai, dan ditata di Web Worker di dalam browser Anda, dan PDF-nya juga ditulis di sana. Selain pemeriksaan jatah harian - nama alat dan sebuah hash - yang diambil halaman ini hanyalah berkas font Noto dari asal situs ini sendiri, dan begitu browser Anda menyimpannya di singgahan ia tidak diambil lagi.