Markdown转换器免费版

概述

Markdown转换器免费版帮助个人用户将各类文档文件转换为Markdown格式。工具支持PDF、Word、Excel、PPT、HTML、图片、音频等常见格式,保留文档结构(标题、表格、列表、链接),无需安装额外软件,通过uvx直接运行. 本版本面向个人用户,提供基础的文档转换能力,适合文档数字化与知识管理.

核心能力

支持的格式

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

文档结构保留

转换后的Markdown保留原始文档结构:

• 标题层级(h1-h6)
• 表格(标准Markdown表格)
• 列表(有序/无序)
• 链接与引用
• 图片引用
• 代码块

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

基础OCR

对图片进行OCR文字识别,提取图片中的文字内容并转为Markdown.

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

• 执行此能力时使用input_params参数,支持创建/查询/导出操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：等文件转换为、支持基础、与文档结构保留、适合个人使用、转换器免费版帮助、个人用户将各类文、档文件转换为、图片等常见格式、保留文档结构、无需安装额外软件、uvx、Use、when、需要文件处理、格式互转、内容提取时使用、不适用于加密文件、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一:PDF文档转换

需求:将PDF报告转换为Markdown便于编辑与归档.

输入格式

# 基础转换
uvx markitdown report.pdf -o report.md
# ...
# 从标准输入转换
cat input.pdf | uvx markitdown > output.md

场景二:Office文档批量转换

需求:将Word、Excel、PPT文件转为Markdown.

# Word文档
uvx markitdown document.docx -o document.md
# ...
# Excel表格
uvx markitdown data.xlsx > data.md
# ...
# PowerPoint演示文稿
uvx markitdown slides.pptx -o slides.md

场景三:网页与数据转换

需求:将HTML页面或数据文件转为Markdown.

# HTML页面
uvx markitdown page.html -o page.md
# ...
# CSV数据
uvx markitdown data.csv > data.md
# ...
# JSON数据
uvx markitdown config.json > config.md

快速开始

Step 1:确保环境就绪

# 依赖说明
uvx --version
# ...
# 如未安装,安装uv
# macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Step 2:执行转换

# 基础用法
uvx markitdown input.pdf
# ...
# 指定输出文件
# ...
# 重定向输出

Step 3:检查结果

# 查看转换结果
cat output.md
# ...
# 检查文档结构是否完整
# - 标题层级是否正确
# - 表格是否保留
# - 列表是否完整

示例

命令行选项

uvx markitdown [输入文件] [选项]
# ...
选项:
  -o OUTPUT      # 输出文件路径
  -x EXTENSION   # 提示文件扩展名(用于标准输入)
  -m MIME_TYPE   # 提示MIME类型
  -c CHARSET     # 提示字符集(如UTF-8)
  -d             # 使用Azure文档智能(高级PDF)
  -e ENDPOINT    # 文档智能端点
  --use-plugins  # 启用第三方插件
  --list-plugins # 列出已安装插件

常见转换示例

# PDF转Markdown
# ...
# Word转Markdown
# ...
# Excel转Markdown(表格保留)
uvx markitdown spreadsheet.xlsx > spreadsheet.md
# ...
# PowerPoint转Markdown
uvx markitdown presentation.pptx -o presentation.md
# ...
# HTML转Markdown
uvx markitdown webpage.html -o webpage.md
# ...
# 图片OCR
uvx markitdown scan.jpg -o scan.md
# ...
# ZIP包遍历
uvx markitdown archive.zip -o archive.md
# ...
# 标准输入(需指定扩展名)
cat document | uvx markitdown -x .pdf > output.md

最佳实践

格式选择指南

转换质量优化

# 复杂PDF使用文档智能提升效果
uvx markitdown complex.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
# ...
# 指定字符集确保中文正确
uvx markitdown chinese-doc.pdf -c UTF-8 -o output.md
# ...
# 使用插件扩展功能
uvx markitdown --use-plugins input.docx -o output.md

性能建议

常见问题

Q1: 转换后中文乱码怎么办?

A: 使用-c选项指定字符集:

Q2: PDF转换效果不好?

A: 对于扫描版PDF或复杂排版的PDF,使用-d选项启用文档智能服务:

uvx markitdown scan.cognitiveservices.azure.com/"

Q3: 免费版支持批量转换吗?

A: 免费版需逐个文件执行转换。如需批量处理整个目录,请使用PRO版的批量转换功能.

Q4: 是否支持自定义输出格式?

A: 免费版输出标准Markdown格式。如需自定义输出模板、元数据提取等高级功能,请使用PRO版.

Q5: 转换后的表格格式不对?

A: 确保源文件的表格结构清晰。复杂合并单元格可能无法完美保留。建议在转换后手动检查并调整表格格式.

依赖说明

运行环境

• Agent平台: 支持SKILL.md规范的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Python: 3.8+(通过uvx自动管理)

第三方依赖

API Key 配置

• 基础LLM由Agent平台内置提供，特定外部API需单独配置密钥
• 基础转换使用本地工具,无需云端服务
• 如使用Azure文档智能(-d选项),需配置Azure端点与API Key

可用性分类

• 分类: MD+EXEC(纯Markdown指令+命令行执行能力)
• 说明: 基于Markdown指令驱动Agent执行文档转换任务,通过uvx运行markitdown工具
• 免费版限制: 单文件转换、基础OCR、无批量处理、无自定义模板

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

{
  "success": true,
  "data": {
    "result": "Markdown转换器免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "markdown converter"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}