agentCLAWHUBUnverified

MarkItDown文档转换中文版

使用微软 markitdown 库将多种文档格式(PDF、DOCX、PPTX、XLSX、XLS、CSV、JSON、TXT、EPUB、HTML等)转换为 Markdown。支持批量转换、保留格式、图片提取等功能。使用场景:(1) "把这个 PDF 转成 Markdown",(2) "把这个 word 文档转成 Ma... Skill: MarkItDown文档转换中文版 Owner: mapleshadow Summary: 使用微软 markitdown 库将多种文档格式(PDF、DOCX、PPTX、XLSX、XLS、CSV、JSON、TXT、EPUB、HTML等)转换为 Markdown。支持批量转换、保留格式、图片提取等功能。使用场景:(1) "把这个 PDF 转成 Markdown",(2) "把这个 word 文档转成 Ma... Tags: latest:1.0.4 Version history: v1.0.4 | 2026-05-20T07:52:28.415Z | user - 删除了 _meta.json 文件。 - 在描述中扩展了使用场景。 - 添加了用于分类的 # 标签部分。 - 改进了文档中的 pipx 和 PATH 安装说明。 v1.0.3 | 2026-04-23T12:42:43.524Z | user - 更新描

OpenClaw

Rank

62

Safety

84

Downloads

1.2k

Updated

Oct 11, 2026

Version

1.0.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.2K downloadsadoption · observed Oct 11, 2026
Latest release
1.0.4release · observed May 20, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s172w6e7nk99p5vfzya5jngc2h83hbcd:markitdown-zh
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-mapleshadow-markitdown-zh/snapshot"

Documentation

CLAWHUB

29,648 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: markitdown-zh
description: 使用微软 markitdown 库将多种文档格式(PDF、DOCX、PPTX、XLSX、XLS、CSV、JSON、TXT、EPUB、HTML等)转换为 Markdown。支持批量转换、保留格式、图片提取等功能。使用场景:(1) "把这个 PDF 转成 Markdown",(2) "把这个 word 文档转成 Markdown",(3) "批量转换这个文件夹里的文档",(4) "提取文档中的图片"。
---
# tags
"文档转换", "markitdown", ".docx .xlsx .pptx", "OCR"

# MarkItDown 文档转换技能

使用微软的 markitdown 库将各种文档格式转换为 Markdown。

## 支持的格式

- PDF (.pdf)
- Word 文档 (.docx)
- PowerPoint 演示文稿 (.pptx)
- Excel 电子表格 (.xlsx .xls)
- HTML 文件 (.html, .htm)
- 纯文本文件 (.txt, .rtf, .xml, .csv, .json)
- 电子书 (.epub)
- 等等...

## 快速开始

### 单个文件转换

```python
from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
```

### 使用提供的脚本

```bash
# 转换单个文件
python3 scripts/convert.py input.pdf output.md

# 批量转换文件夹
python3 scripts/batch_convert.py input_folder/ output_folder/

# 提取文档中的图片
python3 scripts/extract_images.py document.pdf images_folder/
```

## 详细用法

### 单个文件转换

使用 `scripts/convert.py`:

```bash
python3 scripts/convert.py <input_file> [output_file]
```

如果不指定输出文件,会自动生成 `.md` 文件。

### 批量转换

使用 `scripts/batch_convert.py`:

```bash
python3 scripts/batch_convert.py <input_directory> <output_directory>
```

会递归处理目录中的所有支持的文件。

### 图片提取

使用 `scripts/extract_images.py`:

```bash
python3 scripts/extract_images.py <input_file> <output_directory>
```

从文档中提取所有图片并保存到指定目录。

## 脚本说明

- `scripts/convert.py` - 单个文件转换脚本
- `scripts/batch_convert.py` - 批量转换脚本
- `scripts/extract_images.py` - 图片提取脚本

每个脚本都有 `--help` 选项查看详细参数。

## 安装依赖

### Python 版本要求

markitdown 需要 Python 3.10 或更高版本。

检查 Python 版本:
```bash
python3.12 --version  # 或 python3.11, python3.13
```

### 安装 markitdown

使用 Python 3.10+ 安装:

```bash
# 使用 Python 3.12(推荐)
# 使用虚拟环境(适用于非root用户,如node用户)
python3.12 -m venv markitdown-env
source markitdown-env/bin/activate
pip install "markitdown[all]"

# 或安装pipx包管理应用,通过pipx安装markitdown
sudo apt-get install pipx
# 使用pipx安装markitdown包 all表示支持所有格式
pipx install 'markitdown[all]'
# 将通过pipx安装的包路径放入当前变量PATH内
pipx ensurepath
```

### 可选:系统依赖

某些格式转换可能需要额外的系统依赖:

- **PDF 处理**: `brew install poppler` (macOS) 或 `sudo apt-get install poppler-utils` (Linux)
- **OCR**: `brew install tesseract` (macOS) 或 `sudo apt-get install tesseract-ocr` (Linux)

## 验证安装

```bash
python3.12 -c "from markitdown import MarkItDown; print('安装成功!')"
```

## 使用脚本

所有脚本都支持使用特定 Python 版本运行:

```bash
# 使用 Python 3.12 运行
python3.12 scripts/convert.py input.pdf output.md
python3.12 scripts/batch_convert.py input_folder/ output_folder/
python3.12 scripts/extract_images.py document.pdf images_folder/
```

## 另请参阅

- [Microsoft MarkItDown](https://github.com/microsoft/markitdown) - 上游库

_meta.json

{
  "ownerId": "kn74phsn575zqnc4rb0zznbv8n827127",
  "slug": "markitdown-zh",
  "version": "1.0.4",
  "publishedAt": 1779263548415
}

skill-card.md

## Description:

使用微软 markitdown 库将多种文档格式(PDF、DOCX、PPTX、XLSX、XLS、CSV、JSON、TXT、EPUB、HTML等)转换为 Markdown,并支持批量转换和图片提取。

This skill is ready for commercial/non-commercial use.

## Publisher:

[mapleshadow](https://clawhub.ai/user/mapleshadow)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and document-processing users use this skill to convert individual files or folders of PDFs, Office documents, spreadsheets, text files, ebooks, and HTML into Markdown. It can also help extract document images when the underlying MarkItDown conversion result exposes them.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Installing MarkItDown with optional dependencies or system packages may add software the user has not reviewed.

Mitigation: Use a virtual environment or pipx under the user account, pin dependency versions where possible, and review package installation commands before running them.

Risk: Batch conversion recursively reads files from the input directory.

Mitigation: Point batch conversion only at folders containing documents intended for conversion.

Risk: Converted Markdown and extracted images can contain sensitive content from the source documents.

Mitigation: Write outputs to an approved location and handle generated files according to the same data controls as the source documents.

## Reference(s):

- [Microsoft MarkItDown](https://github.com/microsoft/markitdown)
- [ClawHub skill page](https://clawhub.ai/mapleshadow/skills/markitdown-zh)

## Skill Output:

**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration]

**Output Format:** [Markdown guidance with Python and shell command examples; scripts produce Markdown files and extracted image files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires Python 3.10+ and the MarkItDown package; optional system dependencies may be needed for some formats.]

## Skill Version(s):

1.0.4 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/mapleshadow/skills/markitdown-zh",
      "sourceUrl": "https://clawhub.ai/mapleshadow/skills/markitdown-zh",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:07:37.878Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-mapleshadow-markitdown-zh/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mapleshadow-markitdown-zh/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:07:37.878Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.2K downloads",
      "href": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceUrl": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T01:07:37.878Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.4",
      "href": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceUrl": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-20T07:52:28.415Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-mapleshadow-markitdown-zh/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mapleshadow-markitdown-zh/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.4",
      "description": "- 删除了 _meta.json 文件。 - 在描述中扩展了使用场景。 - 添加了用于分类的 # 标签部分。 - 改进了文档中的 pipx 和 PATH 安装说明。",
      "href": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceUrl": "https://clawhub.ai/mapleshadow/markitdown-zh",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-05-20T07:52:28.415Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to MarkItDown文档转换中文版 and adjacent AI workflows.