Markdown Exporter
Markdown Exporter 是一個 Agent 技能,可將你的 Markdown 文字轉換為多種專業格式的檔案。
此 SKILL.md 適用於 Agent 技能,而 CLI 工具與 Python 套件 markdown-exporter 皆維護於 GitHub 儲存庫 bowenliang123/markdown-exporter,由 bowenliang123 管理。
工具與支援的格式
| 工具 | 輸入(Markdown 文字或樣式的檔案路徑) | 輸出(匯出檔案的檔案路徑) |
|---|---|---|
md_to_docx | 📝 Markdown 文字 | 📄 Word 文件 (.docx) |
md_to_html | 📝 Markdown 文字 | 🌐 HTML 檔案 (.html) |
md_to_html_text | 📝 Markdown 文字 | 🌐 HTML 文字字串 |
md_to_jira | 📝 Markdown 文字 | 🅹 Jira wiki 標記文字 |
md_to_pdf | 📝 Markdown 文字 | 📑 PDF 檔案 (.pdf) |
md_to_png | 📝 Markdown 文字 | 🖼️ PNG 圖片 (.png),單一長頁或每頁一張圖片 |
md_to_svg | 📝 Markdown 文字 | 🖼️ SVG 圖片 (.svg),每頁一張圖片 |
md_to_md | 📝 Markdown 文字 | 📝 Markdown 檔案 (.md) |
md_to_ipynb | 📝 Markdown 文字 | 📓 Jupyter Notebook (.ipynb) |
md_to_pptx | 📝 Pandoc 風格的 Markdown 投影片 | 🎯 PowerPoint (.pptx) |
md_to_xlsx | 📋 Markdown 表格 | 📊 Excel 試算表 (.xlsx) |
md_to_csv | 📋 Markdown 表格 | 📋 CSV 檔案 (.csv) |
md_to_json | 📋 Markdown 表格 | 📦 JSON/JSONL 檔案 (.json) |
md_to_xml | 📋 Markdown 表格 | 🏷️ XML 檔案 (.xml) |
md_to_latex | 📋 Markdown 表格 | 📝 LaTeX 檔案 (.tex) |
md_to_codeblock | 💻 Markdown 中的程式碼區塊 | 📁 依語言的程式碼檔案 (.py, .js, .sh 等) |
📦 使用方式
概述
Markdown Exporter 可作為 PyPI 套件使用,提供所有功能的無縫命令列介面。
安裝
# 使用 pip
pip install md-exporter
# 使用 uv
uv tool install md-exporter
# 使用 OpenClaw
npx clawhub install markdown-exporter
檢查 markdown-exporter 命令與用法:
markdown-exporter -h
markdown-exporter <subcommand> -h
基本用法
使用 markdown-exporter 命令存取所有工具:
markdown-exporter <subcommand> <args> [options]
重要注意事項
- 所有命令僅支援檔案路徑作為輸入
- 套件會自動處理所有相依性管理
- 你可以從系統的任何位置執行命令,無需導航至專案目錄
🔧 指令碼
md_to_csv - 將 Markdown 表格轉換為 CSV
將 Markdown 表格轉換為 CSV 格式檔案。
用法:
markdown-exporter md_to_csv <input> <output> [options]
參數:
input- 包含表格的輸入 Markdown 檔案路徑output- 輸出 CSV 檔案路徑
選項:
--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_csv /path/input.md /path/output.csv這會將輸入 Markdown 檔案中的所有表格轉換為 CSV 格式。
-
移除程式碼區塊包裝:
markdown-exporter md_to_csv /path/input.md /path/output.csv --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_pdf - 將 Markdown 轉換為 PDF
將 Markdown 文字轉換為 PDF 格式,支援中文、日文及其他語言。
用法:
markdown-exporter md_to_pdf <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 PDF 檔案路徑
選項:
--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_pdf /path/input.md /path/output.pdf這會將整個 Markdown 檔案轉換為 PDF 文件。
-
移除程式碼區塊包裝:
markdown-exporter md_to_pdf /path/input.md /path/output.pdf --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_png - 將 Markdown 轉換為 PNG
將 Markdown 文字轉換為 PNG 圖片,支援中文、日文及其他語言。
用法:
markdown-exporter md_to_png <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 PNG 檔案路徑
選項:
--multi-page- 匯出每 A4 頁一張 PNG(編號檔案),而非單一長頁 PNG--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換(單一長頁圖片):
markdown-exporter md_to_png /path/input.md /path/output.png這會將整個 Markdown 文件渲染為單一長頁 PNG 圖片。
-
多頁輸出:
markdown-exporter md_to_png /path/input.md /path/output.png --multi-page這會匯出每 A4 頁一張 PNG,儲存為
output_1.png、output_2.png等(當文件有多頁時)。 -
移除程式碼區塊包裝:
markdown-exporter md_to_png /path/input.md /path/output.png --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_svg - 將 Markdown 轉換為 SVG
將 Markdown 文字轉換為 SVG 圖片,每頁一張 SVG,支援中文、日文及其他語言。
用法:
markdown-exporter md_to_svg <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 SVG 檔案路徑
選項:
--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_svg /path/input.md /path/output.svg這會將 Markdown 檔案轉換為 SVG 圖片,儲存為
output_1.svg、output_2.svg等(當文件有多頁時)。 -
移除程式碼區塊包裝:
markdown-exporter md_to_svg /path/input.md /path/output.svg --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_docx - 將 Markdown 轉換為 DOCX
將 Markdown 文字轉換為 DOCX 格式檔案。
用法:
markdown-exporter md_to_docx <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 DOCX 檔案路徑
選項:
--template- DOCX 範本檔案路徑(可選)--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_docx /path/input.md /path/output.docx這會將整個 Markdown 檔案轉換為 DOCX 文件。
-
使用自訂範本:
markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx這會使用自訂的 DOCX 範本進行樣式設定。
-
移除程式碼區塊包裝:
markdown-exporter md_to_docx /path/input.md /path/output.docx --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_xlsx - 將 Markdown 表格轉換為 XLSX
將 Markdown 表格轉換為 XLSX 格式,支援多工作表。
用法:
markdown-exporter md_to_xlsx <input> <output> [options]
參數:
input- 包含表格的輸入 Markdown 檔案路徑output- 輸出 XLSX 檔案路徑
選項:
--force-text- 將儲存格值轉換為文字類型(預設:True)--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx這會將輸入 Markdown 檔案中的所有表格轉換為 XLSX 活頁簿,每個表格位於獨立的工作表中。
-
移除程式碼區塊包裝:
markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
-
停用強制文字:
markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --force-text False這允許 Excel 自動決定儲存格類型。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_pptx - 將 Markdown 轉換為 PPTX
將 Markdown 文字轉換為 PPTX 格式檔案。
用法:
markdown-exporter md_to_pptx <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 PPTX 檔案路徑
選項:
--template- PPTX 範本檔案路徑(可選)
範例:
-
基本轉換:
markdown-exporter md_to_pptx /path/input.md /path/output.pptx這會將 Markdown 檔案轉換為 PowerPoint 簡報。
-
使用自訂範本:
markdown-exporter md_to_pptx /path/input.md /path/output.pptx --template /path/template.pptx這會使用自訂的 PowerPoint 範本進行樣式設定。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 投影片(用於 PPTX)章節中的「投影片(用於 PPTX)」範例。
md_to_codeblock - 將程式碼區塊提取至檔案
從 Markdown 中提取程式碼區塊並儲存為個別檔案。
用法:
markdown-exporter md_to_codeblock <input> <output> [options]
參數:
input- 包含程式碼區塊的輸入 Markdown 檔案路徑output- 輸出目錄路徑或 ZIP 檔案路徑
選項:
--compress- 將所有程式碼區塊壓縮為 ZIP 檔案
範例:
-
提取至目錄:
markdown-exporter md_to_codeblock /path/input.md /path/output_dir這會將所有程式碼區塊提取至指定目錄中的個別檔案。
-
提取至 ZIP 檔案:
markdown-exporter md_to_codeblock /path/input.md /path/output.zip --compress這會提取所有程式碼區塊並壓縮為 ZIP 檔案。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 程式碼區塊章節中的「程式碼區塊」範例。
md_to_json - 將 Markdown 表格轉換為 JSON
將 Markdown 表格轉換為 JSON 或 JSONL 格式檔案。
用法:
markdown-exporter md_to_json <input> <output> [options]
參數:
input- 包含表格的輸入 Markdown 檔案路徑output- 輸出 JSON 檔案路徑
選項:
--style- JSON 輸出樣式:jsonl(預設)或json_array--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換(JSONL 格式):
markdown-exporter md_to_json /path/input.md /path/output.json這會將表格轉換為 JSON Lines 格式(每行一個 JSON 物件)。
-
轉換為 JSON 陣列:
markdown-exporter md_to_json /path/input.md /path/output.json --style json_array這會將表格轉換為單一 JSON 物件陣列。
-
移除程式碼區塊包裝:
markdown-exporter md_to_json /path/input.md /path/output.json --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_xml - 將 Markdown 轉換為 XML
將 Markdown 文字轉換為 XML 格式檔案。
用法:
markdown-exporter md_to_xml <input> <output> [options]
參數:
input- 輸入 Markdown 檔案路徑output- 輸出 XML 檔案路徑
選項:
--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
-
基本轉換:
markdown-exporter md_to_xml /path/input.md /path/output.xml這會將整個 Markdown 檔案轉換為 XML 文件。
-
移除程式碼區塊包裝:
markdown-exporter md_to_xml /path/input.md /path/output.xml --strip-wrapper這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。
範例 Markdown 輸入: 使用下方範例 Markdown 輸入 - 基本文字與表格章節中的「基本文字與表格」範例。
md_to_latex - 將 Markdown 表格轉換為 LaTeX
將 Markdown 表格轉換為 LaTeX 格式檔案。
用法:
markdown-exporter md_to_latex <input> <output> [options]
參數:
input- 包含表格的輸入 Markdown 檔案路徑output- 輸出 LaTeX 檔案路徑
選項:
--strip-wrapper- 若存在則移除程式碼區塊包裝
範例:
...
(以下內容因篇幅截斷)