A versatile document processing utility that transforms complex file formats into clean, structured markdown optimized for LLM analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hami-markdown-converter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hami-markdown-converter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Markdown Converter?
The Markdown Converter is a specialized tool within the Openclaw Skills ecosystem designed to bridge the gap between proprietary document formats and text-based AI processing. By leveraging the power of markitdown via uvx, it allows developers to instantly convert everything from legacy Word documents and Excel spreadsheets to modern YouTube URLs and EPubs into high-quality markdown.
This skill is particularly valuable for developers building RAG (Retrieval-Augmented Generation) pipelines or AI agents that need to ingest heterogeneous data sources. Because it runs via uvx, it offers a zero-install experience, ensuring that your environment remains clean while providing industrial-grade document parsing capabilities.
Markdown Converter Use Cases
- Pre-processing PDF and Office documents for LLM context windows.
- Extracting structured data from Excel or CSV files into a readable markdown format.
- Automating the transcription of audio files and OCR of images for text analysis.
- Converting web content and YouTube metadata into searchable markdown documentation.
- Batch processing ZIP archives to extract and convert internal document contents.
How Markdown Converter Works
- The user provides an input source, which can be a local file path, a piped stream (stdin), or a URL.
- The skill invokes the markitdown engine using the uvx runner, ensuring the latest version is used without permanent global installation.
- The engine detects the file type (via extension, MIME type, or content analysis) and applies the appropriate parser (e.g., OCR for images, transcription for audio, or structural mapping for XLSX).
- Document elements like headings, tables, and lists are preserved to maintain the semantic integrity of the original file.
- The resulting markdown is either streamed to the console (stdout) or saved to a designated file for further use by other Openclaw Skills.
Markdown Converter Setup
The Markdown Converter requires no manual installation of the underlying library thanks to the uvx runner. Ensure you have uv installed on your system.
# Basic conversion of a PDF
uvx markitdown input.pdf -o output.md
# Convert a Word document to markdown
uvx markitdown report.docx > report.md
Markdown Converter Data Schema & Taxonomy
The skill processes a wide variety of inputs and standardizes them into a unified markdown output. Below is the mapping of supported formats:
| Category | Supported Formats |
|---|---|
| Documents | PDF, .docx, .pptx, .xlsx, .xls, EPub |
| Web & Data | HTML, CSV, JSON, XML, YouTube URLs |
| Media | Images (EXIF + OCR), Audio (EXIF + transcription) |
| Archives | ZIP (processes internal contents recursively) |
All metadata, such as EXIF data for media or headers for spreadsheets, is converted into markdown-compliant text structures.
Markdown Converter Advanced Features
- Cloud-Powered Extraction: Use the
-dflag to leverage Azure Document Intelligence for high-accuracy extraction from complex or scanned PDFs. - Dynamic Hinting: Manually provide file extensions (
-x) or MIME types (-m) when working with ambiguous data streams from stdin. - Plugin Architecture: Extend core functionality by enabling 3rd-party plugins with the
--use-pluginsflag to support custom formats. - Stream-Based Workflows: Seamlessly integrate into Unix-style pipelines using standard input and output redirection.
SKILL.md
Loading
Related Openclaw Skills
China Express Tracker
A precision logistics tracking skill that uses browser automation to retrieve real-time Chinese package statuses directly from Kuaidi100.
Skill Test
A comprehensive quality assurance framework for evaluating, grading, and benchmarking AI agent skills before deployment.
A-Stock Market Data Skill
A specialized tool for AI agents to retrieve real-time market data and indices from the Shanghai and Shenzhen stock exchanges.
Experience Distiller
Experience Distiller intelligently routes completed work into specific knowledge layers to ensure long-term project intelligence and reusability.
Code → PRD
A powerful reverse-engineering tool that transforms frontend, backend, or fullstack codebases into comprehensive, business-readable Product Requirements Documents.
Piston Reference Skill
A local, high-speed reference tool for developers to access Piston concepts, implementation patterns, and best practices directly within their AI agent workflow.
Featured*
