markdown-exporter

1. 基本信息

项目	内容
名称	markdown-exporter
作者/维护者	bowenliang123（个人开发者）
来源链接	https://github.com/bowenliang123/markdown-exporter
许可证	Apache-2.0（GitHub API）
GitHub Stars	250（GitHub API）
Forks	65（GitHub API）
最新版本	v3.6.8（GitHub Releases）
安装方式	`pip install md-exporter` / `uv tool install md-exporter` / Claude Code 插件市场 / OpenClaw ClawHub

2. 功能介绍与亮点

markdown-exporter 是一个把 Markdown 文本一键转换为十余种专业格式文件的命令行工具与 Agent Skill。核心能力：

文档类：Markdown → DOCX / PDF / HTML / LaTeX，DOCX/PPTX 均支持传入自定义模板套用企业格式
演示类：Markdown（Pandoc 幻灯片语法）→ PPTX，支持双栏、对比、背景图等多种版式
数据类：Markdown 表格 → XLSX（自动分工作表）/ CSV / JSON / JSONL / XML
代码类：一键把 Markdown 中的多语言代码块拆分导出为独立文件，支持打包为 ZIP
提供 --strip-wrapper 等参数处理输入边界情况，所有子命令统一只接受文件路径输入，行为可预测

亮点：项目已发布 36 个正式版本、积累 600+ 次提交，工程化程度在同类工具中较为扎实；自带 PRIVACY.md 明确声明“不收集任何数据、全部本地处理”；同时以 Claude Code 插件、PyPI 包、OpenClaw 技能三种形态发布，覆盖不同使用习惯。

3. 适用场景

所属分类：文档与办公自动化。适合需要把 Claude Code / OpenClaw 等 agent 生成的 Markdown 输出，批量转成 Word 报告、PPT 演示、Excel 表格或 PDF 文档交付给同事、客户的用户；也适合需要把长文档里的多语言代码块拆解为可运行文件的开发者，或需要在 Markdown、Jupyter Notebook、LaTeX 之间互转的场景。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——仓库内含 .claude-plugin/marketplace.json 与 plugin.json，可直接作为插件市场安装，同时提供标准 SKILL.md
OpenClaw：✅ 原生支持——SKILL.md front matter 中显式声明 openclaw 元数据，可用 npx clawhub install markdown-exporter 一键安装
Codex：❓ 未验证——README 与 SKILL.md 均未提及 Codex 专属安装说明
Hermes Agent：❓ 未验证——文档中未出现相关内容

5. 推荐理由

市面上多数 Markdown 导出工具只覆盖单一格式（如只转 PDF 或只转 PPTX），这个 skill 用同一套 CLI 把 DOCX/PPTX/XLSX/PDF/HTML/LaTeX/JSON 等十余种格式一次性打通，且明确以 Agent Skill 形态原生支持 Claude Code 与 OpenClaw，安装只需一条 pip/uv 命令或一次插件市场添加，工程质量与维护记录在同类项目中较为扎实。

6. 评分

维度	分数	说明
受欢迎程度	6	GitHub 250 stars / 65 forks；经 Dify 市场、PyPI、ClawHub 多渠道分发，但第三方活跃讨论证据不足
可用性	9	`pip install md-exporter` 或插件市场一步安装；SKILL.md 含完整参数与示例；近一周仍有提交；无付费依赖
安全性	9	纯本地文件格式转换，`PRIVACY.md` 明确声明不联网、不收集数据；无需 API key；Apache-2.0 许可清晰；600+ 次提交、36 个正式 release 的持续维护记录

安全检查清单：① Shell 执行——仅本地调用 pandoc/pypandoc 等库转换文件，范围明确；② 联网外发——PRIVACY.md 明确声明不外发数据；③ API key——不需要；④ 可疑指令——SKILL.md 与脚本中未见提示词注入或异常操作指令；⑤ 作者信誉——个人开发者，600+ 次提交、7 位贡献者，持续维护 18 个月以上；⑥ License——Apache-2.0，清晰；⑦ 最近维护——一周内仍有提交，活跃。

7. 跟同类 Skills 相比的优势

项目	定位	与本 skill 的差异
anthropics/skills 的 docx / pptx / xlsx / pdf 系列	Anthropic 官方各自独立的单格式技能，直接操作 OOXML，原生格式还原度高	需按格式分别安装四个技能；本 skill 用一套 CLI 覆盖十余种格式，换取安装与调用的简洁性
tfriedel/claude-office-skills	Claude Code 专用的 office 技能合集，覆盖 PPTX/DOCX/XLSX/PDF	依赖 LibreOffice、Poppler、Pandoc 三套系统工具，安装门槛更高；仅支持 Claude Code 一个平台
Achuan-2/pandoc_docx_template	专注 Markdown↔DOCX 双向转换，提供多套中文排版模板与 Lua 过滤器	只做 DOCX 一种格式，模板仅在 Windows Office 上验证过；本 skill 格式覆盖面更广，但不含中文论文级排版模板

8. 用户评价

GitHub Issues 中可见具名用户的真实反馈。用户 thefirstLeonliao 在插件运行故障讨论中留言：“我也遇到了这个问题……真是个非常实用的插件”，肯定了工具本身的实用性，同时反映出 Dify 容器化部署路径下曾出现过安装超时的问题。另有用户 intbjw、Yutenten 等围绕依赖缺失、agent 模式文件输出等问题与作者 bowenliang123 多轮讨论，issue 最终均被修复关闭，显示出维护者响应及时。

9. 其他补充

项目提供中英文双语文档；.claude-plugin 目录同时包含 marketplace.json，理论上可被其他兼容 Claude Code 插件协议的市场收录；仓库内置测试目录（test/），具备基本的自动化测试覆盖。

10. 安装使用方式

PyPI：pip install md-exporter 或 uv tool install md-exporter，安装后直接在终端运行 markdown-exporter <子命令> <输入> <输出>
Claude Code 插件市场：在 Claude Code 中添加插件市场 bowenliang123/markdown-exporter 后安装 markdown-exporter 插件，即可让 Claude Code 在对话中直接调用
OpenClaw：npx clawhub install markdown-exporter
安装后无需重启，直接在对话中要求 agent 调用对应子命令（如 md_to_docx、md_to_pptx）即可；命令行方式则按 markdown-exporter <subcommand> -h 查看具体参数

11. 注意事项

Codex、Hermes Agent 平台上的兼容性未获验证，如需使用请先在自己的环境中测试
通过 Dify 插件市场部署时，历史上出现过容器化环境（尤其 Docker/Windows）下插件安装超时或依赖缺失的问题，走 PyPI 或 Claude Code 插件路径可规避
DOCX/PPTX 自定义模板功能依赖用户自备模板文件，工具本身不提供预置企业模板
项目由个人开发者维护，非官方或机构出品，长期维护延续性依赖维护者个人投入