Pagproseso ng Markdown sa Loob ng Browser
Ang Markdown sa PDF ay isang tool na nagbibigay-daan sa pagsulat o pag-paste ng Markdown text, pagpapakita ng live preview na may istilo, at pag-export ng nilalamang ito bilang PDF file. Ang buong proseso ng pag-convert, mula sa pagsulat hanggang sa pag-export ng PDF, ay direktang nagaganap sa loob ng web browser ng user.
Ang pag-parse, preview, at pag-export sa PDF ay lokal na tumatakbo sa iyong browser. Dahil dito, pinoproseso ang iyong Markdown sa loob ng iyong browser at walang ina-upload sa BroBroGo. Ang ganitong sistema ng client-side processing ay nag-aalok ng mabilis na pag-render ng dokumento dahil hindi na kailangang magpadala ng data sa isang panlabas na server. Angkop ang tool na ito para sa mga knowledge worker na paulit-ulit na nagbabago ng parehong draft, pati na rin sa mga indibidwal na nais gawing madaling maibahaging dokumento ang kanilang mga tala, README, tagubilin, o maiikling artikulo.
Mga Tampok ng Markdown at GFM
Sinusuportahan ng tool ang iba't ibang elemento ng karaniwang Markdown at GitHub-Flavored Markdown (GFM) upang makabuo ng maayos at organisadong dokumento. Kabilang sa mga sinusuportahang feature ang:
- Mga Heading: Paggamit ng
#para sa mga pamagat at sub-pamagat upang maitatag ang tamang herarkiya ng dokumento. - Mga Listahan: Maayos na pagkakasunod-sunod ng mga ideya gamit ang may numero (ordered) o walang numerong (unordered) listahan.
- Mga Talahanayan: Pag-organisa ng mga datos sa mga hanay at hanay para sa mas madaling pagbabasa.
- Mga Code Block: Pagpapakita ng mga snippet ng code na may malinaw na formatting.
- Mga Blockquote: Pag-highlight ng mga sipi o mahahalagang pahayag.
- Mga Link at Larawan: Paglalagay ng mga panlabas na link at mga visual na elemento sa loob ng dokumento.
- Emphasis: Paggamit ng bold o italic na teksto upang bigyang-diin ang mga partikular na salita.
- Mga Task List: Mga checklist na istilong GitHub upang masubaybayan ang mga gawain.
Ang pagkakaroon ng live preview ay nagbibigay ng agarang feedback habang nag-e-edit, kung saan makikita agad ang pinal na hitsura ng dokumento bago ito i-export.
Gabay sa Paggamit ng Interface
Ang interface ng tool ay nahahati sa mga bahagi na nagpapadali sa pagsulat at pag-preview ng dokumento. Maaaring lumipat ang user sa pagitan ng view na "Magsulat" at "Preview". Mayroon ding opsyon para sa "Madilim na editor" upang maging mas komportable ang pagsusulat sa madidilim na kapaligiran.
Sa unang pagbukas ng tool, ang default na placeholder text sa editor ay nagpapakita ng halimbawang ito:
# Hello
Isulat ang **Markdown** dito at tingnan ang format nito sa kanan.
Habang nagsusulat, awtomatikong binibilang ng tool ang haba ng dokumento at ipinapakita ang mga sumusunod na sukatan sa ibaba ng editor:
- Mga Salita: Bilang ng mga salita sa editor.
- Mga Character: Bilang ng mga titik at simbolo sa editor.
Ang status bar ay nagpapakita ng kasalukuyang estado ng tool gamit ang mga sumusunod na mensahe:
- Handa na. Magsulat o mag-paste ng Markdown para makita ang live preview.: Lumalabas kapag handa nang tanggapin ng editor ang input ng user.
- Na-clear na ang editor.: Ipinapakita pagkatapos i-click ang button na "I-clear".
- Wala pang mai-e-export — magsulat muna ng Markdown.: Lumalabas bilang babala kapag walang laman ang editor at tinangka ng user na mag-export.
Kapag pinindot ang button na "I-clear", ang bilang ng mga salita at character ay babalik sa zero, ang preview area ay magpapakita ng "Lalabas dito ang iyong na-format na preview.", at ang status ay magiging "Na-clear na ang editor.".
Paano Gumagana ang Pag-export ng PDF
Kapag handa na ang dokumento, ang pag-export ay hindi gumagamit ng server-side rendering kundi ang native print engine ng mismong web browser.
Kapag i-click ang "I-export sa PDF", bubukas ang print dialog ng iyong browser. Sa puntong ito, dapat piliin ng user ang "I-save bilang PDF" bilang destinasyon ng file. Dito rin maaaring ayusin ang laki ng pahina at ang mga margin ng dokumento.
Ang na-export na PDF ay naglalaman ng totoong text na maaaring hanapin at may mga gumaganang link. Hindi ito isang flattened na larawan, kaya naman maaaring i-highlight, kopyahin, at piliin ang mga teksto sa loob ng nagawang PDF file.
Kung walang laman ang editor at pinindot ang "I-export sa PDF", hindi bubukas ang print dialog ng browser at sa halip ay lalabas ang error na "Wala pang mai-e-export — magsulat muna ng Markdown.".
Pamagat ng Dokumento at Pag-save
Ang pangalan ng file at pamagat ng na-export na PDF ay nakadepende sa istruktura ng isinulat na Markdown. Gagamitin ng PDF ang unang # heading sa iyong Markdown bilang pamagat nito at iminungkahing pangalan ng file. Kung walang top-level heading ang iyong Markdown, ie-export ito gamit ang default na pangalang "Walang pamagat na dokumento". Kaya naman, iminumungkahi na maglagay ng isang # heading sa pinakataas ng dokumento upang maging maayos ang pag-save ng file.
Mga Madalas Itanong (FAQ)
Ina-upload ba ang aking Markdown?
Hindi po. Ang pag-parse, preview, at pag-export sa PDF ay lokal na tumatakbo sa iyong browser. Walang anumang data na ipinapadala sa mga panlabas na server ng BroBroGo.
Paano ako makakakuha ng PDF file?
I-click ang I-export sa PDF. Bubukas ang print dialog ng iyong browser — piliin ang "I-save bilang PDF" bilang destinasyon. Maaari mo ring i-adjust ang mga setting tulad ng margin at laki ng papel sa dialog na ito.
Maaari bang piliin o i-highlight ang text sa PDF?
Opo. Ginagamit ng pag-export ang native print engine ng iyong browser, kaya nananatiling totoong text na maaaring hanapin at may mga gumaganang link ang PDF — hindi ito isang flattened na larawan.
Anong mga feature ng Markdown ang sinusuportahan?
Mga heading, listahan, talahanayan, code block, blockquote, link, larawan, emphasis, at mga task list na istilong GitHub.
Ano ang magiging pamagat ng aking na-export na PDF?
Gagamitin ng PDF ang unang # heading sa iyong Markdown bilang pamagat nito at iminungkahing pangalan ng file. Kung walang top-level heading ang iyong Markdown, ie-export ito bilang "Walang pamagat na dokumento".