Cetak Markdown dengan rapi

Cara tercepat untuk mencoba mdprint adalah mulai mengetik di editor pada halaman beranda. Editor memuat dokumen contoh yang menggunakan setiap fitur - tabel, kode, matematika, diagram - sehingga kamu langsung tahu seperti apa hasil akhirnya. Hapus contohnya lalu ketik kontenmu sendiri, atau tempel dari tempatmu menulis.

Kalau kamu sudah punya berkas Markdown di komputer, ada dua cara untuk memuatnya. Pertama, seret dari pengelola berkas dan jatuhkan ke panel editor. Sorotan akan muncul di sekitar zona jatuh saat kamu menyeret. Lepaskan berkas, dan editor akan terisi oleh isinya. Kedua, klik tombol Impor di toolbar dan pilih berkas dari pemilih berkas. Kedua cara membaca berkas secara lokal - tidak ada yang diunggah.

mdprint menerima berkas .md, .markdown, dan .txt. Ekstensi .txt berguna untuk dokumen yang ditulis sebagai Markdown tetapi disimpan dengan ekstensi umum oleh alat lain. Jika kamu mencoba mengimpor berkas dengan ekstensi lain, mdprint akan menampilkan kesalahan dan membiarkan kontenmu saat ini tetap utuh.

Kalau kamu belum pernah menulis Markdown, aturannya cukup sedikit untuk dipelajari dalam lima menit. Kamu menulis teks polos, dan empat karakter mengerjakan sebagian besar pekerjaan. Tanda # di awal baris membuat judul - satu # untuk judul terbesar, enam ##### untuk yang terkecil. Tanda * dan _ di sekitar kata membuatnya miring jika satu di tiap sisi, dan tebal jika dua. Tanda - atau * di awal baris membuat butir. Indentasi dua spasi untuk menumpukkan satu butir di bawah yang lain.

Kode ditangani dengan backtick. Satu backtick di tiap sisi sebuah frasa memformatnya sebagai `inline code`. Tiga backtick di satu baris memulai blok kode, dan tiga lagi mengakhirinya. Jika kamu menaruh nama bahasa tepat setelah tiga backtick pembuka (```python, ```typescript, ```sql), blok kode akan disorot dalam bahasa tersebut. Tanpa petunjuk bahasa, penyorot mencoba menebak dari isinya, yang biasanya berhasil untuk bahasa populer.

Tautan dan gambar sama-sama memakai kurung siku dan kurung biasa. Tautan adalah [teks yang kamu lihat](URL). Gambar adalah hal yang sama dengan tanda seru di depan: . Saat dicetak ke PDF, URL gambar yang menunjuk ke server yang dapat diakses publik akan diambil dan disematkan. Gambar di mesin lokal atau di balik autentikasi tidak akan tampil - jatuhkan langsung ke editor sebagai URL data base64 jika kamu perlu menyematkannya.

Tabel adalah bagian Markdown yang terlihat rumit di sumber tetapi terrender rapi. Satu baris header, satu baris pemisah berisi tanda hubung, dan satu atau lebih baris data, semuanya dipisahkan pipa. Kolomnya tidak perlu lurus di sumber - perender mengatur jaraknya. Tambahkan titik dua di salah satu atau kedua ujung tanda hubung di baris pemisah untuk mengatur perataan: :--- kiri, ---: kanan, :---: tengah.

Persamaan matematika memakai sintaks TeX yang dibungkus tanda dolar. Satu tanda dolar di tiap sisi memberi matematika dalam baris: $a^2 + b^2 = c^2$. Dua tanda dolar di baris tersendiri memberi persamaan tampilan, di baris sendiri yang dipusatkan dan lebih besar. Semua perintah matematika LaTeX yang biasa kamu pakai - \frac, \int, \sum, \sqrt, huruf Yunani, matriks, himpunan simbol AMS - berfungsi karena mdprint memakai KaTeX yang mengimplementasikan sintaks yang sama.

Diagram memakai sintaks Mermaid di dalam blok kode berpagar yang ditandai dengan bahasa mermaid. Diagram paling sederhana adalah diagram alur: buka dengan graph LR (kiri-ke-kanan) atau graph TD (atas-ke-bawah), lalu tulis simpul yang dihubungkan oleh panah. Mermaid juga mendukung diagram sekuens (menampilkan aliran pesan antar-aktor sepanjang waktu), diagram gantt (linimasa proyek dengan ketergantungan), diagram kelas (relasi objek), dan diagram status (mesin status). Dokumentasi Mermaid berisi contoh untuk tiap tipe.

Catatan kaki membuat tulisan tetap mudah dibaca sambil menambahkan kutipan rinci atau catatan tambahan. Tandai catatan kaki di teks dengan [^1] (angkanya bisa apa saja - akan dinomori ulang di keluaran). Di tempat lain dalam dokumen, definisikan catatan kaki dengan [^1]: isi catatan kaki. mdprint mengumpulkan semua catatan kaki di akhir dokumen cetak dan menambahkan tautan balik yang menghubungkan setiap catatan ke tempat ia muncul di teks.

Jika dokumenmu panjang, taruh teks harfiah [[toc]] di sumber tempat kamu ingin daftar isi muncul. mdprint akan menggantinya dengan daftar tautan bersarang ke setiap H2 dan H3 di dokumen. Pada PDF cetak, daftar isi yang sama menjadi kerangka navigasi yang bisa dipakai oleh pembaca PDF.

Buka panel Pengaturan dari toolbar untuk mengatur cara PDF dihasilkan. Ukuran halaman punya dua pilihan: A4 (standar di luar Amerika Utara) atau Letter (standar di Amerika Utara). Orientasi beralih antara potret dan lanskap - lanskap berguna untuk dokumen dengan tabel atau diagram lebar. Margin menawarkan tiga preset: sempit memberi area pakai lebih luas untuk konten padat, normal adalah jalan tengah yang konvensional, lebar menyediakan ruang untuk anotasi tulisan tangan pada salinan cetak.

Editor punya tema terang dan gelapnya sendiri, lepas dari sisa halaman. Pengalih di toolbar berpindah di antara keduanya. Pratinjau dan keluaran cetak tetap dalam mode terang, karena latar belakang terang yang cocok dicetak di kertas.

Kalau kamu rutin memakai set opsi yang sama, pilihan terakhir diingat secara lokal dan diterapkan otomatis saat kamu membuka mdprint berikutnya di peramban yang sama.

Tombol Cetak membuka dialog cetak bawaan peramban. Dari sana, setiap sistem operasi modern menawarkan Simpan sebagai PDF sebagai tujuan - Chrome, Firefox, Safari, dan Edge semua mendukungnya di macOS, Windows, dan Linux. Lewat dialog cetak memberimu kontrol terbanyak: pilih printer apa pun, pratinjau tiap halaman, ubah orientasi per halaman jika driver mendukung, dan di beberapa printer kamu bisa mengganti baki kertas atau stapling.

Tombol Unduh PDF melewati dialog cetak dan menghasilkan berkas PDF langsung di peramban, lalu memicu unduhan. Ia memakai Pengaturanmu saat ini (ukuran halaman, orientasi, margin) untuk memformat keluaran. Rute ini lebih cepat saat kamu tahu persis apa yang kamu mau dan tidak butuh fleksibilitas dialog cetak. Ia bekerja dengan merender halaman menjadi gambar beresolusi tinggi dan menempatkan gambar itu ke dalam PDF, sehingga hasilnya selalu sama dengan yang kamu lihat di layar. Konsekuensinya: karena halaman menjadi gambar, teks dalam PDF ini tidak bisa dipilih atau dicari.

Kedua rute berbeda dalam hal apa yang akhirnya ada di dalam berkas. Simpan sebagai PDF, lewat tombol Cetak, mempertahankan teks sebagai teks: tetap bisa dipilih dan dicari, tetap tajam pada zoom berapa pun, dan diagram tetap berupa vektor. Sebaliknya, Unduh PDF adalah cuplikan gambar sekali klik, jadi cepat dan akurat per piksel, tetapi teksnya tidak bisa dipilih. Pakai Simpan sebagai PDF saat kamu ingin teks yang bisa dipilih atau hasil paling tajam pada zoom berapa pun; pakai Unduh PDF saat kamu hanya ingin salinan cepat dan persis dari apa yang ada di layar tanpa membuka dialog cetak.

Pemenggalan halaman di tempat ganjil. mdprint menghindari pemenggalan di dalam blok kode, tabel, dan diagram, tetapi tidak ikut campur pada tulisan biasa. Kalau sebuah judul mendarat di bawah halaman sementara konten berlanjut di halaman berikutnya, cara termudah adalah menambah beberapa kalimat di atas atau bawah untuk mendorong judul. V1 belum punya sintaks pemenggalan manual - itu ada di daftar V2.

Gambar tidak tampil di PDF. Penyebab paling umum adalah URL gambar yang menunjuk ke sistem berkas lokal (file://) atau ke server yang tidak mengizinkan akses lintas-asal. Sematkan gambar sebagai URL data langsung di sumber Markdown, atau unggah ke layanan hosting gambar yang mengizinkan baca publik. Imgur, server konten pengguna GitHub, dan kebanyakan CDN bekerja.

Matematika tidak terender. Periksa sumber untuk tanda dolar yang tidak di-escape di teks biasa - sebuah $ tersesat bisa membuka rentang matematika yang menelan sisa paragraf. Kalau kamu butuh tanda dolar harfiah di tulisan, escape: \$. Kalau sintaksnya benar tapi tetap tidak terender, perintah LaTeX itu mungkin tidak ada di daftar dukungan KaTeX - dokumentasi KaTeX punya referensi lengkap.

Diagram kosong. Mermaid ketat soal sintaks. Kesalahan paling umum adalah hilangnya spasi setelah graph LR, ID simpul yang mengandung spasi (pakai camelCase atau garis bawah), atau panah yang menunjuk ke simpul yang tidak didefinisikan. Buka konsol pengembang peramban - Mermaid mencatat pesan kesalahan spesifik saat parsing gagal.

Tabel terbungkus aneh. Kalau tabel lebih lebar dari halaman, mdprint akan menyusutkannya. Untuk tabel yang sangat lebar, alihkan orientasi ke lanskap di Pengaturan, atau ubah tabelnya menjadi daftar. PDF tidak menangani gulir horizontal seperti web.

Pakai pintasan papan ketik. Cmd+P (atau Ctrl+P di Windows dan Linux) membuka dialog cetak. Cmd+S (Ctrl+S) memicu Unduh PDF. Pintasan papan ketik peramban sendiri untuk cari (Cmd+F), muat ulang (Cmd+R), dan zoom (Cmd+plus/minus) semua berjalan normal - tidak bertabrakan dengan mdprint.

Mulai setiap dokumen dengan H1. H1 pertama menjadi nama PDF yang disarankan, judul dokumen untuk aksesibilitas, dan judul mencolok di atas halaman cetak. Kalau kamu mulai dengan H2 atau lebih rendah, nama berkas kembali ke 'document.pdf' dan kamu perlu mengganti namanya secara manual setelah mengunduh.

Sematkan gambar sebagai URL data ketika privasi penting. Kalau kamu tidak ingin pembaca PDF mengambil gambar dari server jarak jauh saat membuka berkasmu, ubah gambar menjadi URL data base64 dan sematkan langsung. Sebagian besar sistem operasi punya alat bawaan atau alat khusus untuk konversi ini. Berkas hasilnya lebih besar, tapi sepenuhnya mandiri.

Pakai daftar tugas untuk checklist cetak. Kalau kamu membuat checklist kertas - daftar packing, checklist pengiriman, prosedur langkah-demi-langkah - pakai sintaks daftar tugas Markdown dengan - [ ]. Kotaknya tercetak sebagai persegi yang bisa kamu centang dengan pena.

Padukan mermaid dan kode dalam dokumentasi teknis. Pola umum adalah menampilkan diagram alur sebuah proses, lalu kode sebenarnya yang mengimplementasikannya. Markdown memungkinkanmu melakukan keduanya dalam berkas yang sama, dan mdprint merendernya supaya dicetak rapi berdampingan.

Cmd+P atau Ctrl+P - buka dialog cetak.

Cmd+S atau Ctrl+S - unduh sebagai PDF.

Cmd+B atau Ctrl+B di dalam editor - buat teks yang dipilih menjadi tebal.

Cmd+I atau Ctrl+I di dalam editor - buat teks yang dipilih menjadi miring.

Cmd+/ atau Ctrl+/ di dalam editor - alihkan komentar untuk baris saat ini (komentar HTML dalam konteks Markdown).

Esc di dalam editor saat layar penuh - keluar dari layar penuh.