📦 Markdown Exporter — 转多格式导出

# Markdown Exporter Markdown Exporter 是一个 Agent Skill，可将你的 Markdown 文本转换为多种专业格式文件。此 SKILL.md 以及命令行工具和 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_pdf | 📝 Markdown 文本 | 📑 PDF 文件 (.pdf) | | md_to_png | 📝 Markdown 文本 | 🖼️ PDF 页面 PNG 图片 | | 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 包形式提供，为所有功能提供无缝的命令行接口。 ### 安装 ``bash # 使用 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 命令访问所有工具： `bash markdown-exporter <子命令> <参数> [选项] ` ### 重要说明 - 所有命令仅支持文件路径作为输入 - 包自动处理所有依赖管理 - 可在系统任意位置运行，无需进入项目目录 ## 🔧 脚本 ### md_to_csv - 将 Markdown 表格转为 CSV 将 Markdown 表格转换为 CSV 格式文件。 用法： `bash markdown-exporter md_to_csv <输入> <输出> [选项] ` 参数： - 输入 - 包含表格的输入 Markdown 文件路径 - 输出 - 输出 CSV 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_csv /path/input.md /path/output.csv ` 将输入 Markdown 文件中的所有表格转换为 CSV 格式。 2. 移除代码块包装符： `bash markdown-exporter md_to_csv /path/input.md /path/output.csv --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_pdf - 将 Markdown 转为 PDF 将 Markdown 文本转换为 PDF 格式，支持中文、日文等多语言。 用法： `bash markdown-exporter md_to_pdf <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 PDF 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_pdf /path/input.md /path/output.pdf ` 将整个 Markdown 文件转换为 PDF 文档。 2. 移除代码块包装符： `bash markdown-exporter md_to_pdf /path/input.md /path/output.pdf --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_docx - 将 Markdown 转为 DOCX 将 Markdown 文本转换为 DOCX 格式文件。 用法： `bash markdown-exporter md_to_docx <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 DOCX 文件路径 选项： - --template - DOCX 模板文件路径（可选） - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_docx /path/input.md /path/output.docx ` 将整个 Markdown 文件转换为 DOCX 文档。 2. 使用自定义模板： `bash markdown-exporter md_to_docx /path/input.md /path/output.docx --template /path/template.docx ` 使用自定义 DOCX 模板进行样式设置。 3. 移除代码块包装符： `bash markdown-exporter md_to_docx /path/input.md /path/output.docx --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_xlsx - 将 Markdown 表格转为 XLSX 将 Markdown 表格转换为 XLSX 格式，支持多工作表。 用法： `bash markdown-exporter md_to_xlsx <输入> <输出> [选项] ` 参数： - 输入 - 包含表格的输入 Markdown 文件路径 - 输出 - 输出 XLSX 文件路径 选项： - --force-text - 将单元格值转为文本类型（默认：True） - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx ` 将输入 Markdown 文件中的所有表格转换为 XLSX 工作簿，每个表格单独工作表。 2. 移除代码块包装符： `bash markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 3. 禁用 force-text： `bash markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx --force-text False ` 允许 Excel 自动确定单元格类型。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_pptx - 将 Markdown 转为 PPTX 将 Markdown 文本转换为 PPTX 格式文件。 用法： `bash markdown-exporter md_to_pptx <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 PPTX 文件路径 选项： - --template - PPTX 模板文件路径（可选） 示例： 1. 基本转换： `bash markdown-exporter md_to_pptx /path/input.md /path/output.pptx ` 将 Markdown 文件转换为 PowerPoint 演示文稿。 2. 使用自定义模板： `bash markdown-exporter md_to_pptx /path/input.md /path/output.pptx --template /path/template.pptx ` 使用自定义 PowerPoint 模板进行样式设置。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 幻灯片（用于 PPTX） 中的“幻灯片（用于 PPTX）”示例。 --- ### md_to_codeblock - 提取代码块到文件 从 Markdown 提取代码块并保存为独立文件。 用法： `bash markdown-exporter md_to_codeblock <输入> <输出> [选项] ` 参数： - 输入 - 包含代码块的输入 Markdown 文件路径 - 输出 - 输出目录路径或 ZIP 文件路径 选项： - --compress - 将所有代码块压缩为 ZIP 文件 示例： 1. 提取到目录： `bash markdown-exporter md_to_codeblock /path/input.md /path/output_dir ` 将所有代码块提取为指定目录下的独立文件。 2. 提取到 ZIP 文件： `bash markdown-exporter md_to_codeblock /path/input.md /path/output.zip --compress ` 将所有代码块提取并压缩为 ZIP 文件。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 代码块 中的“代码块”示例。 --- ### md_to_json - 将 Markdown 表格转为 JSON 将 Markdown 表格转换为 JSON 或 JSONL 格式文件。 用法： `bash markdown-exporter md_to_json <输入> <输出> [选项] ` 参数： - 输入 - 包含表格的输入 Markdown 文件路径 - 输出 - 输出 JSON 文件路径 选项： - --style - JSON 输出样式：jsonl（默认）或 json_array - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换（JSONL 格式）： `bash markdown-exporter md_to_json /path/input.md /path/output.json ` 将表格转换为 JSON Lines 格式（每行一个 JSON 对象）。 2. 转换为 JSON 数组： `bash markdown-exporter md_to_json /path/input.md /path/output.json --style json_array ` 将表格转换为单个 JSON 对象数组。 3. 移除代码块包装符： `bash markdown-exporter md_to_json /path/input.md /path/output.json --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_xml - 将 Markdown 转为 XML 将 Markdown 文本转换为 XML 格式文件。 用法： `bash markdown-exporter md_to_xml <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 XML 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_xml /path/input.md /path/output.xml ` 将整个 Markdown 文件转换为 XML 文档。 2. 移除代码块包装符： `bash markdown-exporter md_to_xml /path/input.md /path/output.xml --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_latex - 将 Markdown 表格转为 LaTeX 将 Markdown 表格转换为 LaTeX 格式文件。 用法： `bash markdown-exporter md_to_latex <输入> <输出> [选项] ` 参数： - 输入 - 包含表格的输入 Markdown 文件路径 - 输出 - 输出 LaTeX 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_latex /path/input.md /path/output.tex ` 将输入 Markdown 文件中的所有表格转换为 LaTeX 格式。 2. 移除代码块包装符： `bash markdown-exporter md_to_latex /path/input.md /path/output.tex --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_html - 将 Markdown 转为 HTML 将 Markdown 文本转换为 HTML 格式文件。 用法： `bash markdown-exporter md_to_html <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 HTML 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_html /path/input.md /path/output.html ` 将整个 Markdown 文件转换为 HTML 文档。 2. 移除代码块包装符： `bash markdown-exporter md_to_html /path/input.md /path/output.html --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_html_text - 将 Markdown 转为 HTML 文本 将 Markdown 文本转换为 HTML 并输出到标准输出。 用法： `bash markdown-exporter md_to_html_text <输入> ` 参数： - 输入 - 输入 Markdown 文件路径 示例： `bash markdown-exporter md_to_html_text /path/input.md ` 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_png - 将 Markdown 转为 PNG 图片 将 Markdown 文本转换为 PNG 图片（每页一张）。 用法： `bash markdown-exporter md_to_png <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 PNG 文件路径或目录路径 选项： - --compress - 将所有 PNG 图片压缩为 ZIP 文件 - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_png /path/input.md /path/output.png ` 将 Markdown 文件转换为 PNG 图片（每页一张）。 2. 带压缩： `bash markdown-exporter md_to_png /path/input.md /path/output.png --compress ` 将 Markdown 文件转换为 PNG 图片并压缩为 ZIP 文件。 3. 移除代码块包装符： `bash markdown-exporter md_to_png /path/input.md /path/output.png --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_md - 将 Markdown 转为 MD 文件 将 Markdown 文本保存为 .md 文件。 用法： `bash markdown-exporter md_to_md <输入> <输出> ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 MD 文件路径 示例： `bash markdown-exporter md_to_md /path/input.md /path/output.md ` 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 基本文本与表格 中的“基本文本与表格”示例。 --- ### md_to_ipynb - 将 Markdown 转为 IPYNB 将 Markdown 文本转换为 Jupyter Notebook (.ipynb) 格式文件。 用法： `bash markdown-exporter md_to_ipynb <输入> <输出> [选项] ` 参数： - 输入 - 输入 Markdown 文件路径 - 输出 - 输出 IPYNB 文件路径 选项： - --strip-wrapper - 如果存在代码块包装符则移除 示例： 1. 基本转换： `bash markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb ` 将 Markdown 文件转换为 Jupyter Notebook 格式。 2. 移除代码块包装符： `bash markdown-exporter md_to_ipynb /path/input.md /path/output.ipynb --strip-wrapper ` 在处理前移除任何代码块包装符（`）。 示例 Markdown 输入： 使用下方 示例 Markdown 输入 - 代码块 中的“代码块”示例。 ### 示例 Markdown 输入 为帮助你测试各种工具，下方提供常见的 Markdown 输入示例，代表输入文件的内容： #### 基本文本与表格 `markdown # 测试 Markdown 文件 这是一个用于测试各种导出工具的测试 markdown 文件。 ## 表格测试 | 名称 | 描述 | 价格 | |------|-------------|-------| | 项目 1 | 第一项 | $10 | | 项目 2 | 第二项 | $20 | | 项目 3 | 第三项 | $30 | ## 文本测试 这是一个包含 粗体 和 斜体 文本的段落。 - 列表项 1 - 列表项 2 - 列表项 3 > 这是一个引用块。 ` #### 代码块 ``markdown # 测试 Markdown 文件 ## 代码块测试 `python print("Hello, World!") def add(a, b): return a + b # 测试函数 result = add(5, 3) print(f"Result: {result}") ` `bash # Bash 脚本示例 echo "Hello from Bash" ls -la ` `javascript // JavaScript 示例 console.log("Hello from JavaScript"); function multiply(a, b) { return a * b; } ` `` #### 幻灯片（用于 PPTX） ``markdown --- title: Markdown Exporter author: Bowen Liang --- # 简介 ## 欢迎幻灯片 欢迎使用我们的 Markdown Exporter！ ::: notes 记得热情地向观众问好。 ::: --- # 第一节：基本布局 ## 标题与内容 - 这是一个带项目符号的基本幻灯片 - 它使用“标题与内容”布局 - 非常适合简单内容展示 ## 双栏布局 ::::: columns ::: column 左侧栏内容： - 要点 1 - 要点 2 ::: ::: column 右侧栏内容： - 要点 A - 要点 B ::: ::::: ## 比较布局 ::::: columns ::: column 文字后接图片： !测试图片 ::: ::: column - 这将触发“比较”布局 - 适用于并排比较 ::: ::::: ## 带说明的内容 以下是下方图片的说明文字。 !测试图片 --- # 第二节：高级功能 ## 代码块 这是一个 Python 代码块： `python def greet(name): return f"Hello, {name}!" print(greet("World")) ` ## 表格示例 | 列 1 | 列 2 | 列 3 | |----------|----------|----------| | 行 1 | 数据 | 更多 | | 行 2 | 信息 | 内容 | ## 增量列表 ::: incremental - 这一点先出现 - 然后这一点 - 最后这一点 ::: ## {background-image="https://example.com/image.jpg"} ::: notes 这是一张带背景图片且仅含演讲者备注的幻灯片。将使用“空白”布局。 ::: # 结论 ## 谢谢 感谢您观看本次全能演示！ ::: notes 记得感谢观众并邀请提问。 ::: `` ## 📝 备注 - 所有脚本仅支持文件路径作为输入 - 对于生成多个文件的脚本（如多个表格、多个代码块），输出文件名将自动编号 - 使用 --strip-wrapper 选项可移除输入 Markdown 中的代码块包装符（``）