Konversi Markdown ke PDF

Konverter Markdown ke PDF dari FileReshape memformat file .md dengan judul, daftar, tabel, blok kode, dan task list gaya GitHub di browser Anda, lalu Anda menyimpan hasilnya sebagai PDF dengan teks yang bisa dipilih lewat dialog cetak browser. File tidak diunggah ke server. Gambar yang hanya ditautkan, tidak disematkan, tampil sebagai deskripsinya, dan tidak ada pewarnaan sintaks atau tombol unduh langsung.

Ada file yang tidak terkonversi dengan benar? Kirim e-mail ke [email protected], sebaiknya disertai contoh file kecil, dan masalahnya akan diperbaiki.

Fakta singkat

Mengapa mengubah Markdown menjadi PDF

Markdown adalah cara pengembang, penulis, dan aplikasi catatan seperti Obsidian, Joplin, dan Typora menyimpan teks: terbaca sebagai teks biasa, dan terformat ketika ditampilkan aplikasi. Di luar aplikasi itu, file .md hanyalah tembok tanda pagar dan tanda bintang, yang tidak ingin Anda kirim lewat e-mail ke klien, serahkan, atau cetak. Alat ini membaca Markdown di browser Anda dengan marked, parser open source yang mengikuti aturan GitHub Flavored Markdown, dan menatanya sebagai dokumen yang rapi: judul, teks tebal dan miring, daftar bernomor dan berbutir, task list dengan kotak centang, tabel dengan garis tepi, kutipan, dan blok kode dalam font monospace yang dilipat, bukan keluar dari halaman. Mesin cetak browser sendiri kemudian menulis PDF-nya, sehingga teks tetap tajam dan bisa dicari. YAML front matter di bagian atas file, yang dipakai blog dan static site generator, tidak disertakan dalam PDF.

Cara mengonversi Markdown ke PDF

  1. Letakkan file .md Anda di kotak, atau klik untuk memilihnya. Pratinjau dokumen terformat akan muncul.
  2. Pilih ukuran halaman, margin, dan ukuran teks.
  3. Klik Buat PDF. Di dialog cetak browser Anda, pilih "Save as PDF" sebagai printer atau tujuan, lalu simpan filenya.

Yang perlu diketahui tentang Markdown dan PDF

Gambar yang hanya ditautkan

Markdown biasanya menunjuk gambar lewat alamat, seperti ![Logo](images/logo.png) atau tautan web. Alat ini hanya memiliki file .md, bukan folder di sekitarnya, dan tidak mengambil apa pun dari web, sehingga gambar seperti itu tampil sebagai kotak kecil dengan deskripsinya. Gambar yang disematkan di file sebagai data URL dicetak. Untuk memasukkan gambar ke PDF dengan cara lain, buka Markdown di editor yang menampilkan gambar dan cetak dari sana.

HTML di dalam Markdown

HTML sederhana seperti <br>, <sup>, <details>, atau tabel yang ditulis dalam HTML dipertahankan. Skrip, frame, formulir, gaya, dan video tersemat dihapus, karena tidak cocok untuk dokumen cetak dan bisa tidak aman.

Tanpa pewarnaan sintaks

Blok kode dicetak dalam font monospace dengan bingkai tipis, tetapi tanpa warna yang dipakai editor untuk kata kunci dan string. Baris kode yang panjang dilipat agar tidak ada yang terpotong di tepi halaman.

Dialek Markdown

Tabel, task list, teks coret, dan tautan otomatis mengikuti aturan GitHub, yang dipakai bersama oleh sebagian besar aplikasi. Ekstensi yang hanya dimiliki sebagian aplikasi, seperti catatan kaki, rumus matematika, diagram Mermaid, tautan wiki antarcatatan, atau callout Obsidian, ditampilkan sebagai teks biasa.

Tentang format file

Markdown

Markdown adalah format teks biasa untuk menulis dokumen berformat, dibuat oleh John Gruber pada 2004. Tanda pagar (#) membuat judul, tanda bintang membuat teks tebal dan miring, dan tanda hubung membuat daftar. GitHub, GitLab, Reddit, Obsidian, hasil ekspor Notion, dan banyak alat dokumentasi memakainya.

  • File .md adalah teks biasa, sehingga bisa dibuka di editor teks apa pun dan cocok dipakai dengan version control seperti Git.
  • GitHub Flavored Markdown (GFM) menambahkan tabel, daftar tugas, teks coret, dan tautan otomatis ke aturan aslinya.
  • Gambar biasanya ditautkan lewat alamat, sehingga disimpan sebagai file terpisah di samping file .md atau di web.

PDF

PDF (Portable Document Format) dibuat oleh Adobe pada 1993 dan menjadi standar ISO sejak 2008. PDF tampil sama di setiap perangkat, sehingga banyak dipakai untuk kontrak, faktur, formulir, buku panduan, dan dokumen hasil pindai.

  • Satu halaman dapat berisi teks, grafik vektor, dan gambar, masing-masing ditempatkan dengan tepat.
  • Dokumen hasil pindai biasanya berupa satu gambar per halaman.
  • PDF dapat dilindungi dengan kata sandi yang diperlukan untuk membuka atau mengeditnya.

Pertanyaan yang sering diajukan

Apakah file Markdown saya diunggah?

Tidak. Markdown dibaca dan diformat oleh browser di perangkat Anda sendiri, dan PDF ditulis oleh fungsi cetak browser. Tidak ada yang dikirim ke server.

Bagaimana cara menghilangkan tanggal dan alamat web di setiap halaman?

Matikan "Headers and footers" di dialog cetak browser, biasanya di bawah More settings. Itu juga menghilangkan judul halaman di bagian atas.

Mengapa blok kode saya tidak punya latar abu-abu di PDF?

Browser menghilangkan warna latar saat mencetak kecuali "Background graphics" diaktifkan di dialog cetak. Bingkai di sekitar blok kode tercetak bagaimanapun.

Bisakah saya mengonversi README dari GitHub?

Bisa. Unduh file README.md dan letakkan di sini. Badge dan tangkapan layar yang ditautkan dari web tampil sebagai deskripsinya.