前言
Jupyter Notebook（.ipynb）是數據分析、機器學習、科學研究與教育領域常用的互動式筆記本格式。無論是團隊報告、學術論文、技術分享，許多時候都需要將 Notebook 內容以 PDF 形式輸出，方便分享、列印或存檔。不同情境下，轉檔需求也各有不同：有時需保留完整程式碼與輸出，有時則希望隱藏部分內容或美化版面。本文將從實務角度，系統介紹各種 ipynb 轉 PDF 方法，協助你根據需求選擇最合適方案。
轉換前的準備
選擇轉檔方式（本地 vs 線上）
| 方式 | 優點 | 限制與適用情境 |
|---|---|---|
| 本地轉檔 | 高度自訂、可批次處理、隱私性高 | 需安裝多種軟體，環境配置較複雜 |
| 線上工具 | 無需安裝、操作簡單、快速 | 需上傳檔案，資料安全需注意，部分功能有限 |
| 其他替代方案 | 無需 LaTeX，適合臨時需求 | 格式美觀度有限，功能較單純 |
建議：
– 若需高度自訂、批次處理或涉及敏感資料，建議使用本地轉檔。
– 臨時轉檔、無法安裝環境時，可選擇線上工具或簡易替代方案。
必要軟體與環境安裝（本地轉檔）
要在本地將 ipynb 轉為 PDF，需安裝以下工具：
-
Python 與 Jupyter Notebook
安裝 Anaconda（推薦）或直接用 pip 安裝 Jupyter。
bash
pip install jupyter -
nbconvert
Jupyter 內建 nbconvert，若需更新可執行：
bash
pip install --upgrade nbconvert -
LaTeX 發行版
nbconvert 轉 PDF 須依賴 LaTeX。建議安裝 TeX Live（Linux/Mac）或 MiKTeX（Windows）。 - Windows：下載並安裝 MiKTeX
- Mac：建議用 Homebrew 安裝 MacTeX
- Linux：可用 apt 安裝 TeX Live
bash
# Ubuntu/Debian
sudo apt-get install texlive-xetex texlive-fonts-recommended texlive-generic-recommended
常見安裝問題與排解
| 問題現象 | 可能原因 | 解決方法 |
|---|---|---|
| 找不到 nbconvert 命令 | Python 路徑未設置 | 確認已啟用正確 Python 環境，或手動加路徑 |
| 轉檔時出現 LaTeX 缺包錯誤 | LaTeX 發行版不完整 | 依照錯誤訊息安裝缺少的 LaTeX 套件 |
| 轉檔過程卡住或失敗 | 記憶體不足、檔案過大 | 嘗試分段轉檔，或增加系統資源 |
實例說明：
若出現 xelatex not found，代表 LaTeX 未正確安裝，可重新安裝 TeX Live 或 MiKTeX，並重啟終端機。
使用 Jupyter nbconvert 將 ipynb 轉換為 PDF
基本轉換步驟
- 開啟命令提示字元或終端機，切換到 ipynb 檔案所在目錄。
- 執行以下指令：
bash
jupyter nbconvert --to pdf your_notebook.ipynb
執行後，會在同一目錄下產生your_notebook.pdf。
真實案例：
某數據分析團隊需將分析流程與結果匯出 PDF，方便跨部門審閱。透過 nbconvert，能保留完整程式碼、圖表與說明，確保溝通無落差。
進階用法：自訂模板與命令行選項
-
自訂模板：
若需美化版面或統一格式，可自訂 LaTeX 模板（.tplx），並指定：
bash
jupyter nbconvert --to pdf --template=your_template.tplx your_notebook.ipynb
常見應用如：加上公司 Logo、調整頁邊距、變更字型等。 -
常用命令行選項：
| 選項 | 功能說明 | 範例 |
|————–|——————————|——————————-|
| –no-input | 隱藏所有輸入程式碼 | jupyter nbconvert –to pdf –no-input your_notebook.ipynb |
| –output | 指定輸出檔名 | jupyter nbconvert –to pdf –output=final_report.pdf your_notebook.ipynb |
| –no-prompt | 隱藏 In/Out 提示 | jupyter nbconvert –to pdf –no-prompt your_notebook.ipynb |
應用情境：
– 教學簡報時，常需隱藏程式碼僅保留說明與結果。
– 報告正式提交時，指定檔名與模板，確保格式一致。
批次轉換與自動化腳本
若需一次轉換多個 Notebook，可用簡單腳本自動化：
for file in *.ipynb; do
jupyter nbconvert --to pdf "$file"
done
產業應用：
教育機構批次匯出學生作業、企業定期產出多份分析報告時，能大幅提升效率。
線上工具轉換 ipynb 為 PDF
主流線上工具推薦與比較
| 工具名稱 | 特色與優點 | 限制與適用情境 |
|---|---|---|
| Vertopal | 支援多格式轉換，操作簡單 | 檔案大小有限制，需上傳雲端 |
| Ploomber | 轉檔效果佳，支援 LaTeX/Markdown | 需註冊帳號，部分功能需付費 |
適用情境：
– 臨時轉檔、無法安裝本地環境時。
– 需快速分享成果給非技術同仁。
操作步驟與注意事項
- 上傳 ipynb 檔案至線上平台。
- 選擇輸出格式為 PDF。
- 下載轉換後的 PDF 檔案。
注意事項：
– 檔案含敏感資料時，請評估資料安全風險。
– 部分平台對檔案大小或格式有額外限制。
其他常見轉檔方法
轉 HTML 再列印為 PDF（無需安裝 LaTeX）
若本地無法安裝 LaTeX，可先將 Notebook 轉為 HTML，再用瀏覽器列印為 PDF：
- 轉換為 HTML：
bash
jupyter nbconvert --to html your_notebook.ipynb - 用瀏覽器開啟 HTML 檔案，選擇「列印」→「另存為 PDF」。
限制說明：
– 數學公式、特殊排版可能與原 Notebook 有差異。
– 適合臨時需求或格式要求不高的場合。
轉檔效果展示與常見問題
轉檔效果範例（數學公式、圖表、Markdown 等）
- 數學公式：LaTeX 轉檔效果最佳，線上工具或 HTML 轉檔可能有部分公式顯示不完整。
- 圖表/圖片：本地轉檔與主流線上工具多能正確保留，若圖片丟失，請檢查圖片路徑設定。
- Markdown 標記：大多數方法均可正確渲染，但複雜格式建議先預覽。
常見問題與解決方案
| 問題描述 | 可能原因 | 解決建議 |
|---|---|---|
| PDF 格式跑版、內容溢出 | 模板不相容、字型問題 | 嘗試更換模板或調整頁邊距 |
| 圖片未顯示 | 路徑錯誤、格式不支援 | 確認圖片為相對路徑且格式正確 |
| PDF 檔案過大 | 圖片過多、解析度過高 | 壓縮圖片或用 PDF 編輯工具壓縮 |
| 轉檔失敗、報錯 | LaTeX 缺包、記憶體不足 | 依錯誤訊息安裝缺包，或分段轉檔 |
常見FAQ
Q1：如何只保留輸出結果，不顯示程式碼？
A：加上 --no-input 參數即可隱藏所有輸入程式碼。
Q2：轉檔後 PDF 太大怎麼辦？
A：可先壓縮圖片，或用如 pdfFiller 等 PDF 工具進行壓縮與優化。
Q3：如何自訂轉檔後的版面與樣式？
A：可編輯 LaTeX 模板（.tplx），或選擇支援自訂樣式的線上工具。
Q4：線上工具轉檔會不會有資安疑慮？
A：若內容涉及敏感資料，建議選擇本地轉檔，避免資料外洩風險。
Q5：批次轉換多個 Notebook 有推薦方法嗎？
A：可用 shell script 或 Python 批次執行 nbconvert 指令。
結語與工具推薦
將 Jupyter Notebook 轉換為 PDF，無論是本地還是線上方法，都有其適用情境。若需高度自訂、批次處理或保障資料安全，建議採用本地 nbconvert 方案；臨時需求或無法安裝環境時，線上工具則更為便利。若轉檔後需進一步編輯、簽署或壓縮 PDF，可考慮如 pdfFiller 等專業 PDF 處理工具，協助你高效完成文件流轉與管理。
