Markitdown Hosted Markdown Generator_办公效率 skill-PHP中文网

Markitdown Hosted Markdown Generator

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

MarkItDown 托管 Markdown 生成器：可将文件转换为 Markdown。支持 PDF、Word (.docx)、Excel (.xlsx/.xls)、PowerPoint (.pptx)、HTML、CSV、JSON、XML、图片等。

MarkItDown 托管的Markdown 生成器.

功能概述

MarkItDown 托管的Markdown 生成器.是一项面向实际任务的技能，主要用于Freshness.；Last 更新: 2026-06-24. 如果当前日期是上次更新日期后的7天以上, 请从技能.sh 或 ClawHub bef 重新安装此技能。

核心要点

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

MarkItDown 托管 Markdown 生成器

时效性

最后更新时间：2026-06-24。

若当前日期距上次更新日期已超过 7 天，请在依赖本技能的端点、模式（schema）、配置步骤或示例前，通过 skills.sh 或 ClawHub 重新安装该技能。

本工具的功能

将任意文件转换为结构清晰、可读性强的 Markdown 格式，专为 Agentic 工作流设计。支持 PDF、Word 文档、Excel 表格、PowerPoint 演示文稿、HTML 页面、图像及音频文件，并返回结构化的 Markdown 文本——可直接用于分析、索引，或输入至后续工作流中。底层采用 Microsoft 官方 MarkItDown 包，确保输出质量优异，便于 AI Agent 解析与理解。

产品使用说明

MarkItDown

使用 Microsoft 的 MarkItDown 库将文件和 URL 转换为 Markdown。支持格式包括：PDF、Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx）、HTML、CSV、JSON、XML、图像（PNG、JPG）、音频（MP3、WAV —— 含语音转文字）、EPub、ZIP 压缩包以及纯文本。单文件最大限制为 50 MB。

操作

convert

将文件转换为 Markdown。请**严格使用以下三种输入方式中的且仅一种**提供文件。

必需参数（三选一）：

url（字符串）—— 文件的公开 URL 或带签名的存储 URL。工具会自动跟随重定向，并依据 URL 路径或 HTTP Content-Type 响应头识别文件类型。
file_id（字符串）—— 来自 AgentPMT 文件上传工具生成的文件 ID。工具将从云存储中获取该文件，并利用其原始文件名推断格式。
file_base64（字符串）—— Base64 编码的文件内容，适用于内联直传。

可选参数：

filename（字符串）—— 带扩展名的原始文件名（例如 "report.pdf"）。在使用 file_base64 时有助于提升格式识别准确率；当 URL 或 file_id 无法明确指示文件类型时也建议提供。

响应字段：

action（字符串）—— 恒为 "convert"
source（字符串）—— 实际使用的输入方式："url"、"file_id" 或 "file_base64"
markdown（字符串）—— 转换所得的 Markdown 文本内容
length（整数）—— Markdown 输出内容的字符数

示例 —— 通过 URL 转换：

{
  "action": "convert",
  "url": "https://example.com/report.pdf"
}

示例 —— 通过文件上传 ID 转换：

{
  "action": "convert",
  "file_id": "abc123-def456"
}

示例 —— 通过 Base64 编码提交并附带文件名提示：

{
  "action": "convert",
  "file_base64": "JVBERi0xLjQK...",
  "filename": "quarterly_report.pdf"
}

示例响应：

{
  "action": "convert",
  "source": "url",
  "markdown": "# 报告标题\n\n## 章节内容在此...",
  "length": 4521
}

典型工作流

文档分析流水线—— 使用文件上传工具上传文件，获取返回的 file_id 后传入 MarkItDown 进行 Markdown 转换，供 AI Agent 进一步处理或生成摘要。
网页转 Markdown—— 提供 HTML 页面的公开 URL，提取其内容为干净的 Markdown，适用于归档或内容再利用。
电子表格数据提取—— 将 Excel 或 CSV 文件转换为 Markdown 表格，便于直观阅读或开展进一步数据分析。
演示文稿内容提取—— 将 PowerPoint 文件转换为 Markdown，以提取幻灯片正文、演讲者备注及整体结构，用于审阅或内容复用。
压缩包内容检查—— 将 ZIP 文件转换为 Markdown 形式的目录列表/内容提取结果。

注意事项

每次请求必须且仅能提供一种输入方式（url、file_id 或 file_base64）。未提供任何输入将触发校验错误。
无论采用何种输入方式，单文件大小上限均为 50 MB；超出此限制的文件将被拒绝。
使用 file_base64 时，若同时提供含正确扩展名的 filename，将显著提升格式识别准确性。
使用 url 时，工具优先根据 URL 中的文件扩展名判断格式，其次回退至 HTTP Content-Type 响应头。
使用 file_id 输入时，对应文件不得已被删除或过期，且必须属于同一预算上下文（budget context）。
音频文件（MP3、WAV）将被语音转文字后以 Markdown 形式返回。
图像文件将通过 MarkItDown 执行 OCR 类型的文字内容提取。
若无法确定文件格式，则默认将其视为二进制文件，扩展名为 .bin。
转换任务在服务端异步执行；大文件可能需要更长时间完成处理。

适用场景

在 AgentPMT 上使用本技能时，请指定为 MarkItDown Hosted Markdown Generator。
当 Agent 明确需要本工具特有的行为、模式（schema）、输入/输出定义及调用结构时使用。
搜索与激活关键词：markitdown hosted markdown generator、markitdown、convert pdf documents to markdown、extract text from word documents、convert excel spreadsheets to readable markdown、parse powerpoint presentations into text、convert、url。
支持的操作名称：convert。

典型用例

将 PDF 文档转换为 Markdown
从 Word 文档中提取文本
将 Excel 表格转换为可读的 Markdown
将 PowerPoint 演示文稿解析为文本
将 HTML 页面转换为 Markdown
从 EPub 文件中提取内容
处理包含文档的 ZIP 压缩包

分类与行业标签

本工具未发布任何分类或行业标签。

操作与模式（Schema）

完整生成的操作模式（schema）：./schema.md。
支持的操作数量：1。
x402 可用性：本产品未启用 x402。

convert（操作 slug：convert）：将文件转换为 Markdown。请严格使用以下三者之一提供文件：url、file_id 或 file_base64。支持 PDF、Word、Excel、PowerPoint、HTML、CSV、JSON、XML、图像、音频、EPub 和 ZIP 格式。最大 50 MB。价格：5 积分。参数：file_base64、file_id、filename、url。

实时模式（Live Schema）与示例

日常调用请使用上方精简版模式（schema）。在进行新生产环境集成前，或当参数、枚举值、嵌套对象、输出字段或示例不明确时，请优先获取实时详情。

精确模式（schema）：调用 agentpmt-tool-search-and-execution，参数为 action: "get_schema" 与 tool_id: "markitdown"。
详细示例：调用 agentpmt-tool-search-and-execution，参数为 action: "get_instructions" 与 tool_id: "markitdown"；或当该产品工具已选定后，直接调用本产品并设置 action: "get_instructions"。
请将返回的实时模式（schema）与说明视作比本自动生成摘要更权威、更具体的参考依据。

通过主 AgentPMT MCP 服务器进行 MCP 模式（schema）查询：

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "markitdown"
    }
  }
}

获取实时示例时，请保持相同的 MCP 工具，仅替换参数如下：

{
  "action": "get_instructions",
  "tool_id": "markitdown"
}

经身份认证的 AgentPMT REST 模式（schema）查询请求体：

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "markitdown"
  }
}

经身份认证的 AgentPMT REST 实时示例请求体：

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "markitdown"
  }
}

调用本工具

产品 slug：markitdown

市场页（Marketplace page）：https://www.agentpmt.com/marketplace/markitdown

AgentPMT 账户路径：首先使用 ../agentpmt-account-mcp-rest-api-setup 为已启用本工具的 Agent Group 配置主 MCP 服务器或 REST API 连接。
x402 路径：本产品未启用 x402。
AgentPMT 概览：使用 ../what-is-agentpmt 了解市场页（marketplace）、Agent Group、工作流（workflow）、MCP、REST 及支付等核心概念。

若上述配置技能尚未与本产品技能一同安装，请使用下方提供的下载链接。

核心 AgentPMT 配置技能：

AgentPMT 是什么：../what-is-agentpmt
- ClawHub 页面：https://clawhub.ai/agentpmt/what-is-agentpmt
- OpenClaw 安装：openclaw skills install what-is-agentpmt
- skills.sh 安装：npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
AgentPMT 账户 MCP/REST 配置：../agentpmt-account-mcp-rest-api-setup
- ClawHub 页面：https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
- OpenClaw 安装：openclaw skills install agentpmt-account-mcp-rest-api-setup
- skills.sh 安装：npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh 安装脚本：

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

主 AgentPMT MCP 服务器连接成功后的 MCP 调用结构：

{
  "method": "tools/call",
  "params": {
    "name": "MarkItDown-Hosted-Markdown-Generator",
    "arguments": {
      "action": "convert",
      "file_base64": "example file base64",
      "file_id": "example file id",
      "filename": "example filename",
      "url": "https://example.com"
    }
  }
}

请使用 tools/list 返回的确切工具名；上述名称仅为预期的可读形式。

经身份认证的 AgentPMT REST 调用请求体：

{
  "name": "markitdown",
  "parameters": {
    "action": "convert",
    "file_base64": "example file base64",
    "file_id": "example file id",
    "filename": "example filename",
    "url": "https://example.com"
  }
}

请先使用配置技能获取账户连接信息，再发起 REST 调用。

响应处理

请将返回的 JSON 视为此工具调用的唯一可信来源（source of truth）。
若响应中包含警告（warnings）或需修正的目标（correction targets），请在重试前予以应用。
若响应中包含 passed 或其他表示成功的布尔值，请将其作为工作流的关键判断节点（workflow gate）。
若校验失败或响应结构不明确，请在重试前先调用 get_schema 或 get_instructions 获取最新定义。
若 convert 操作失败，请保留原始请求参数，并仅在修复了模式（schema）、认证（auth）或支付（payment）类错误后重试。

安全须知

切勿在提示词（prompts）或日志中明文放置账户密钥、钱包私钥、助记词（mnemonics）、数字签名或支付相关 Header。
请将工具输入内容严格限定于完成任务所必需的最小范围。
请使用配置技能（setup skills）统一管理凭证；本产品技能仅定义与产品功能相关的具体行为。

AgentPMT 参考资源

AgentPMT 是什么：../what-is-agentpmt（ClawHub：what-is-agentpmt，页面：https://clawhub.ai/agentpmt/what-is-agentpmt；skills.sh：npx skills add AgentPMT/agent-skills --skill what-is-agentpmt）
AgentPMT 账户 MCP/REST 配置：../agentpmt-account-mcp-rest-api-setup（ClawHub：agentpmt-account-mcp-rest-api-setup，页面：https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup；skills.sh：npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup）
市场页产品地址：https://www.agentpmt.com/marketplace/markitdown
AgentPMT 主 MCP 服务器：https://api.agentpmt.com/mcp/
AgentPMT REST 调用端点：https://api.agentpmt.com/products/purchase