← 返回 Skills 市场

Markdown Converter

Name: Markdown Converter
Author: nicenasa

作者 niceNASA · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

504

总下载

当前安装

版本数

在 OpenClaw 中安装

/install hami-markdown-converter

功能描述

Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XM...

使用说明 (SKILL.md)

Markdown Converter

Convert files to Markdown using uvx markitdown — no installation required.

Basic Usage

# Convert to stdout
uvx markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown

Supported Formats

Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
Web/Data: HTML, CSV, JSON, XML
Media: Images (EXIF + OCR), Audio (EXIF + transcription)
Other: ZIP (iterates contents), YouTube URLs, EPub

Options

-o OUTPUT      # Output file
-x EXTENSION   # Hint file extension (for stdin)
-m MIME_TYPE   # Hint MIME type
-c CHARSET     # Hint charset (e.g., UTF-8)
-d             # Use Azure Document Intelligence
-e ENDPOINT    # Document Intelligence endpoint
--use-plugins  # Enable 3rd-party plugins
--list-plugins # Show installed plugins

Examples

# Convert Word document
uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"

Notes

Output preserves document structure: headings, tables, lists, links
First run caches dependencies; subsequent runs are faster
For complex PDFs with poor extraction, use -d with Azure Document Intelligence

安全使用建议

This skill appears coherent for converting files to Markdown, but you should verify the external tooling it depends on before running it on sensitive data. Specifically: - Confirm you trust the 'uvx' and 'markitdown' binaries on your system (check vendor, installation source, and checksums). If they are not present, the skill gives no safe install method. - Avoid using '--use-plugins' or installing unknown plugins unless you trust their source; plugins can execute arbitrary code. - If you use Azure Document Intelligence or other cloud OCR/transcription, supply only the minimal credentials required and prefer short-lived credentials or dedicated service principals. - For high-sensitivity documents, run conversions in an isolated sandbox or on a machine with no access to secrets/network you care about. - If you need higher assurance, obtain the markitdown/uvx project source or packaging information and review what dependencies it fetches on first run.

功能分析

Type: OpenClaw Skill Name: hami-markdown-converter Version: 1.0.0 The skill bundle provides instructions for using the legitimate Microsoft 'markitdown' utility via the 'uvx' runner to convert various document formats to Markdown. The SKILL.md file contains standard usage examples and options consistent with the tool's documentation, with no evidence of malicious intent, data exfiltration, or prompt injection attacks.

能力评估

✓ Purpose & Capability

Name and description match the runtime instructions: the SKILL.md plainly instructs the agent to run 'uvx markitdown' to convert many document types to Markdown. There are no unrelated required credentials, files, or binaries declared.

ℹ Instruction Scope

Instructions are narrowly scoped to invoking the 'uvx markitdown' CLI on provided input files or stdin. Caveats: SKILL.md documents features that fetch/handle remote content (YouTube URLs, downloading ZIP contents) and an option to use 3rd‑party plugins (--use-plugins), which may pull and execute external code. It also mentions using Azure Document Intelligence with a user-supplied endpoint, implying network calls and possible credential use even though no creds are declared.

ℹ Install Mechanism

This is instruction-only (no install spec), so nothing is written by the skill package itself. However, it depends on an external CLI ('uvx markitdown') that the SKILL.md assumes is present; the origin, trustworthiness, and behavior of 'uvx'/'markitdown' are not provided here. The SKILL.md also mentions first-run caching of dependencies, indicating the tool may download code at runtime.

ℹ Credentials

The skill declares no required env vars or credentials (proportionate). Practical use of some features (Azure Document Intelligence or other cloud OCR/transcription services) will likely require credentials or endpoints that the SKILL.md doesn't declare—users must supply those out of band. The optional '--use-plugins' could require additional permissions or network access.

✓ Persistence & Privilege

The skill does not request persistent privileges (always:false) and does not modify other skills or system settings. Autonomous invocation is allowed (platform default) but not combined with any elevated privileges in this package.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install hami-markdown-converter
安装完成后，直接呼叫该 Skill 的名称或使用 /hami-markdown-converter 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release

元数据

Slug hami-markdown-converter

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题