Markdown Exporter

核心用法

Markdown Exporter 是一款基于 Python 的命令行工具，提供 14 种格式转换能力。用户通过 markdown-exporter <子命令> <输入> <输出> [选项] 的标准 CLI 结构执行转换，所有输入仅支持文件路径。主要功能分为三类：文档转换（DOCX/PDF/HTML/PNG）、数据表格处理（XLSX/CSV/JSON/XML/LaTeX）、演示与开发支持（PPTX/IPYNB/代码块提取）。

显著优点

• 格式覆盖全面：支持从专业排版（PDF/DOCX）到数据分析（XLSX/JSON）再到演示（PPTX）的全场景需求
• 中文友好：PDF 生成特别优化中日文支持
• 模板化能力：DOCX/PPTX 支持自定义模板文件，便于企业品牌统一
• 智能代码提取：md_to_codeblock 可自动识别语言并按扩展名保存，支持 ZIP 打包
• 多表多页处理：XLSX 导出时多表自动分 Sheet，PNG 导出时每页独立成图

潜在局限

• 仅支持文件输入：无法直接处理标准输入或内存中的 Markdown 字符串（md_to_html_text 仅输出到 stdout）
• 依赖外部生态：PPTX 生成依赖 Pandoc 风格的 slide 语法，有一定学习成本
• 样式控制有限：除模板外，缺少细粒度 CSS/样式注入能力
• 无实时预览：需导出后才能查看效果，调试流程较长

适合人群

技术写作者、数据分析师、DevOps 工程师、需要批量生成标准化文档的 RPA 场景用户，以及希望用 Markdown 作为单一源文件输出多格式交付物的团队。

常规风险

• 处理不受信来源的 Markdown 时，代码块提取功能可能执行意外文件写入
• 模板文件若来自第三方，可能包含宏或隐藏恶意内容（DOCX/PPTX 载体）
• PDF/PNG 生成依赖底层渲染引擎，需关注潜在字体解析漏洞

核心用法

Markdown Exporter 是一款专为 Agent 设计的文档格式转换技能，通过封装 md-exporter CLI 工具，将 Markdown 文本无缝转换为 DOCX、PPTX、XLSX、PDF、PNG、HTML、IPYNB、CSV、JSON、JSONL、XML、LaTeX 等 13 余种专业格式，并支持从 Markdown 中提取代码块生成独立文件（Python、Bash、JavaScript 等）。用户只需提供 Markdown 文件路径，即可调用 markdown-exporter <子命令> <输入> <输出> 完成转换，支持 --strip-wrapper 去除代码块包裹符、--template 自定义模板、--compress 压缩输出等高级选项。

显著优点

该技能的最大优势在于格式覆盖全面且专业性强，单一周转即可替代传统多工具链的繁琐操作；中文友好，PDF 生成原生支持中日文排版；模板扩展灵活，DOCX/PPTX 支持企业级模板注入，确保输出文档符合品牌规范；代码提取独特，可自动识别 fenced code blocks 并按语言分类导出，是开发者文档整理的利器。此外，纯本地 CLI 执行、无网络依赖、零配置启动，使其在离线环境和隐私敏感场景下表现卓越。

潜在缺点与局限性

作为文件级转换工具，其输入限制为本地文件路径，无法直接处理内存中的字符串或流式数据，Agent 需额外处理临时文件创建；样式控制能力有限，HTML/PDF 转换依赖底层工具默认渲染，精细 CSS 定制需用户自行预处理；PPTX 幻灯片需遵循 Pandoc 风格语法，对习惯标准 Markdown 的用户存在学习成本；多表格场景下 XLSX 自动分 sheet 的命名逻辑不可自定义；代码块提取时若语言标识缺失会导致文件扩展名默认为 .txt。

适合的目标群体

该技能高度契合技术文档工程师（API 文档多格式分发）、数据分析师（Markdown 表格转 Excel/JSON 供下游使用）、学术研究者（LaTeX/PDF 论文排版）、企业运营人员（Markdown 内容转 PPTX 汇报材料）以及开发者（README 代码片段批量提取归档）。任何以 Markdown 为主要创作介质、需向非技术受众交付格式化成果的场景均为理想应用场景。

常规使用风险

依赖项风险：Skill 本体无第三方依赖，但底层 md-exporter 工具通过 PyPI 安装，需关注上游安全公告和版本兼容性；文件 I/O 风险：大量 PNG 生成或大表格转换可能产生显著磁盘占用，需确保输出目录可写空间充足；模板注入风险：使用 --template 加载外部 DOCX/PPTX 模板时，建议校验模板来源，避免恶意宏或嵌入对象；字符编码风险：极少数非 UTF-8 源文件可能在特定格式转换时出现乱码，建议统一输入编码规范。