← 返回 Skills 市场
sipingme

All to Markdown

作者 PING SI · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
95
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install all-to-markdown
功能描述
将任意文件(PDF、Word、Excel、PPT、图片、音频、网页等)转换为 Markdown
使用说明 (SKILL.md)

All to Markdown

基于 Microsoft MarkItDown,将任意格式的文件或 URL 转换为 Markdown,便于 LLM 分析和处理。

支持格式

类型 格式
文档 PDF、DOCX、PPTX、XLSX、XLS、EPUB、MSG
数据 CSV、JSON、XML
图片 JPG、PNG 等(含 EXIF 元数据,可选 OCR)
音频 WAV、MP3(含语音转录,需 OpenAI Key)
网页 HTML、YouTube URL(含字幕提取)
压缩 ZIP(逐文件转换)

前置要求

安装 markitdown:

pip install 'markitdown[all]'

给 AI 的使用说明

当用户需要将文件或 URL 转换为 Markdown 时,使用以下命令:

scripts/run.sh \x3C文件路径或URL>

可选标志:

  • -o \x3C输出文件> — 保存到文件
  • --use-plugins — 启用插件(如 markitdown-ocr)

重要原则

  • 转换结果直接输出到 stdout,可供 AI 直接读取分析
  • 文件路径使用用户提供的实际路径,不要假设
  • 转换大型文件时提前告知用户可能需要较长时间

使用示例

示例 1:转换 PDF

用户:帮我把这个 PDF 转成 Markdown,以便我分析内容

AI 执行:

scripts/run.sh /path/to/document.pdf

示例 2:转换并保存

用户:把这个 Excel 转成 Markdown 文件保存

AI 执行:

scripts/run.sh /path/to/data.xlsx -o output.md

示例 3:转换网页

用户:把这篇文章转成 Markdown

AI 执行:

scripts/run.sh https://example.com/article.html

示例 4:提取 YouTube 字幕

用户:把这个 YouTube 视频的内容提取出来

AI 执行:

scripts/run.sh https://www.youtube.com/watch?v=xxx

可选 AI 增强功能

设置 OPENAI_API_KEY 后,markitdown 可对图片生成 AI 描述:

OPENAI_API_KEY=sk-xxx scripts/run.sh image.jpg

安全说明

  • 仅在本地执行文件转换,不发送文件内容到远程服务
  • 转换 URL 时会访问对应网络地址
  • 启用 LLM 功能时,图片内容会发送到 OpenAI API
安全使用建议
This skill is a thin wrapper around the community markitdown tool and appears internally consistent. Before installing: (1) review and install markitdown from PyPI in a virtualenv (pip install 'markitdown[all]') rather than running untrusted installers; (2) be aware that converting a URL causes the tool to fetch remote content and enabling OPENAI_API_KEY will send image/OCR content to OpenAI — do not pass sensitive documents or secrets if you enable that feature; (3) consider inspecting markitdown's code or its installed plugins if you need higher assurance; and (4) note the small metadata mismatch about the required binary (markitdown) — ensure that CLI is present on the system before invoking the skill.
功能分析
Type: OpenClaw Skill Name: all-to-markdown Version: 1.0.0 The skill is a legitimate wrapper for Microsoft's 'markitdown' tool, designed to convert various file formats and URLs into Markdown. The shell script (scripts/run.sh) and configuration (config.json) correctly implement the stated functionality without any signs of malicious intent, data exfiltration, or obfuscation. It follows standard practices for handling user-provided inputs and clearly documents its dependency on the 'markitdown' Python package.
能力评估
Purpose & Capability
The skill's name/description, SKILL.md, config.json, and run.sh consistently describe a wrapper around the markitdown CLI to convert files/URLs to Markdown. Minor inconsistency: top-level registry metadata listed no required binaries, while config.json and scripts/run.sh require the markitdown CLI (installed via pip). This is explainable (packaging metadata omission) but worth noting.
Instruction Scope
SKILL.md instructs the agent to run scripts/run.sh with a user-provided path or URL and to pass through options to markitdown; the runtime script only checks for markitdown and execs it. Instructions limit network access to fetching provided URLs/YouTube and clearly mark OPENAI_API_KEY as optional for AI-enhanced image/OCR features.
Install Mechanism
No automatic install spec in the skill bundle; SKILL.md and config.json recommend installing markitdown via pip (pip install 'markitdown[all]'). This is a standard public-package install path and the bundle does not download arbitrary archives or run remote installers.
Credentials
No required environment variables. OPENAI_API_KEY is declared optional and used only for AI/image/OCR enhancements as documented — this is proportional and expected. The skill does not request unrelated credentials or access.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide config, and is user-invocable only. It executes markitdown at runtime and does not persist elevated privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install all-to-markdown
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /all-to-markdown 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of all-to-markdown. - Convert various file formats (PDF, Word, Excel, PPT, images, audio, web pages, ZIP archives) and URLs to Markdown using Microsoft MarkItDown. - Supports document OCR, audio transcription, YouTube subtitle extraction, and EXIF/image metadata. - Command-line usage provided with flexible options for file paths, URLs, and output. - AI can utilize the tool to facilitate Markdown conversion for easier content analysis.
元数据
Slug all-to-markdown
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

All to Markdown 是什么?

将任意文件(PDF、Word、Excel、PPT、图片、音频、网页等)转换为 Markdown. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 95 次。

如何安装 All to Markdown?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install all-to-markdown」即可一键安装,无需额外配置。

All to Markdown 是免费的吗?

是的,All to Markdown 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

All to Markdown 支持哪些平台?

All to Markdown 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 All to Markdown?

由 PING SI(@sipingme)开发并维护,当前版本 v1.0.0。

💬 留言讨论