文档导出工具免费版

核心功能: 该技能提供结构化的工作流程和配置指引等能力。

文档导出工具（免费版）

该工具为内容创作者与开发者提供Markdown多格式导出能力。免费版覆盖核心场景：DOCX、PDF、HTML、XLSX、CSV、JSON等主流格式转换，可满足绝大多数文档导出需求.

概述

Markdown作为轻量级标记语言已成为技术写作的事实标准，但实际工作中往往需要将内容交付为Word、PDF、Excel等格式。该工具通过统一的命令行接口，将Markdown快速转换为目标格式，免去手动复制粘贴与排版调整的繁琐工作. 工具基于Python实现，所有命令仅支持文件路径作为输入，参数规范统一，上手成本低.

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：多格式导出工具、等核心格式、命令行快速转换、面向内容创作者与、开发者的、通过命令行将、文本快速转换为、等主流格式、免去手动排版与格、式调整的繁琐工作、特别适合技术文档、数据表导出场景、Use、when、需要文件处理、文档转换、格式互转、内容提取时使用、不适用于加密文件等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：技术文档分发

团队内部用Markdown写作，对外交付时导出为Word或PDF，保留格式与样式.

场景二：数据报告导出

将Markdown表格快速导出为Excel，每个表格自动成为独立Sheet，便于后续数据分析.

示例

从技术博客Markdown中提取所有代码块为独立文件，便于读者直接运行测试.

场景四：内容多端分发

同一份Markdown源文件，按需导出为HTML（网页）、PDF（打印）、DOCX（协作）等格式，一次写作多处发布.

快速开始

依赖详情

# 通过pip安装
pip install md-exporter
# ...
# 或通过uv安装
uv tool install md-exporter

第二步：验证安装

markdown-exporter -h

第三步：执行首次转换

# Markdown转DOCX
markdown-exporter md_to_docx /path/input.md /path/output.docx
# ...
# Markdown转PDF
markdown-exporter md_to_pdf /path/input.md /path/output.pdf
# ...
# Markdown表格转Excel
markdown-exporter md_to_xlsx /path/input.md /path/output.xlsx

完整上手时间约60秒.

配置示例

Markdown转DOCX（基础）

md /path/output.docx

Markdown转DOCX（自定义模板）

md /path/output.docx \
  --template /path/template.docx

Markdown转PDF

# 在此执行相关操作
echo "操作完成"

Markdown表格转Excel

# 默认每个表格独立Sheet，单元格强制文本类型
md /path/output.xlsx
# ...
# 允许Excel自动识别单元格类型
md /path/output.xlsx --force-text False

Markdown表格转CSV

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

Markdown转HTML

# 输出HTML文件
markdown-exporter md_to_html /path/input.md /path/output.html
# ...
# 输出HTML字符串到stdout
markdown-exporter md_to_html_text /path/input.md

Markdown表格转JSON

# 默认JSONL格式（每行一个JSON对象）
markdown-exporter md_to_json /path/input.md /path/output.json
# ...
# JSON数组格式
md /path/output.json --style json_array

Markdown代码块提取

# 提取到目录
markdown-exporter md_to_codeblock /path/input.md /path/output_dir
# ...
# 提取并压缩为ZIP
md /path/output.zip --compress

Markdown转PPTX（演示文稿）

markdown-exporter md_to_pptx /path/input.md /path/output.pptx
# ...
# 使用自定义PPTX模板
md /path/output.pptx --template /path/template.pptx

优秀实践

1. 使用--strip-wrapper处理被代码块包裹的Markdown

markdown-exporter md_to_pdf input.md output.pdf --strip-wrapper

部分工具导出的Markdown会被```包裹，使用此参数自动移除包裹.

2. PPTX使用Pandoc风格幻灯片语法

具体操作方式与参数说明请参考下方示例代码.
## 标题页
# ...
正文内容
# ...
---
# ...

## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用该技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。
## 第二页
# ...
- 项目一
- 项目二
# ...
::: notes
演讲者备注
:::

---分隔幻灯片，::: notes定义演讲者备注.

3. Excel导出启用force-text避免数字精度丢失

身份证号、电话号码等长数字在Excel中会被科学计数法显示，启用--force-text True（默认）将其作为文本保留.

4. 批量转换脚本

#!/bin/bash
for md_file in docs/*.md; do
    output_name="${md_file%.md}.pdf"
    markdown-exporter md_to_pdf "$md_file" "$output_name"
done

5. 中文PDF显示修复

若PDF中中文显示为方块，安装中文字体包：

# Ubuntu/Debian
sudo apt-get install fonts-noto-cjk
# ...
# macOS
brew install --cask font-noto-sans-cjk

常见问题

Q1：所有命令是否支持stdin输入？

A：不支持。所有命令仅接受文件路径作为输入，需先将内容写入临时文件再转换.

Q2：转换后格式错乱怎么办？

A：(1) 检查Markdown语法是否规范，特别是表格分隔符；(2) 使用--strip-wrapper移除代码块包裹；(3) 复杂格式建议先转HTML再转目标格式.

Q3：PDF中文显示为方块如何解决？

A：安装中文字体包（如Noto Sans CJK），详见优秀实践第5条。工具默认调用系统字体渲染PDF.

Q4：Excel中多个表格如何处理？

A：每个Markdown表格自动成为独立Sheet，Sheet名按"Sheet1、Sheet2..."顺序命名。若需自定义Sheet名，建议拆分为多个Markdown文件分别导出.

Q5：PPTX支持哪些布局？

A：支持标题页、标题与内容、两栏布局、对比布局、内容带说明、代码块、表格、增量列表等Pandoc标准布局，通过Markdown语法自动识别.

Q6：是否支持Markdown扩展语法？

A：支持表格、代码块、引用、列表、链接、图片等CommonMark与GFM扩展语法。Mermaid图表等特殊语法不直接支持，需先渲染为图片.

已知限制

本免费体验版限制以下高级功能：

• 单次转换文件大小上限为10MB
• 不支持批量并行转换
• 不支持自定义样式表
• 不支持PDF水印与加密
• 不支持模板云端同步

解锁全部功能请使用专业版：md-export-tool-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Python: 3.8+

第三方依赖

API Key 配置

• 本免费版完全基于本地处理，无需任何API Key
• 不涉及云端服务调用，所有转换在本地完成

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

错误处理

输出格式

{
  "success": true,
  "data": {
    "result": "文档导出工具免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "md export"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}