← Back to Skills Marketplace
504
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hami-markdown-converter
Description
Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XM...
README (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
-dwith Azure Document Intelligence
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hami-markdown-converter - After installation, invoke the skill by name or use
/hami-markdown-converter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 504 downloads so far.
How do I install Markdown Converter?
Run "/install hami-markdown-converter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Markdown Converter free?
Yes, Markdown Converter is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Markdown Converter support?
Markdown Converter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Markdown Converter?
It is built and maintained by niceNASA (@nicenasa); the current version is v1.0.0.
More Skills