Markdown 實用指南

Markdown 轉 PDF。
就在您的裝置上。

將筆記、文件或草稿轉為 PDF,無須上傳至轉檔服務。Syncphonia 會排版您的 Markdown,並開啟系統或瀏覽器列印對話框,供您選擇 PDF 目的地。

比較原始檔與完成的文件

下載同一份英文專案簡介的 Markdown 原始檔可編輯的 Word 文件完成的 PDF。安裝前先比較標題、表格及檢查清單。Word 使用本機 Pandoc 匯出;PDF 使用 Syncphonia 的列印版面。

如何將 Markdown 檔案匯出為 PDF

  1. 開啟或撰寫 Markdown

    開啟 .md 檔案或建立文件,照常使用標題、清單、表格及圍欄式程式碼區塊。若相對路徑圖片或參考書目檔案需要固定資料夾,請先儲存原稿。

  2. 選擇「發佈與匯出 → PDF」

    直接列印可在 Mac 按下 ⌘ P,或在 Linux 按下 Ctrl P。分享前請檢查排版後的文件。

  3. 設定頁面

    選擇紙張大小、方向及邊界。決定是否列印背景色與程式碼底色,以及 Mermaid 圖表要繪製成圖,或保留為可讀原始碼。

  4. 選擇「列印/另存為 PDF…」

    在系統或瀏覽器列印對話框中,選擇 PDF 目的地並儲存。實際控制項依作業系統與瀏覽器而異。開啟產生的 PDF,逐頁檢查。

PDF 使用列印流程,無須選用的 Pandoc 匯出引擎。請保留原始 .md 檔案及圖片:PDF 是排版後的副本,不是可編輯原稿。

試用用的小文件

將此內容貼入 Syncphonia Light 的原始碼檢視,再切換至閱讀檢視並列印。

# Project update

## What changed

- Finished the first draft
- Reviewed the installation steps
- Prepared a PDF for sharing

| Item | Status |
| --- | --- |
| Draft | Ready |
| Review | Complete |

## Next step

Send the reviewed PDF and keep this Markdown as the source.

PDF 外觀不如預期時

列印視窗未開啟

允許瀏覽器開啟「列印」操作產生的視窗,然後再試一次。在 Light 中,瀏覽器的彈出式視窗設定可能阻止列印介面開啟。

缺少圖片

確認相對於已儲存 Markdown 檔案的路徑正確,且應用程式或瀏覽器可存取圖片。瀏覽器可能需要所在資料夾的權限。列印前先確認圖片出現在排版後的文件中。

Mermaid 圖表顯示原始碼

在列印設定中啟用圖表繪製,並修正 Mermaid 語法錯誤。確認圖表能放入所選頁面寬度。

分頁或程式碼區塊排版不佳

調整邊界或方向、縮短過長的行,並檢查文件結構。以 100% 縮放檢查最終 PDF,包括表格、連結、圖片及最後一頁。

需要可編輯的 Word 文件?

桌面應用程式也可透過選用的本機 Pandoc 引擎,將 Markdown 匯出為 Word、EPUB、LaTeX 及 OpenDocument。引擎會在您選擇安裝時另外下載。比較 Light 與桌面版,選擇所需的工作流程。