Proses Penukaran Markdown ke PDF Tempatan
Alatan Markdown ke PDF membolehkan anda menulis atau menampal teks Markdown, melihat pratonton langsung kandungan yang telah digayakan, dan mengeksport hasil tersebut sebagai fail PDF. Keseluruhan proses ini, bermula daripada penulisan sehingga eksport PDF, berlaku secara terus di dalam pelayar web anda.
Apabila anda menggunakan alatan ini, pemprosesan Markdown dilakukan sepenuhnya dalam pelayar anda, dan tiada sebarang data yang dimuat naik ke BroBroGo. Segala proses penghuraian (parsing), paparan pratonton, dan eksport PDF dijalankan secara tempatan. Ciri pemprosesan pihak klien (client-side) ini memberikan kelebihan dari segi kelajuan pemprosesan kerana tiada masa pemindahan data ke pelayan luar, di samping mengekalkan privasi dokumen anda.
Alatan ini menyediakan beberapa elemen antaramuka untuk memudahkan aliran kerja anda:
- Tulis Markdown anda: Kawasan editor untuk menulis atau menampal teks Markdown. Editor ini turut menyokong mod "Editor gelap" serta kebolehan untuk bertukar antara paparan "Tulis" dan "Pratonton".
- Pratonton: Kawasan yang memaparkan hasil format secara langsung. Jika editor kosong, kawasan ini akan memaparkan teks "Pratonton berformat anda akan dipaparkan di sini.".
- Statistik Dokumen: Memaparkan bilangan "Perkataan" dan "Aksara" semasa di dalam editor.
- Mesej Status: Memaparkan status operasi seperti "Sedia. Tulis atau tampal Markdown untuk melihat pratonton langsung." atau "Editor dikosongkan.".
Sintaks Markdown yang Disokong
Markdown ialah bahasa penanda ringkas yang digunakan secara meluas dalam dokumentasi teknikal, fail README, nota, dan penghasilan kandungan. Alatan ini menyokong pelbagai elemen sintaks standard dan lanjutan untuk memastikan dokumen anda diformat dengan betul sebelum dieksport.
Elemen sintaks yang disokong termasuk:
- Pengepala (Headings): Digunakan untuk menstrukturkan dokumen daripada tahap utama sehingga sub-seksyen.
- Senarai (Lists): Menyokong senarai tertib (bernombor) dan senarai tidak tertib (bulet).
- Jadual (Tables): Membolehkan penyusunan data dalam bentuk baris dan lajur.
- Blok Kod (Code Blocks): Berguna untuk memaparkan kod pengaturcaraan dengan format yang jelas.
- Petikan Blok (Blockquotes): Untuk menonjolkan teks petikan atau nota penting.
- Pautan dan Imej: Menyokong pautan hiperteks aktif dan paparan imej.
- Penekanan (Emphasis): Penggunaan teks tebal (bold) dan condong (italic).
- Senarai Tugasan Gaya GitHub (GitHub-style task lists): Membolehkan kotak semakan (checkbox) dipaparkan untuk senarai semak.
Sebagai contoh, apabila anda membuka alatan buat kali pertama, editor akan memaparkan teks contoh:
# Hello
Tulis **Markdown** di sini dan lihat formatnya di sebelah kanan.
Teks contoh ini menunjukkan penggunaan pengepala tahap satu dan penekanan tebal.
Mekanisme Eksport PDF Melalui Pelayar
Apabila anda mengklik butang "Eksport PDF", alatan ini tidak menghasilkan fail imej yang statik. Sebaliknya, ia menggunakan enjin cetakan asli pelayar web anda untuk menjana dokumen PDF.
Proses eksport ini mengikut aturan berikut:
- Pembukaan Dialog Cetak: Mengklik "Eksport PDF" akan membuka dialog cetak pelayar anda. Di sini, anda perlu memilih "Simpan sebagai PDF" sebagai destinasi cetakan. Anda juga boleh menetapkan saiz halaman dan jidar (margin) melalui dialog tersebut.
- Teks Boleh Dipilih dan Pautan Berfungsi: Oleh sebab PDF dijana menggunakan enjin cetakan pelayar, dokumen yang dihasilkan mengandungi teks sebenar yang boleh dicari dan dipilih (selectable text), serta pautan hiperteks yang berfungsi sepenuhnya, bukannya imej yang diratakan.
- Penamaan Fail: PDF yang dieksport akan menggunakan pengepala
#pertama dalam Markdown anda sebagai tajuk dokumen dan nama fail yang dicadangkan. Sekiranya dokumen anda tidak mempunyai pengepala tahap utama tersebut, fail akan dieksport dengan nama "Dokumen tanpa tajuk".
Pengendalian Ralat dan Pembersihan Editor
Alatan ini mempunyai peraturan khusus untuk mengendalikan keadaan kosong atau semasa proses pembersihan dokumen:
| Tindakan Pengguna | Tingkah Laku Alatan & Mesej Antaramuka |
|---|---|
| Mengklik "Eksport PDF" semasa editor kosong | Dialog cetak pelayar tidak akan dibuka. Alatan akan memaparkan mesej ralat: "Tiada apa-apa untuk dieksport lagi — tulis beberapa Markdown terlebih dahulu.". |
| Mengklik "Kosongkan" | Editor akan dikosongkan sepenuhnya. Pembilang "Perkataan" dan "Aksara" akan ditetapkan semula ke nilai sıfar (0). Kawasan pratonton akan memaparkan "Pratonton berformat anda akan dipaparkan di sini." dan status "Editor dikosongkan." akan ditunjukkan. |
Ciri ini memastikan pengguna tidak mengeksport dokumen kosong secara tidak sengaja dan memudahkan penulis draf yang perlu mengemas kini atau menukar kandungan secara berulang kali.
Soalan Lazim (FAQ)
Adakah Markdown saya dimuat naik? Tidak. Penghuraian, pratonton dan eksport PDF semuanya berjalan secara tempatan dalam penyemak imbas anda. Tiada sebarang data atau teks yang anda tulis dihantar ke pelayan luar.
Bagaimanakah cara untuk mendapatkan fail PDF? Klik Eksport PDF. Dialog cetak penyemak imbas anda akan dibuka — pilih "Simpan sebagai PDF" sebagai destinasi. Anda juga boleh melaraskan tetapan tambahan seperti saiz kertas dan jidar pada dialog tersebut.
Adakah teks PDF boleh dipilih? Ya. Eksport menggunakan enjin cetakan asli penyemak imbas anda, jadi PDF mengekalkan teks sebenar yang boleh dicari dan pautan yang berfungsi — bukan imej yang diratakan.
Apakah ciri Markdown yang disokong? Alatan ini menyokong pengepala, senarai, jadual, blok kod, petikan blok, pautan, imej, penekanan dan senarai tugasan gaya GitHub.
Apakah tajuk PDF yang dieksport saya?
PDF menggunakan pengepala # pertama dalam Markdown anda sebagai tajuk dan nama fail yang dicadangkan. Jika Markdown anda tidak mempunyai pengepala tahap utama, ia akan dieksport sebagai "Dokumen tanpa tajuk".