瀏覽器本機解析與 PDF 產生機制
本工具提供將 Markdown 格式文字轉換為 PDF 文件的完整流程。當使用者在編輯器中輸入或貼上 Markdown 語法時,瀏覽器會即時解析標記符號,並在預覽區域呈現排版後的視覺效果。
此轉換流程完全在使用者端(Client-side)的瀏覽器內執行,不涉及任何伺服器端上傳。當使用者點擊「匯出 PDF」時,系統會呼叫瀏覽器內建的列印引擎,將 HTML 預覽畫面轉換為 PDF 格式。這種處理方式不僅能即時呈現排版結果,更能確保資料處理的隱私性,因為所有文字解析與 PDF 產生步驟皆在個人裝置上完成,內容不會上傳到 BroBroGo。
支援的 Markdown 語法與文件結構
Markdown 是一種輕量級標記語言,廣泛應用於技術文件、專案說明(README)及各類文章撰寫。本工具支援多種常見的 Markdown 語法元素,協助使用者建立結構完整的 PDF 文件:
- 標題(Headings):使用
#符號定義層級,有助於建立清晰的文件大綱。 - 清單(Lists)與GitHub 風格待辦清單(Task Lists):支援無序清單、有序清單,以及帶有核取方塊的待辦事項。
- 表格(Tables):用於呈現結構化數據與對齊資訊。
- 程式碼區塊(Code Blocks):保留程式碼的縮排與等寬字型,適合技術文件。
- 引用(Blockquotes)、連結(Links)與圖片(Images):豐富文件內容與外部參考資訊。
- 強調樣式(Emphasis):包括粗體、斜體與刪除線,用於強調特定文字。
向量 PDF 的文字選取與連結特性
透過瀏覽器列印引擎產生的 PDF 文件,與將畫面截圖後轉存的點陣圖 PDF 不同。本工具匯出的 PDF 檔案具備以下特性:
- 可選取與可搜尋的文字:PDF 內保留真實的文字編碼,使用者可以使用瀏覽器的搜尋功能(Ctrl+F 或 Cmd+F)尋找關鍵字,亦可直接選取並複製文字。
- 可點擊的超連結:在 Markdown 中設定的
[連結文字](網址)語法,在匯出為 PDF 後仍會保持作用,讀者點擊該連結即可直接開啟瀏覽器存取目標網頁。
編輯器操作規則與狀態顯示
編輯器提供「撰寫」與「預覽」兩種檢視模式切換,並支援「深色編輯器」模式以適應不同的工作環境。在編輯過程中,系統會即時統計並顯示「字數」與「字元」。
系統在不同操作狀態下會顯示對應的提示訊息:
- 初始狀態:編輯器未輸入內容時,預覽區域會顯示「排版後的預覽會顯示在這裡。」,狀態列則顯示「已準備好。撰寫或貼上 Markdown 即可即時預覽。」。
- 清空編輯器:點擊「清空」按鈕後,字數與字元統計會歸零,預覽區域恢復為預設提示,並顯示狀態訊息「編輯區已清空。」。
- 空內容匯出限制:若編輯器內無任何文字,此時點擊「匯出 PDF」,系統不會開啟列印對話框,而是顯示錯誤提示「還沒有內容可匯出——先寫一些 Markdown 吧。」。
常見問題 FAQ
我的 Markdown 會被上傳嗎?
不會。解析、預覽和匯出 PDF 都在你的瀏覽器本機完成。
要怎麼取得 PDF 檔案?
點擊「匯出 PDF」,瀏覽器會開啟列印對話框,將目的地選擇為「另存為 PDF」即可。
匯出的 PDF 文字可以選取嗎?
可以。匯出使用瀏覽器內建的列印引擎,PDF 保留真實可搜尋、可選取的文字與可點擊的連結,不是截圖。
支援哪些 Markdown 語法?
標題、清單、表格、程式碼區塊、引用、連結、圖片、粗體/斜體/刪除線,以及 GitHub 風格的待辦清單。
匯出的 PDF 會如何命名?
PDF 將使用 Markdown 中的第一個 # 標題作為其標題與建議的檔案名稱。如果您的 Markdown 沒有一級標題,它將匯出為「未命名文件」。