MarkItDown Skill
v1.0.1OpenClaw agent skill for converting documents to Markdown. Documentation and utilities for Microsoft's MarkItDown library. Supports PDF, Word, PowerPoint, Excel, images (OCR), audio (transcription), HTML, YouTube.
⭐ 0· 1.6k·10 current·11 all-time
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
high confidencePurpose & Capability
Name/description align with what is provided: documentation, examples, a small batch script, and a pip install spec for the markitdown CLI. The required binaries (python3, pip, markitdown) and the pip install of markitdown[all] are proportional to the stated purpose.
Instruction Scope
SKILL.md and the included docs stay on-topic (markitdown CLI/API usage). The batch script optionally imports the OpenAI client when an LLM model is requested and the docs reference using an Azure Document Intelligence endpoint (AZURE_DOCUMENT_INTELLIGENCE_KEY). Those LLM/DocInt integrations are optional, but they introduce network calls and use credentials that are not declared in requires.env — the script will attempt to create an OpenAI client if the --llm-model flag is used.
Install Mechanism
The install uses pip to install 'markitdown[all]' which is the expected distribution method. Pip installs execute package setup code and can pull many dependencies (the [all] extras), so installing in a virtualenv is recommended; no downloads from untrusted URLs or extract-from-arbitrary-URL patterns are present in the skill itself.
Credentials
The skill does not require any environment variables by default (none listed), which is fine. However, documentation references optional credentials (e.g., AZURE_DOCUMENT_INTELLIGENCE_KEY and implicit OpenAI credentials used by the openai client). These optional credentials are reasonable for the optional features, but they are not declared in requires.env — users should be aware enabling LLM or Azure features will use those secrets.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide configs, and contains only a small helper script. It is user-invocable and may be invoked autonomously per platform defaults, which is expected.
Assessment
This skill appears to do what it says: documentation + a small batch conversion helper that relies on the markitdown pip package. Before installing: 1) Verify you're installing the official 'markitdown' package on PyPI (typosquatting is a general pip risk). 2) Install in a Python virtual environment to avoid affecting system packages (python -m venv .venv; source .venv/bin/activate). 3) Only install the extras you need (avoid 'markitdown[all]' if you only need PDFs) to reduce dependency surface. 4) If you enable LLM features (--llm-model) or Azure DocInt, know that those will make network calls and require credentials (OPENAI API key, AZURE_DOCUMENT_INTELLIGENCE_KEY); provide those only to trusted code and review usage. 5) If you need higher assurance, inspect the upstream markitdown PyPI package and its GitHub repo to confirm maintainership and release history before installing.Like a lobster shell, security has layers — review code before you run it.
latestvk975vy49a0xw9msra83h6f0m9580x0w6
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
Runtime requirements
📄 Clawdis
Binspython3, pip, markitdown