Markdown 导出器
Markdown 导出器是一个 Agent 技能，可将您的 Markdown 文本转换为各种专业格式的文件。
这个适用于 Agent 技能的 SKILL.md、CLI 工具和 Python 包 markdown-exporter 由 bowenliang123 在 GitHub 仓库 bowenliang123/markdown-exporter 中维护。
工具与支持的格式
| 工具 | 输入（Markdown 文本或样式的文件路径） | 输出（导出文件的文件路径） |
|---|---|---|
md_to_docx | 📝 Markdown 文本 | 📄 Word 文档 (.docx) |
md_to_html | 📝 Markdown 文本 | 🌐 HTML 文件 (.html) |
md_to_html_text | 📝 Markdown 文本 | 🌐 HTML 文本字符串 |
md_to_jira | 📝 Markdown 文本 | 🅹 Jira 维基标记文本 |
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 导出器作为一个 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 <子命令> -h
基本用法
使用 markdown-exporter 命令访问所有工具：
markdown-exporter <子命令> <参数> [选项]
重要说明
- 所有命令仅支持文件路径作为输入
- 该包会自动处理所有依赖管理
- 您可以从系统中的任何位置运行该命令，无需导航到项目目录
🔧 脚本
md_to_csv - 将 Markdown 表格转换为 CSV
将 Markdown 表格转换为 CSV 格式文件。
用法：
markdown-exporter md_to_csv <输入> <输出> [选项]
参数：
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- 输入 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- 输入 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- 输入 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- 输入 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- 包含表格的输入 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- 输入 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- 包含代码块的输入 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- 包含表格的输入 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- 输入 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- 包含表格的输入 Markdown 文件路径output- 输出 LaTeX 文件路径
选项：
--strip-wrapper- 如果存在，移除代码块包装器
示例：
…
[为翻译而截断]