Communitygithub.com

bowenliang123/markdown-exporter

一個 Agent 技能與 Dify 外掛,可將 Markdown 轉換為 DOCX、PPTX、XLSX、PNG、PDF、HTML、MD、CSV、JSON、XML 等多種檔案格式。

markdown-exporter 是什麼?

Markdown Exporter 是一個專為開發者與 AI 代理(如 Claude Code、Cursor、Codex 等)設計的 Agent 技能,能將 Markdown 文字順暢轉換為多種專業格式的檔案,包括 DOCX、PPTX、XLSX、PNG、PDF、HTML、CSV、JSON、XML 等。它同時以 Python 套件(`md-exporter`)形式發布,提供統一的命令列介面,支援 pip、uv 與 OpenClaw 安裝。此技能在 Dify 平台上亦作為外掛使用,讓 AI 工作流程能直接輸出結構化文件。除了基礎轉換,它還支援進階功能如多頁 PNG 輸出、自訂範本(DOCX/PPTX)、程式碼區塊提取至個別檔案或 ZIP、以及表格轉換為 Excel 含多工作表。透過 Pandoc 風格的投影片分隔,也可將 Markdown 呈現為 PowerPoint 簡報。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add bowenliang123/markdown-exporter

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_csv /path/input.md /path/output.csv
    

    這會將輸入 Markdown 檔案中的所有表格轉換為 CSV 格式。

  2. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_pdf /path/input.md /path/output.pdf
    

    這會將整個 Markdown 檔案轉換為 PDF 文件。

  2. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換(單一長頁圖片):

    markdown-exporter md_to_png /path/input.md /path/output.png
    

    這會將整個 Markdown 文件渲染為單一長頁 PNG 圖片。

  2. 多頁輸出:

    markdown-exporter md_to_png /path/input.md /path/output.png --multi-page
    

    這會匯出每 A4 頁一張 PNG,儲存為 output_1.png、output_2.png 等(當文件有多頁時)。

  3. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_svg /path/input.md /path/output.svg
    

    這會將 Markdown 檔案轉換為 SVG 圖片,儲存為 output_1.svg、output_2.svg 等(當文件有多頁時)。

  2. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_docx /path/input.md /path/output.docx
    

    這會將整個 Markdown 檔案轉換為 DOCX 文件。

  2. 使用自訂範本:

    markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx
    

    這會使用自訂的 DOCX 範本進行樣式設定。

  3. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx
    

    這會將輸入 Markdown 檔案中的所有表格轉換為 XLSX 活頁簿,每個表格位於獨立的工作表中。

  2. 移除程式碼區塊包裝:

    markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper
    

    這會在處理 Markdown 之前移除任何程式碼區塊包裝(```)。

  3. 停用強制文字:

    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 範本檔案路徑(可選)

範例:

  1. 基本轉換:

    markdown-exporter md_to_pptx /path/input.md /path/output.pptx
    

    這會將 Markdown 檔案轉換為 PowerPoint 簡報。

  2. 使用自訂範本:

    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 檔案

範例:

  1. 提取至目錄:

    markdown-exporter md_to_codeblock /path/input.md /path/output_dir
    

    這會將所有程式碼區塊提取至指定目錄中的個別檔案。

  2. 提取至 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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換(JSONL 格式):

    markdown-exporter md_to_json /path/input.md /path/output.json
    

    這會將表格轉換為 JSON Lines 格式(每行一個 JSON 物件)。

  2. 轉換為 JSON 陣列:

    markdown-exporter md_to_json /path/input.md /path/output.json --style json_array
    

    這會將表格轉換為單一 JSON 物件陣列。

  3. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

  1. 基本轉換:

    markdown-exporter md_to_xml /path/input.md /path/output.xml
    

    這會將整個 Markdown 檔案轉換為 XML 文件。

  2. 移除程式碼區塊包裝:

    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 - 若存在則移除程式碼區塊包裝

範例:

...

(以下內容因篇幅截斷)

相關技能