Markdown 轉 PDF 轉換器

Markdown 轉 PDF 轉換器可將 Markdown 來源文字轉換為固定版面的 PDF 文件。

Markdown 使用純文字語法來表示標題、段落、強調、連結、清單、表格、區塊引用、程式碼和其他文件元素。轉換器會解析該結構，渲染支援的技術內容，套用列印樣式，并建立無需 Markdown 編輯器即可分享、審閱、封存或列印的 PDF。

「MD 轉 PDF」代表相同的意義。MD 是 Markdown 的常見縮寫，而 .md 是 Markdown 文件常用的副檔名。

.md 檔案是一個純文字 Markdown 文件。SolConverter 接受 .md 和 .txt 來源檔案，並透過線上工作流程將支援的 Markdown 內容轉換為 PDF。

當您想將 Markdown 保留為可编辑來源，但需要為客戶、同事、學生、審閱者或不使用 Markdown 的人提供穩定的文件時，這非常有用。

描述同一任務的常見方式包括：

• Markdown 轉 PDF
• MD 轉 PDF
• Markdown 檔案轉 PDF
• .md 檔案轉 PDF
• 將 Markdown 轉換為 PDF
• 將 Markdown 匯出為 PDF
• 將 Markdown 儲存為 PDF

本頁面可滿足所有這些轉換需求。

SolConverter 渲染技術和通用文件中常用的 Markdown 結構。

支援的內容包括：

• ATX 和 Setext 標題；
• 段落、換行符和水平線；
• 粗體、斜體和刪除線文字；
• 有序和無序清單，包括巢狀清單；
• 帶核取方塊的 GFM 工作清單；
• 區塊引用和巢狀區塊引用；
• 行內程式碼和圍欄程式碼塊；
• Markdown 連結、網頁自動連結和電子郵件自動連結；
• 帶左對齊、居中和右對齊的 GFM 表格；
• 受控 rowspan 和 colspan 的安全原始 HTML 表格；
• 諸如 details、summary、kbd、sub、sup、figure 和 figcaption 的文件元素；
• 標題錨點；
• 檔案開頭的 YAML 前導資料（YAML front matter），被視為詮釋資料（metadata）而非列印內容。

格式錯誤的程式碼圍欄或分隔符會儘可能保持在局部，因此格式問題不會影響文件的其餘部分。

SolConverter 將支援的 LaTeX 和 MathML 渲染為 MathJax SVG。在放大或列印 PDF 時，SVG 輸出能保持清晰。

公式處理管道在 Markdown 解析之前識別運算式，这有助於保護底線、星號、顯示分隔符和公式環境不被 Markdown 解析器變更。

支援的公式輸入包括：

• 使用 $...$ 和 \(...\) 的行内公式；
• 使用 $$...$$ 和 \[...\] 的獨立行公式；
• 常見的 AMS 環境，如 equation、align、gather、multline、split 和 cases；
• 分數、根式、冪、索引、求和、連乘、積分、極限和級數；
• 矩陣、行列式、陣列和張量表示法；
• 微積分、微分方程、線性代數、機率、統計、物理和化學表示法；
• Presentation MathML 和基礎 Content MathML 操作；
• 用 \ce{...} 撰寫的化學式；
• 文件範圍的巨集，如 \newcommand 和 \DeclareMathOperator。

長的加法運算式可以在頂級運算子處拆分，而不是在頁面邊緣被裁剪或縮小到難以閱讀的程度。當瀏覽器可以在頁面上容納該區塊時，獨立行公式將保持在一起。

SolConverter 將格式錯誤的數學公式隔離在發生問題的具體位置。

當 LaTeX 或 MathML 區塊無法安全渲染時，轉換器可以保留中性的來源文字後備內容，並繼續渲染其後的有效內容。圖表和圖片也採用相同的局部失效處理方法。

這對於長篇技術文件非常重要。一個受損的公式、一個不可用的圖片或一個無效的圖表不應自動廢棄其周圍的每個有效頁面。

支援的 Mermaid 圍欄區塊在 PDF 內被渲染为 SVG。ZenUML 透過本地捆綁的 Mermaid 外部圖表整合進行支援。

每個有效的圖表都是獨立渲染的，並限制在可用的頁面寬度內。如果圖表渲染失敗，SolConverter 會插入包含來源文字的局部後備，並繼續處理文件的其餘部分。

目前支援的圖表引擎是 Mermaid 和 ZenUML。目前不支援 PlantUML、Graphviz、D2、WaveDrom、BPMN、Nomnoml 和完整 TikZ。

技術文件經常混合了解釋、命令、設定和原始碼。當識別出圍欄程式碼塊的語言時，SolConverter 使用 Highlight.js 套用語法高亮。

程式碼輸出包括：

• 專用的等寬字型；
• 圍欄區塊的偏好背景、邊框和內距；
• 從程式碼圍欄資訊字串中偵測語言；
• 語言未識別時安全地輸出來源文字；
• 防止解析程式碼內部的數學分隔符；
• 自右向左（RTL）文件中程式碼的自左向右（LTR）隔離。

因此，PDF 將程式碼與周圍的正文在視覺上隔離開來，同時保留原始來源文字。

SolConverter 從內容中偵測文件方向，並透過適當的字型回退支援多語言 PDF。

支援的文字場景包括：

• 越南語和延伸拉丁字元；
• 阿拉伯語和希伯來語版面配置；
• 中文、日文和韓文文字；
• 印度系文字；
• 西里爾字母和希臘字母；
• 混合文字文件；
• 組合標記；
• 許多 Unicode 符號和表情符號，具體取決於可用字型的覆蓋範圍。

即使主文件方向是自右向左，數學公式和程式碼仍保持自左向右。

SolConverter 支援公開的 HTTP 和 HTTPS 圖片，以及 PNG、GIF、JPEG、WebP 和 SVG 格式的有效 base64 資料圖片。

圖片在保持寬高比的同時被限制在頁面寬度內。支援的圖片詮釋資料（metadata）包括替代文字（alt）、標題、安全尺寸、對齊方式、插圖和說明文字。

不可用或無效的圖片將被替換為包含其替代文字的本地預留位置。然後轉換器繼續處理 Markdown 的其餘部分，而不是讓整個 PDF 轉換失敗。

出於安全考量，本地路徑、localhost 位址、私有 IP 字面量、javascript: URL 和不支援的協定方案將被封鎖。版本庫相對的資源資料夾不會與上傳的 Markdown 檔案自動打包。

轉換器為技術文件、筆記、報告和列印輸出套用一致的 PDF 版面配置。

目前的網頁表單使用：

• A4 頁面大小；
• 縱向；
• 管理頁邊距以實現易讀的輸出；
• 目前頁 / 總頁數 格式的頁碼；
• 基於來源檔名的輸出標題；
• 列印背景。

渲染系統還套用了基本的列印版面配置保護。它嘗試避免在頁面底部留下孤立的標題，減少文字區塊中的孤行和寡行，在瀏覽器支援時重複表格頁首，並在頁面空間足夠時避免拆分程式碼區塊、表格行、插圖、圖片、圖表和獨立行公式。

簡單的 Markdown 很容易匯出。長篇技術 Markdown 則更為困難，因為公式、圖表、表格、程式碼、多語言文字、外部圖片和分頁都會相互作用。

SolConverter 圍繞這種更苛刻的用例進行設計。其 Markdown 轉 PDF 管道包括 MathJax SVG 渲染、Mermaid 和 ZenUML、語法高亮、Unicode 和 RTL 支援、內容安全過濾、網路控制、區塊級故障隔離、工作進度以及獨立的預覽 and 下載結果。

上傳的 Markdown 可能包含原始 HTML、圖片 URL 和其他不應被自動信任的內容。

SolConverter 使用白名單（允許清單）過濾渲染的 HTML，移除指令碼和事件處理常式，拒絕不安全的 URL，限制表格跨度，套用限制性的內容安全政策（CSP），並攔截超出圖片政策範圍的瀏覽器請求。

有效的 base64 資料圖片可以在沒有網路請求的情況下進行渲染。公開的遠端圖片可透過圖片政策被允許，而本地、私有和不支援的目的地將被封鎖。

如果尚未開始轉換，新上傳的檔案將在 15 分鐘後過期。在轉換成功且輸出經過驗證後，來源檔案將被刪除；失敗的輸入檔案將在原來的 15 分鐘視窗內過期。完成的 PDF 可保留長達兩個小時。請參閱 隱私政策 了解完整的生命周期。

Markdown 在撰寫和版本控制方面效率很高。當文件需要穩定的外觀和廣泛支援的傳遞格式時，PDF 非常有用。

當您需要滿足以下需求時，您可能會想將 Markdown 轉換為 PDF：

• 在版本庫外部傳送技術文件；
• 交付固定格式的報告、規格說明書、建議書或操作手冊（runbook）；
• 建立可列印的學習筆記或培訓材料；
• 將 README 或變更日誌分發給非技術讀者；
• 以基於頁面的格式審閱公式和圖表；
• 封存不斷變化的文件的特定版本；
• 分享文件而無需 Markdown 編輯器；
• 保留可編輯的 Markdown 來源並產生單獨的傳遞檔案。

線上 Markdown 轉 PDF 轉換器最適合您想要直接上傳、託管渲染、預覽和下載的工作流程，而無需設定本地工具鏈。

當您需要離線轉換、自訂範本、任意 CSS、引文處理、指令碼化建置管道或在版本庫內進行批次轉換時，Pandoc 或編輯器擴充功能等本地工具可能是更好的選擇。

SolConverter 專注於為單個上傳的文件提供託管的 Markdown 轉 PDF 渲染。目前它不提供完整的 Pandoc 引文支援、任意使用者 CSS、自動 PDF 書籤、打包的相對資源資料夾或每種圖表語言。

技術文件

將架構設計筆記、API 說明、操作手冊、發布文件、規格說明書和內部指南轉換為穩定的 PDF。

數學和科學文件

將支援的 LaTeX、MathML、矩陣、公式、化學表示法和長運算式渲染為 PDF 中基於 SVG 的數學公式。

開發者文件

將程式碼圍欄、行內程式碼、表格、任務清單、圖表和結構化解釋整合到一個文件中，以便在版本庫之外進行審閱。

多語言報告

建立包含越南語、CJK（中日韓）、阿拉伯語、希伯來語、西里爾字母、希臘字母、印度系文字以及混合自左向右和自右向左內容的 PDF。

筆記、報告和建議書

用 Markdown 撰寫，然後建立用於列印、審批、分享或封存的固定格式文件。

當來源格式或期望的輸出不同時，請使用另一個 SolConverter 工具。

• 將檔案轉換為 Markdown
• 將 PDF 轉換為 Markdown
• 將 Word 轉換為 Markdown
• 將 HTML 轉換為 Markdown
• 將 Excel 轉換為 Markdown
• 將 CSV 轉換為 Markdown
• 瀏覽資料轉換器
• 將 JSON 轉換為 CSV
• 將 CSV 轉換為 JSON