Konverter Markdown ke PDF Gratis

Tentang Markdown

Markdown adalah bahasa markup ringan yang mengonversi teks polos menjadi HTML yang diformat. Banyak digunakan untuk dokumentasi, blog, dan penulisan teknis karena mudah dibaca dan ditulis.

Sintaks Markdown

• #, ##, ### · heading (h1, h2, h3)
• **teks** · teks tebal
• *teks* · teks miring
• [tautan](url) · hyperlink
• - item · daftar tidak terurut
• 1. item · daftar terurut

Pertanyaan umum

Bisakah saya menggunakan HTML dalam Markdown?

Ya. Markdown mendukung HTML inline, jadi Anda dapat menyematkan tag HTML langsung ke dalam Markdown Anda.

Ukuran halaman apa yang didukung?

A4, Letter, A3, dan A5 didukung. Margin dapat disesuaikan antara 0 dan 50 milimeter.

Apakah pembuatan PDF di sisi klien?

Ya. Semua konversi dilakukan di browser Anda. Markdown Anda tidak pernah dikirim ke server kami.

Cara kerja konverter ini

Alat Markdown-ke-PDF berbasis browser menjalankan pipeline dua tahap. Pertama, sumber Markdown di-parse menjadi HTML oleh parser Markdown JavaScript (halaman ini menggunakan marked.js, parser kecil, cepat, berlisensi MIT yang dikelola oleh organisasi MarkedJS). Hasilnya adalah HTML yang Anda lihat di preview langsung. Kedua, HTML tersebut dikonversi menjadi PDF, halaman ini menggunakan html2pdf.js, yang sendiri membungkus dua library: html2canvas melukis ulang DOM yang dirender ke canvas off-screen dengan membaca style terkomputasi, dan jsPDF menulis gambar canvas tersebut ke dalam objek halaman PDF dan menyimpan file.

Library itu sendiri dimuat dari CDN publik, tetapi Markdown Anda di-parse dan PDF dihasilkan sepenuhnya di perangkat Anda. Browser adalah renderer; tidak ada yang meninggalkan halaman.

Sejarah singkat PDF

PDF dimulai sebagai proposal internal John Warnock, salah satu pendiri Adobe, pada tahun 1991. Ia ingin cara berbagi dokumen yang terlihat sama di setiap layar, setiap printer, setiap sistem operasi. Makalah singkat yang mengawalinya berjudul «The Camelot Project,» dan Adobe menerbitkan spesifikasi PDF pertama pada 15 Juni 1993 bersama Adobe Acrobat 1.0. Adobe mengelola format tersebut selama lima belas tahun sebelum menerbitkan PDF 1.7 ke ISO. ISO 32000-1:2008 menjadikan PDF standar terbuka yang dapat digunakan bebas tanpa lisensi, tanggal terpenting untuk memahami mengapa setiap alat, browser, dan OS modern dapat menulis PDF saat ini. ISO 32000-2:2017 (PDF 2.0) menambahkan tanda tangan digital yang lebih baik, penanganan Unicode yang lebih baik, dan kait aksesibilitas formal. Edisi terkoreksi 2020 dibuat tersedia untuk diunduh secara gratis oleh PDF Association pada April 2023, menghilangkan hambatan biaya terakhir.

PDF pada dasarnya adalah container terstruktur dari objek yang disusun untuk akses acak, grafik vektor (garis dan kurva Bézier), gambar raster (biasanya JPEG atau terkompresi zlib), font tersemat (Type 1, TrueType, OpenType), dan tabel referensi silang yang memungkinkan pembaca melompat ke mana saja tanpa mem-parse seluruh file. Ada beberapa standar subset PDF yang perlu diketahui: PDF/A (arsip, ISO 19005, 2005, melarang apa pun yang dapat merusak keterbacaan jangka panjang), PDF/X (produksi cetak dengan manajemen warna yang terkunci), dan PDF/UA (Universal Accessibility, ISO 14289-1, 2012, mengharuskan PDF bertag penuh dengan urutan baca, alt text, font tersemat yang dipetakan ke Unicode, dan bahasa dokumen dideklarasikan).

Ukuran halaman

Seri A berasal dari ISO 216 (diformalkan 1975, dapat ditelusuri ke DIN 476 Jerman dari 1922). Setiap ukuran A memiliki rasio aspek √2 (≈ 1,414) yang sama, yang berarti membagi setengah tepi panjang A3 menghasilkan dua A4 tanpa sisa, dan membagi setengah A4 menghasilkan dua A5. A0 persis 1 m². Ukuran Amerika Utara (Letter, Legal, Tabloid) mengabaikan √2 dan berakar dari konvensi pembuatan kertas kolonial:

• A4: 210 × 297 mm (8,3 × 11,7 inci). Default global di luar Amerika Utara.
• A3: 297 × 420 mm (11,7 × 16,5 inci). Poster, spread.
• A5: 148 × 210 mm (5,8 × 8,3 inci). Booklet, zine.
• Letter: 8,5 × 11 inci (215,9 × 279,4 mm). Default di AS, Kanada, dan Filipina.

Margin default 10 mm lebih sempit dari default Microsoft Word sebesar 1 inci (25,4 mm) tetapi cocok untuk dokumen yang padat kode atau tabel di mana Anda ingin setiap kolom muat.

Peringatan jujur: teks tidak dapat dipilih

Karena konverter merender HTML ke canvas dan menyematkan canvas sebagai gambar di dalam PDF, teks yang dihasilkan tidak dapat dipilih, tidak dapat dicari, dan tidak dapat diakses oleh screen-reader. Ini adalah gambar setia dari apa yang akan digambar browser, tetapi itu adalah gambar. Ini baik untuk artefak visual seperti kartu resep, mood board, atau handout yang dicetak; ini kurang cocok untuk dokumen hukum, resume yang ingin di-scan kata kunci perekrut, atau apa pun yang perlu lulus audit aksesibilitas (WCAG / Section 508 / EN 301 549).

Jika Anda membutuhkan teks yang dapat dipilih atau PDF bertag, alat yang tepat adalah Pandoc (dikombinasikan dengan LaTeX atau wkhtmltopdf atau weasyprint) atau Adobe Acrobat Pro dengan alat taggingnya. Pandoc adalah standar emas untuk produksi dokumen serius, dapat diinstal melalui Homebrew atau Chocolatey, berjalan dari baris perintah, memberikan kontrol tipografi setara LaTeX penuh dengan catatan kaki, bibliografi, kutipan, smart quote, dan ligatur yang tepat.

Memaksa pemisah halaman

html2pdf.js menghormati properti CSS print-fragmentation. Karena Markdown memungkinkan Anda menyematkan HTML inline, Anda dapat memaksa pemisah halaman dengan menempelkan:

<div style="break-before: page;"></div>

Alias lama page-break-before: always juga berfungsi. Properti berguna lainnya: break-inside: avoid pada tabel atau blok kode mencegahnya terpecah di antara halaman; orphans dan widows mengontrol berapa baris yang harus tetap bersama di bagian bawah atau atas halaman.

Tips untuk keluaran yang bersih

• Hindari gambar raster yang sangat besar. Satu foto halaman penuh dapat menambahkan ratusan kilobyte. Ubah ukuran gambar sebelum disematkan, atau gunakan max-width dalam inline style untuk membatasi seberapa besar render-nya.
• Tabel yang tidak ingin terpecah antar halaman: bungkus dengan <div style="break-inside: avoid">.
• Blok kode membutuhkan monospace. Browser menggunakan font monospace OS Anda saat tidak ada yang lebih spesifik ditetapkan, Consolas di Windows, Menlo di macOS, DejaVu Mono di Linux. Keluarannya akan terlihat sedikit berbeda di setiap sistem.
• Uji dengan panjang konten yang realistis. Dokumen uji singkat sudah baik tetapi tata letak terkadang terlihat berbeda pada 10+ halaman.
• Letter vs A4. Jika Anda berbagi dengan penerima AS, pilih Letter; seluruh dunia lainnya mengharapkan A4. Ukuran yang tidak cocok tidak merusak apa pun tetapi menyebabkan margin/keanehan penskalaan kecil di printer.

Markdown umum untuk jenis keluaran ini

Sintaks yang didukung adalah subset berasa GitHub, heading, tebal dan miring, daftar, tabel, blok kode dengan penyorotan sintaks sederhana, blockquote, tautan dan gambar. Footnote dan diagram Mermaid tidak didukung oleh build ini. Pengingat cepat tentang dasar-dasarnya:

• Heading: # H1 hingga ###### H6.
• Tebal dan miring: **bold**, *italic*, ***both***.
• Daftar: - item untuk daftar tak berurutan, 1. item untuk daftar berurutan.
• Tautan dan gambar: [text](url) dan ![alt](url). Selalu sertakan alt text.
• Tabel: baris yang dibatasi pipa dengan baris pemisah tanda hubung.
• Blok kode berpagar: tiga backtick ditambah tag bahasa opsional.
• Blockquote: > text.

Pengingat tentang silsilah Markdown: John Gruber dan Aaron Swartz merancangnya pada 2004 sebagai «format teks biasa yang mudah dibaca, mudah ditulis». Upaya standarisasi CommonMark dimulai pada 2014, dipimpin oleh John MacFarlane (Pandoc), Jeff Atwood (Stack Overflow / Discourse), dan insinyur dari GitHub, Reddit, dan Meteor. GitHub Flavored Markdown adalah superset CommonMark yang menambahkan tabel, strikethrough, daftar tugas, dan autolink.

Pertanyaan lainnya

Mengapa teks di PDF saya buram?

Karena konverter merasterisasi halaman pada kepadatan tampilan browser. Di monitor non-Retina, gambar yang dihasilkan dapat terlihat lembut saat di-zoom, karena canvas menangkap pada sekitar 96 DPI daripada 300 DPI khas cetak. Solusinya adalah merender pada kepadatan lebih tinggi, html2canvas menerima opsi scale (biasanya 2× untuk keluaran berkualitas Retina), dengan konsekuensi ukuran file yang lebih besar.

Mengapa blok kode saya tidak berwarna-warni?

marked.js tidak menyertakan penyorotan sintaks secara default, ia hanya membungkus blok berpagar dalam tag <pre><code class="language-…">. Penyorotan nyata membutuhkan library terpisah seperti Prism.js atau highlight.js, yang tidak disertakan dalam build ini. PDF akan menampilkan kode Anda dalam monospace tetapi tanpa tema warna hijau-dan-merah yang mungkin Anda harapkan dari GitHub.

Bisakah saya menyertakan footnote atau daftar isi?

Footnote (referensi [^1] dan [^1]: definitions) adalah fitur render GitHub di luar spec GFM standar dan tidak di-parse oleh build ini. Daftar isi memerlukan ekstensi Markdown (seperti plugin TOC markdown-it) atau menulis daftar tautan secara manual. Untuk keduanya, Pandoc dengan flag --toc adalah alat yang tepat.

Apakah PDF akan diberi tag untuk aksesibilitas?

Tidak. Keluarannya adalah PDF gambar-halaman tanpa tag semantik, alt text, atau petunjuk urutan baca, ia tidak akan lulus pemeriksaan kesesuaian PDF/UA. Untuk pekerjaan yang memerlukan aksesibilitas (formulir pemerintah, dokumen sektor publik, apa pun yang tunduk pada WCAG / EN 301 549 / Section 508), gunakan Pandoc + LaTeX dengan filter aksesibilitas, alat tagging Adobe Acrobat Pro, atau pipeline WeasyPrint sisi server.

Apakah ada yang dikirim ke server?

Tidak. Teks tidak pernah meninggalkan browser Anda. Marked.js mem-parse Markdown secara lokal, html2canvas melukis ke canvas off-screen, jsPDF membangun objek PDF, dan browser menyimpannya. Library itu sendiri dimuat dari CDN publik dengan pemeriksaan subresource-integrity; mereka diambil sekali dan kemudian di-cache. Setelah halaman dimuat, alat ini bekerja secara offline.

Alat terkait