Markdown 語法基礎與技術文件應用
Markdown 是一種輕量級的標記語言，廣泛應用於撰寫技術文件、README 說明檔案、個人筆記或短篇文章。這種語法允許創作者使用純文字格式編寫內容，並透過簡單的符號來定義文件的結構。
在技術寫作與內容創作中，結構化的文件元素至關重要。本工具支援多種常見的 Markdown 語法，包括：
- 標題與層級：使用不同數量的
#符號來建立多級標題。 - 清單與待辦事項：支援無序清單、有序清單，以及 GitHub 風格的待辦清單（Task Lists）。
- 引用與強調：使用
>建立區塊引用，並支援粗體、斜體與刪除線等強調樣式。 - 程式碼與表格：可插入程式碼區塊以呈現技術內容，並能利用管道符號與虛線繪製結構化表格。
- 連結與圖片：直接嵌入超連結與圖片網址。
透過這些語法，知識工作者能夠快速建立結構清晰、易於閱讀的文件，並在需要反覆修改草稿時，保持內容的高度可讀性與一致性。
瀏覽器本地處理與隱私保護
本工具的所有解析、預覽與 PDF 匯出程序，完全在使用者的網頁瀏覽器本地執行。
當你在編輯器中輸入或貼上 Markdown 內容時，瀏覽器會即時處理資料，整個過程中沒有任何資料會上傳到 BroBroGo 伺服器。這種用戶端處理（Client-side processing）的方式，不僅免除了網路傳輸的時間延遲，實現即時的運算反應，更在技術層面上確保了資料的私密性，適合處理不便外流的個人筆記或工作草稿。
即時預覽與編輯器介面功能
本工具提供「即時預覽」功能，讓創作者在輸入 Markdown 語法的同時，右側會同步呈現排版後的視覺效果。
編輯器介面具備以下功能與狀態顯示：
- 檢視模式切換：使用者可以在「撰寫」與「預覽」視圖之間切換，便於在行動裝置或不同螢幕尺寸下專注於特定工作。
- 深色編輯器：支援深色模式，提供適合低光源環境的撰寫介面。
- 即時字數統計：編輯器下方會即時顯示「字數」與「字元」統計，方便掌握文章長度。
- 狀態提示：
- 初始狀態或準備就緒時，系統會顯示「已準備好。撰寫或貼上 Markdown 即可即時預覽。」。
- 點擊「清空」按鈕後，字數與字元統計會歸零，預覽區域會重設為「排版後的預覽會顯示在這裡。」，並顯示狀態訊息「編輯區已清空。」。
瀏覽器 PDF 產生機制與匯出規則
當點擊「匯出 PDF」按鈕時，本工具會呼叫瀏覽器內建的列印引擎，而非在伺服器端進行轉譯。
匯出步驟與設定
- 點擊「匯出 PDF」後，系統會開啟瀏覽器的列印對話框。
- 使用者需在列印目的地的選項中，手動選擇「另存為 PDF」。
- 在列印視窗中，使用者可自由調整頁面大小、邊界以及是否顯示頁首頁尾等設定。
匯出規則與限制
- 非扁平化影像：匯出的 PDF 檔案並非將畫面截圖存為圖片，而是保留了真實的文字層與連結。這意味著產出的 PDF 文件中，文字是可選取、可搜尋的，且文件內的超連結皆可正常點擊跳轉。
- 空內容阻擋：若編輯器內沒有任何文字，點擊「匯出 PDF」時，瀏覽器列印對話框將不會開啟，且系統會彈出提示訊息「還沒有內容可匯出——先寫一些 Markdown 吧。」。
- 文件命名規則：匯出的 PDF 會自動採用 Markdown 內容中的第一個
#頂級標題作為文件標題與建議檔案名稱。若內容中沒有任何#標題，則會預設匯出為「未命名文件」。
常見問題 FAQ
我的 Markdown 會被上傳嗎？
不會。所有的解析、預覽和匯出 PDF 流程都在你的瀏覽器本地完成，資料不會傳送到任何外部伺服器。
要怎麼取得 PDF 檔案？
點擊「匯出 PDF」按鈕，此時瀏覽器會開啟列印對話框。請將列印目的地選擇為「另存為 PDF」，即可將檔案儲存至你的裝置中。
匯出的 PDF 文字可以選取嗎？
可以。匯出過程使用瀏覽器內建的列印引擎，因此產出的 PDF 會保留真實、可搜尋且可選取的文字，並且保留可點擊的超連結，並非圖片截圖。
支援哪些 Markdown 語法？
支援標題、無序與有序清單、表格、程式碼區塊、引用、連結、圖片、粗體、斜體、刪除線，以及 GitHub 風格的待辦清單。
匯出的 PDF 會使用什麼標題？
PDF 會自動偵測 Markdown 內容中的第一個 # 標題，並將其作為文件的標題與建議儲存檔名。如果你的 Markdown 內容中沒有使用 # 頂級標題，檔案將會預設命名為「未命名文件」。